Every ban you hand out lands on a public registry, so the next admin who checks that name knows what they're walking into. No config files to juggle, no IPs leaving your box, no central company running it. Your server links itself on first boot.
What it does
When you run vanilla /ban or /pardon, the plugin quietly reports it to the registry. When a player tries to join, it checks the registry first and kicks them with a pre-formatted message if they're banned elsewhere. You also get a web dashboard, a review queue for disputed bans, private server-only notes, historical username tracking, and a 10-minute grace window so you can retract a mistake before other servers see it.
There is no /gban ban command. You use the commands you already know.
Features
- Auto-reports vanilla /ban and /pardon. Bans you issue in-game get published automatically. Pardons propagate the same way.
- Login gate. Banned players get the formatted kick message and never reach your world.
- Grace period. New bans stay soft-hidden for 10 minutes. Change your mind and /pardon - the ban is retracted before the rest of the network ever sees it.
- Dispute queue. If you think another server's ban on someone is sketchy, flag it from the dashboard. A reviewer handles it.
- Private notes. Log in from in-game and drop notes on players that only your server can read.
- Username history. The plugin and the registry track name changes via Mojang, so alts who renamed don't slip past.
- Web dashboard. Live stats, full player profiles, ban history, linked alts, server trust trajectory, admin tools.
- 8 languages. English, Spanish, German, French, Portuguese, Russian, Chinese, Polish. Pick one in config.yml or drop your own file in the lang folder.
- Server genre tags. Tag your server as pvp, smp, skyblock, prison, etc. so other admins know what kind of network issued the ban.
Installation
- Drop the jar into your plugins folder.
- Start the server. The plugin links itself to mc-globalban.net on first boot and creates plugins/mcGlobalBan/config.yml and link.yml.
- That's it. Run /ban and /pardon as normal.
Requires Java 17 or newer and Spigot/Paper 1.20.4 through 1.21.x. Works alongside ViaVersion.
Commands
- /gban lookup <name> - pull up a player's global profile, bans, alts, and history. Tab-completes online players.
- /gban status - show your server's link state, last sync, and network totals.
- /gban weblogin - generate a 6-digit code you enter at mc-globalban.net/login to sign in on the website.
- /gban tags <tag> [tag...] - set your server's genre tags. Tab-completes common ones.
- /gban reload - reload config and language file.
- /gban unlink - unlink from the registry and re-register fresh.
Aliases: /globalban, /gb
Permissions
- globalban.use - run lookup and status. Default: everyone.
- globalban.web - generate a web sign-in code with /gban weblogin. Default: op.
- globalban.admin - reload the plugin, unlink, set server tags. Default: op.
The plugin does not take over /ban or /pardon, so vanilla ban permissions still apply to those.
config.yml
- api-url - registry endpoint. Leave as default unless you know what you're doing.
- server-name - name shown in the registry. Blank uses the server's own name.
- heartbeat-interval - seconds between heartbeats to the registry.
- auto-report - report vanilla /ban and /pardon automatically.
- deny-banned-login - block banned players at pre-login with the registry's kick message.
- lang - plugin language. One of en, es, de, fr, pt, ru, zh, pl. Defaults to en.
Privacy
The registry stores usernames, UUIDs, ban reasons, the server that issued the ban, and timestamps. That's it. No IPs, no emails, no chat logs, no locations, nothing personal.
