Wiki BanLookup

Installation, compatibilité, permissions et API read-only.

Installation rapide

  1. Place banlookup-plugin-*.jar dans plugins/, puis redémarre.
  2. Renseigne URL API + clé serveur dans plugins/BanLookupPlugin/config.yml.
  3. Lance /blp status puis fais une sanction de test.

Compatibilité plugin

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

Le provider détecté apparaît dans /blp status.

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

Rôles et permissions

RôleAccès
AdminTous les serveurs, toutes les actions.
Modérateur BanLookupVisibilité globale + gestion interne.
PartenaireVoit tout, modifie uniquement les sanctions de son serveur.
Modérateur externeAjout de preuves seulement sur ses serveurs assignés.

API publique read-only

Génère une clé read-only dans le panel (Serveurs > Clés API), puis appelle les endpoints avec 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 technique

Le plugin applique-t-il des sanctions ?

Non. Il relaie les sanctions déjà exécutées en jeu.

Quelles données sont stockées ?

UUID/pseudo joueur, staff émetteur, type, raison, date et preuves.

Pourquoi HTTP 401 côté plugin ?

Clé API invalide/révoquée ou secret panel/plugin incorrect.