BanShare

Een gedeeld banregister voor Minecraft-servers

Een centrale dienst en Paper-plugin waarmee aangesloten Minecraft-servers hun eigen bans registreren. Elke server kiest hoeveel verschillende actieve serverbans nog zijn toegestaan. Boven die drempel weigert de plugin de speler bij het inloggen.

banshare.gerbenput.com

Node.js · Express · PostgreSQL · Java 21 · Paper 1.21.4 · Maven · Docker

BanShare: Schermafbeelding van de live site — Scroll: dit is de echte site

Het verhaal

Het idee

Een server kan zelf bepalen wie welkom is, maar weet niet vanzelf wat andere communities meemaken. Het Vonk-idee achter BanShare is een gedeeld register met een instelbare grens. De telling gebruikt verschillende aangesloten servers, zodat meerdere meldingen van dezelfde server geen extra gewicht krijgen.

De regel precies

Bij een maximum van twee zijn nul, één en twee actieve serverbans toegestaan; vanaf drie wordt de speler geweigerd. Een unban trekt alleen de eigen registratie in. De plugin vult bestaande moderatie aan: registreren in BanShare verandert de vanilla-banlijst niet en bestaande bans worden niet automatisch overgenomen.

Van register naar plugin

De centrale Express-API bewaart registraties in PostgreSQL en herkent servers aan hun eigen token. Het beheerscherm zit achter een login. De Java-plugin voor Paper 1.21.4 controleert speler-UUID's buiten de hoofdthread en laat de beheerder kiezen wat er bij een storing gebeurt. De website levert de gebouwde JAR en installatie-instructies.

Publieke BanShare-startpagina met uitleg over gedeelde serverbans
Interactieve simulator die de instelbare ban-drempel uitlegt
Paper-pluginconfiguratie met API-adres, drempel en storingsinstellingen

In detail

Unieke servers tellen: Iedere server/UUID-combinatie telt maximaal één actieve keer mee; opnieuw registreren maakt geen extra stem.
Een eigen drempel: Stel per plugin in hoeveel actieve serverbans zijn toegestaan voordat de join wordt geweigerd.
Ban en unban: Registreer een ban voor een UUID of trek de registratie van je eigen server in, via plugin of beheer.
Beveiligd beheer: Een beheerscherm achter login voor aantallen, recente registraties, UUID-controles en banacties.
Elke server zijn token: De API vereist een eigen servertoken; een server schrijft uitsluitend namens zichzelf.
Storingsgedrag kiezen: Configureer timeout en fail-open of fail-closed voor de aanvullende BanShare-controle.

Volgend project DroneAI Pre-flight briefing voor je drone