---

---

✨ Overview

BadBans is a complete punishment system inspired by LiteBans, designed for modern Minecraft servers that need clean moderation tools, fast database handling and reliable staff control.

It includes bans, IP bans, mutes, IP mutes, warnings, kicks, dupe IP checks, history lookup, silent punishments, rollback tools, web history support and optional player wipe systems.

Built to punish players, not your TPS.

---

🚀 Feature Highlights

🛑 Punishment System Everything needed to manage player punishments in a clean and reliable way. Account bans Temporary bans IP bans Temporary IP bans Mutes Temporary mutes IP mutes Warnings Temporary warnings Kicks Kick all	🔍 Staff Investigation Tools Powerful tools to track players, IPs, punishments and linked accounts. Full punishment history Active punishment check IP history Dupe IP scanner UUID tracking IP tracking Status-colored alt accounts Pretty punishment IDs Staff rollback system
🌐 Network Ready Designed for both single servers and multi-server networks. MariaDB support Redis synchronization SQLite fallback Multi-server punishment sync Safe fallback behavior Runtime library loading Lightweight final jar	🎨 Premium Experience Clean visuals, polished messages and smooth staff feedback. Small caps punishment screens Styled ban messages Styled mute messages Clean public broadcasts Silent staff notifications XP orb success sound Tab completion Web history support

---

⚡ Zero-Lag Design

BadBans is designed to keep your server smooth, even during active moderation.

Database operations, punishment checks and sync actions are handled asynchronously where possible, reducing main-thread work and helping protect server TPS.

Design Goal	Result
Async punishment handling	Less main-thread pressure
Database work off-thread	Better server performance
Redis synchronization	Fast network-wide updates
Lightweight jar	Faster deployment
Paper API usage	Better compatibility
No NMS dependency	Easier updates

---

🌐 Multi-Server Support

BadBans is ready for server networks and shared punishment data.

Component	Purpose
MariaDB	Main source of truth for punishment data
Redis	Real-time synchronization between servers
SQLite	Local fallback when MariaDB is unavailable

If MariaDB or Redis are not available, BadBans can safely fall back to SQLite and disable multi-server sync automatically.

---

🔇 Silent Punishments

Every punishment command supports silent mode using -s.

Example	Visibility
/ban Player 7d Cheating	Visible to everyone online
/ban Player 7d Cheating -s	Visible only to staff with silent notify permission

Silent notifications are shown only to console and players with:

badbans.notify.silent

---

⚠️ Warning Auto-Ban

BadBans includes an automatic warning punishment system.

Setting	Default
Active warnings required	3
Automatic action	Ban
Duration	1 day
Reason	Too many warnings reached

When a player reaches the configured warning limit, BadBans automatically applies the punishment.

---

🧹 Wipe System

BadBans includes a powerful player reset system.

/wipe <player> [-s]

Player Data Inventory Ender chest XP and levels Potion effects Food and saturation Persistent player data

Vanilla Files Playerdata Stats Advancements Recipes Advancement progress Optional external rank reset

Automatic wipe on ban is disabled by default for safety:

wipe-on-ban: false

---

🎨 Styled Messages

BadBans uses clean, modern punishment messages with Small Caps Unicode styling.

Example:

ʏᴏᴜʀ ᴀᴄᴄᴏᴜɴᴛ ʜᴀꜱ ʙᴇᴇɴ ʙᴀɴɴᴇᴅ

Message Type	Style
Ban screen	Red small-caps punishment layout
IP ban screen	Clean connection-ban layout
Mute message	Compact warning-style format
Warn notification	Staff-friendly live message
Dupe IP output	Status-colored account list
Broadcasts	Clean public punishment format
Silent actions	Staff-only notification style

---

🔍 Dupe IP Scanner

Use /dupeip <player/IP> to find accounts connected to the same IP.

BadBans displays linked accounts with status-based colors, making alt detection fast and readable.

