BanSystem | Punish, Alt, Discord

BanSystem
BungeeCord Punishment System | Escalation, Alt-Checker & Discord

Features

Full Punishment System
Replaces all vanilla punishment commands with a clean, fully configurable system. Ban, mute, kick and warn players with custom reasons and durations. Permanent and temporary punishments are both supported.

Automatic Escalation
Define escalation stages in the config — after a configurable number of warnings, the system automatically escalates to a mute, and after a configurable number of mutes to a ban. No manual tracking needed.

Alt-Account Checker
Automatically detects and logs alt accounts based on IP addresses. When a banned player tries to join on an alt, staff gets notified instantly.

Discord Integration
Every punishment is automatically posted to a Discord channel via webhook — with player name, reason, staff member, duration and punishment type. Fully configurable embed format.

Player Lookup
/history <player> shows a detailed punishment history for any player — all bans, mutes, kicks and warnings with dates, reasons and staff members.

Fully Configurable
Every message, reason, broadcast and format is freely configurable via config.yml. No hardcoded strings — everything can be adjusted to match your server's style.

Commands

Code:

/ban <player> [reason]        — Permanently ban a player
/tempban <player> <duration> [reason] — Temporarily ban a player
/mute <player> [reason]       — Permanently mute a player
/tempmute <player> <duration> [reason] — Temporarily mute a player
/kick <player> [reason]       — Kick a player
/warn <player> [reason]       — Warn a player
/unban <player>               — Unban a player
/unmute <player>              — Unmute a player
/history <player>             — Show punishment history
/alts <player>                — Show alt accounts

Permissions

Code:

bansystem.ban         — Ban players
bansystem.tempban     — Temporarily ban players
bansystem.mute        — Mute players
bansystem.tempmute    — Temporarily mute players
bansystem.kick        — Kick players
bansystem.warn        — Warn players
bansystem.unban       — Unban players
bansystem.unmute      — Unmute players
bansystem.history     — View punishment history
bansystem.alts        — View alt accounts
bansystem.bypass      — Cannot be punished
bansystem.admin       — Full access

Requirements

BungeeCord (latest version)
Java 17+
MySQL 5.7+ or MariaDB 10+

Installation

Place BanSystem.jar in your BungeeCord plugins/ folder
Start BungeeCord once — config.yml is generated automatically
Enter your MySQL credentials and Discord webhook URL
Restart BungeeCord — done!

Deutsche Beschreibung

BanSystem ist ein professionelles Bestrafungs-Plugin für BungeeCord Netzwerke. Es ersetzt alle Vanilla-Bestrafungs-Commands durch ein sauberes, vollständig konfigurierbares System mit automatischen Eskalationsstufen, Discord-Webhook-Integration, einem eingebauten Alt-Account-Checker und einem detaillierten Spieler-Lookup-System.

Voraussetzungen: BungeeCord, Java 17+, MySQL

Support

Found a bug or have a question? Send me a message directly here on BuiltByBit.

If you find this useful, please leave a review!

BanSystem | Punish, Alt, Discord v2.1

Overview Dependencies History