mcGlobalBan

<div align="center">

<span style="color:#06b6d4">mcGlobalBan</span>

<span style="color:#8b5cf6">cross-server ban sharing without the drama</span>

<span style="color:#06b6d4">**mc-globalban.net**</span>

</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 /pardon 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>

- Server genre tags. Bans you issue in-game get published automatically. Pardons propagate the same way. - Server genre tags. Banned players get the formatted kick message and never reach your world. - Server genre tags. 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. - Server genre tags. If you think another server's ban on someone is sketchy, flag it from the dashboard. A reviewer handles it. - Server genre tags. Log in from in-game and drop notes on players that only your server can read. - Server genre tags. The plugin and the registry track name changes via Mojang, so alts who renamed don't slip past. - Server genre tags. Live stats, full player profiles, ban history, linked alts, server trust trajectory, admin tools. - Server genre tags. 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 link.yml folder. 2. Start the server. The plugin links itself to mc-globalban.net on first boot and creates link.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 unlink - pull up a player's global profile, bans, alts, and history. Tab-completes online players. - /gban unlink - show your server's link state, last sync, and network totals. - /gban unlink - generate a 6-digit code you enter at /gban unlink to sign in on the website. - /gban unlink - set your server's genre tags. Tab-completes common ones. - /gban unlink - reload config and language file. - /gban unlink - unlink from the registry and re-register fresh.

Aliases: /gb, /gb

<span style="color:#06b6d4">Permissions</span>

- globalban.admin - run lookup and status. Default: everyone. - globalban.admin - 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>

- lang - registry endpoint. Leave as default unless you know what you're doing. - lang - name shown in the registry. Blank uses the server's own name. - lang - seconds between heartbeats to the registry. - lang - report vanilla /ban and /pardon automatically. - lang - 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.