A shared ban register for Minecraft servers
A central service and Paper plugin that let connected Minecraft servers register their own bans. Each server chooses how many active bans from different servers are still allowed. Above that threshold, the plugin denies the player at login.
Node.js · Express · PostgreSQL · Java 21 · Paper 1.21.4 · Maven · Docker
A server can decide who is welcome, but does not automatically know what other communities encounter. The Vonk idea behind BanShare is a shared register with a configurable limit. The count uses distinct connected servers, so repeated reports from one server do not carry extra weight.
With a maximum of two, zero, one and two active server bans are allowed; from three onwards the player is denied. An unban only withdraws that server's own record. The plugin supplements existing moderation: registering in BanShare does not change the vanilla ban list and existing bans are not imported automatically.
The central Express API stores records in PostgreSQL and identifies servers by their own token. The dashboard sits behind a login. The Java plugin for Paper 1.21.4 checks player UUIDs off the main thread and lets the administrator choose what happens during a service failure. The website provides the built JAR and installation instructions.
