BanSystem

🇩🇪 Deutsch

BanSystem ist ein Ban-System für Paper-Server. **Es läuft auf einem ganz normalen
Server – du brauchst kein Netzwerk, keinen Proxy und nichts Weiteres.** JAR in plugins/
legen, starten, fertig: /bs ban, /bs tempban, /bs unban, /bs kick, /bs banlist
funktionieren sofort auf einem einzelnen Server.

Optional, nur falls du ein Velocity-Netzwerk hast: Das mitgelieferte Proxy-Plugin
spiegelt Bans auf alle Server (/vbs). Ohne Proxy passiert einfach nichts – keine Fehler,
keine zusätzlichen Configs.

Was es kann

• Bannen, temporär bannen, entbannen, kicken – mit Grund-IDs (/bs createid 1 BAN Hacking),

damit Gründe einheitlich und zentral pflegbar sind.

• Ban-Screen beim Login: Grund, ID, wer gebannt hat, Datum, Dauer und Restzeit.
• /bs banlist – alle Gebannten mit Suche und Seiten.
• Meldungen auf Deutsch oder Englisch (settings.language: de|en), alle Texte frei bearbeitbar.
• Ein JAR für Paper 1.17.1 bis 26.3 – keine Versionsauswahl nötig.

Installation (einziger Server)

1. BanSystem-…-all.jar nach plugins/ legen.
2. Server starten – Configs werden automatisch angelegt.
3. /bs reload nach Änderungen, das war's.

Proxy-Setup im Velocity-Netzwerk (optional)

1. BanSystemVelocity-…-all.jar in plugins/ des Proxys legen (Velocity 3.1–4.3).
2. Proxy einmal starten → plugins/bansystem/config.properties wird angelegt.
3. Sync-Secret verbinden: Das Secret aus dem Log des Backends (Zeile mit

velocity-sync-secret) kopieren und in der config.properties des Proxys als
sync-secret=… eintragen.

1. /vbs reload ausführen – fertig.

Danach gilt: Gebannte werden schon am Proxy abgewiesen, jeder Ban/Unban/Kick wird
automatisch auf alle Backends verteilt (Mesh-Sync, ab Werk aktiv), und /vbs banlist
zeigt alle Gebannten des Netzwerks. Auf den Backends bleibt alles wie gewohnt /bs.

🇬🇧 English

BanSystem is a ban system for Paper servers. **It works on a completely normal
server – no network, no proxy, nothing else required.** Drop the JAR into plugins/,
start the server, done: /bs ban, /bs tempban, /bs unban, /bs kick, /bs banlist
work immediately on a single server.

Optional, only if you run a Velocity network: the included proxy plugin mirrors bans
across all servers (/vbs). Without a proxy nothing happens – no errors, no extra configs.

What it does

• Ban, temp-ban, unban, kick – with reason IDs (/bs createid 1 BAN Hacking) so reasons

stay consistent and centrally maintainable.

• Ban screen on login: reason, ID, who banned, date, duration and remaining time.
• /bs banlist – all banned players with search and pagination.
• Messages in German or English (settings.language: de|en), all texts free to edit.
• One JAR for Paper 1.17.1 to 26.3 – no version picking needed.

Installation (single server)

1. Put BanSystem-…-all.jar into plugins/.
2. Start the server – configs are created automatically.
3. /bs reload after changes, that's it.

Proxy setup in a Velocity network (optional)

1. Put BanSystemVelocity-…-all.jar into plugins/ of the proxy (Velocity 3.1–4.3).
2. Start the proxy once → plugins/bansystem/config.properties is created.
3. Connect the sync secret: copy the secret from the backend log (the

velocity-sync-secret line) into the proxy's config.properties as sync-secret=….

1. Run /vbs reload – done.

From now on banned players are rejected at the proxy, every ban/unban/kick is
distributed to all backends automatically (mesh sync, enabled by default), and
/vbs banlist shows every ban in the network. On the backends everything stays /bs.