Bad Bans

Minecraft 版本： 26.1.2

平台： paper

标签： management storage utility

---

---

✨ 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 [time] [reason] [-s]` | Ban a player permanently or temporarily | | `/ipban [time] [reason] [-s]` | Ban an IP address | | `/tempban [reason] [-s]` | Temporarily ban a player | | `/tempipban [reason] [-s]` | Temporarily ban an IP address | | `/unban ` | Remove an active account ban | | `/unbanip ` | Remove an active IP ban | ### ? Mute Commands | Command | Description | | ------------------------------------------ | ---------------------------------------- | | `/mute [time] [reason] [-s]` | Mute a player permanently or temporarily | | `/tempmute [reason] [-s]` | Temporarily mute a player | | `/unmute ` | Remove an active mute | | `/ipmute [time] [reason] [-s]` | Mute an IP address | | `/unipmute ` | Remove an active IP mute | ### ⚠️ Warning Commands | Command | Description | | ----------------------------------------- | ----------------------------------------------- | | `/warn [reason] [-s]` | Warn a player | | `/tempwarn [reason] [-s]` | Temporarily warn a player | | `/unwarn [id/all]` | Remove one warning or clear all active warnings | ### ? Kick Commands | Command | Description | | ------------------------------ | ------------------------ | | `/kick [reason] [-s]` | Kick a player instantly | | `/kickall [reason] [-s]` | Kick every online player | ### ? Information Commands | Command | Description | | ------------------------ | ------------------------------------- | | `/check ` | View active punishments | | `/history ` | View complete punishment history | | `/iphistory ` | View IP history | | `/dupeip ` | View linked accounts from the same IP | ### ⚙️ Admin Commands | Command | Description | | ---------------------------------- | ---------------------------------------------- | | `/badbans reload` | Reload configuration files | | `/badbans rollback [time]` | Roll back punishments issued by a staff member | | `/wipe [-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.