Quick install
- Place banlookup-plugin-*.jar in plugins/, then restart.
- Set API URL + server key in plugins/BanLookupPlugin/config.yml.
- Run /blp status and execute a test sanction.
BanLookup Wiki
Install, compatibility, permissions, and read-only API.
Plugin compatibility
- LiteBans
- AdvancedBan
- BanManager
- EssentialsX (staff commands)
Detected provider is shown in /blp status.
/ban/tempban/unban/mute/tempmute/unmute/warn/tempwarn/kickRoles and permissions
| Role | Access |
|---|---|
| Admin | All servers, all actions. |
| BanLookup Moderator | Global visibility with internal management permissions. |
| Partner | Can view all sanctions but edit only sanctions from their server. |
| External Moderator | Can only add evidence on assigned server(s). |
Public read-only API
Generate a read-only key from the panel (Servers > API Keys), then call endpoints with Authorization: Bearer.
GET /api/public/v1/health
GET /api/public/v1/servers/:serverId/sanctions?limit=50&cursor=...
GET /api/public/v1/players/:uuid/summary
Technical FAQ
Does the plugin apply punishments?
No. It relays punishments already issued in-game.
What data is stored?
Player UUID/name, issuing staff, type, reason, timestamp, evidence.
Why HTTP 401 on plugin side?
Invalid/revoked API key or panel/plugin secret mismatch.