Wiki BanLookup

Instalación, compatibilidad, permisos y API de solo lectura.

Instalación rápida

  1. Coloca banlookup-plugin-*.jar en plugins/ y reinicia.
  2. Configura URL API + clave del servidor en plugins/BanLookupPlugin/config.yml.
  3. Ejecuta /blp status y haz una sanción de prueba.

Compatibilidad del plugin

  • LiteBans
  • AdvancedBan
  • BanManager
  • EssentialsX (staff commands)

El proveedor detectado se muestra en /blp status.

/ban/tempban/unban/mute/tempmute/unmute/warn/tempwarn/kick

Roles y permisos

RolAcceso
AdminTodos los servidores, todas las acciones.
Moderador BanLookupVisibilidad global con gestión interna.
PartnerPuede ver todo, pero editar solo sanciones de su servidor.
Moderador externoSolo puede agregar pruebas en servidores asignados.

API pública de solo lectura

Genera una clave read-only desde el panel (Servidores > Claves API) y usa Authorization: Bearer.

GET /api/public/v1/health

GET /api/public/v1/servers/:serverId/sanctions?limit=50&cursor=...

GET /api/public/v1/players/:uuid/summary

FAQ técnica

¿El plugin aplica sanciones?

No. Solo transmite sanciones ya ejecutadas en el juego.

¿Qué datos se guardan?

UUID/nombre del jugador, staff emisor, tipo, razón, fecha y pruebas.

¿Por qué HTTP 401 en el plugin?

Clave API inválida/revocada o secreto panel/plugin incorrecto.