mcGlobalBan

<div align="center"> # <span style="color:#06b6d4">mcGlobalBan</span> <span style="color:#8b5cf6">**cross-server ban sharing without the drama**</span> (https://mc-globalban.net) </div> 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. ## <span style="color:#06b6d4">What it does</span> 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. ## <span style="color:#06b6d4">Features</span> - **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. ## <span style="color:#06b6d4">Installation</span> 1. Drop the jar into your **plugins** folder. 2. Start the server. The plugin links itself to mc-globalban.net on first boot and creates **plugins/mcGlobalBan/config.yml** and **link.yml**. 3. 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. ## <span style="color:#06b6d4">Commands</span> - **/gban lookup &lt;name&gt;** - 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 (https://mc-globalban.net/login) to sign in on the website. - **/gban tags &lt;tag&gt; ** - 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** ## <span style="color:#06b6d4">Permissions</span> - **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. ## <span style="color:#06b6d4">config.yml</span> - **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. ## <span style="color:#06b6d4">Privacy</span> 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.**