Status	Meaning
Online	Player is currently online
Offline	Player is currently offline
Banned	Player has an active ban
Muted	Player has an active mute
IP Banned	Player is linked to a banned IP

---

🆔 Pretty Punishment IDs

BadBans creates clean, stable punishment IDs.

Player	Example ID
PupillaViola	#PPLV4821
Bad_0320	#BAD04821

Punishment IDs are saved permanently and do not change when the player rejoins.

---

📜 Commands

🔨 Ban Commands

Command	Description
/ban <player> [time] [reason] [-s]	Ban a player permanently or temporarily
/ipban <player/IP> [time] [reason] [-s]	Ban an IP address
/tempban <player> <time> [reason] [-s]	Temporarily ban a player
/tempipban <player/IP> <time> [reason] [-s]	Temporarily ban an IP address
/unban <player>	Remove an active account ban
/unbanip <player/IP>	Remove an active IP ban

🔇 Mute Commands

Command	Description
/mute <player> [time] [reason] [-s]	Mute a player permanently or temporarily
/tempmute <player> <time> [reason] [-s]	Temporarily mute a player
/unmute <player>	Remove an active mute
/ipmute <player/IP> [time] [reason] [-s]	Mute an IP address
/unipmute <player/IP>	Remove an active IP mute

⚠️ Warning Commands

Command	Description
/warn <player> [reason] [-s]	Warn a player
/tempwarn <player> <time> [reason] [-s]	Temporarily warn a player
/unwarn <player> [id/all]	Remove one warning or clear all active warnings

👢 Kick Commands

Command	Description
/kick <player> [reason] [-s]	Kick a player instantly
/kickall [reason] [-s]	Kick every online player

🔍 Information Commands

Command	Description
/check <player>	View active punishments
/history <player>	View complete punishment history
/iphistory <player/IP>	View IP history
/dupeip <player/IP>	View linked accounts from the same IP

⚙️ Admin Commands

Command	Description
/badbans reload	Reload configuration files
/badbans rollback <staff> [time]	Roll back punishments issued by a staff member
/wipe <player> [-s]	Fully reset a player

---

🔐 Permissions

Punishment Permissions

Permission	Command
badbans.command.ban	/ban
badbans.command.ipban	/ipban
badbans.command.tempban	/tempban
badbans.command.tempipban	/tempipban
badbans.command.unban	/unban
badbans.command.unbanip	/unbanip
badbans.command.mute	/mute
badbans.command.tempmute	/tempmute
badbans.command.unmute	/unmute
badbans.command.ipmute	/ipmute
badbans.command.unipmute	/unipmute
badbans.command.warn	/warn
badbans.command.tempwarn	/tempwarn
badbans.command.unwarn	/unwarn
badbans.command.kick	/kick
badbans.command.kickall	/kickall

Staff Tool Permissions

Permission	Access
badbans.command.check	Active punishment lookup
badbans.command.history	Full punishment history
badbans.command.iphistory	IP history lookup
badbans.command.dupeip	Dupe IP scanner
badbans.command.wipe	Player wipe command
badbans.command.badbans.reload	Reload configs
badbans.command.badbans.rollback	Staff rollback
badbans.notify.silent	View silent punishments

---

🧩 Technical Highlights

Modern Paper Setup Paper API paper-plugin.yml Java 25+ Maven build Tab completion Clean command handling

Performance Focus Async database logic Runtime libraries Lightweight jar No NMS No useless reflection Clean modular structure

---

🔊 Staff Feedback

When a punishment is successfully applied, the staff member hears the classic Minecraft XP orb sound.

This makes moderation feel fast, responsive and polished without disturbing normal players.

---

🌐 Web History Support

BadBans includes web history support, allowing punishment records to be viewed outside the game.

Useful for staff teams that need fast access to player records, previous punishments and moderation history.

---

🛡️ Why BadBans?

BadBans is made for server owners who want a punishment plugin that feels modern, clean and powerful.