Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
🇩🇪 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)
BanSystem-…-all.jarnachplugins/legen.- Server starten – Configs werden automatisch angelegt.
/bs reloadnach Änderungen, das war's.
Proxy-Setup im Velocity-Netzwerk (optional)
BanSystemVelocity-…-all.jarinplugins/des Proxys legen (Velocity 3.1–4.3).- Proxy einmal starten →
plugins/bansystem/config.propertieswird angelegt. - Sync-Secret verbinden: Das Secret aus dem Log des Backends (Zeile mit
velocity-sync-secret) kopieren und in derconfig.propertiesdes Proxys alssync-secret=…eintragen. /vbs reloadausfü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 banlistzeigt 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)
- Put
BanSystem-…-all.jarintoplugins/. - Start the server – configs are created automatically.
/bs reloadafter changes, that's it.
Proxy setup in a Velocity network (optional)
- Put
BanSystemVelocity-…-all.jarintoplugins/of the proxy (Velocity 3.1–4.3). - Start the proxy once →
plugins/bansystem/config.propertiesis created. - Connect the sync secret: copy the secret from the backend log (the
velocity-sync-secretline) into the proxy'sconfig.propertiesassync-secret=…. - 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 banlistshows every ban in the network. On the backends everything stays/bs.

