LightBans
Professional, lightweight moderation plugin for Paper & Spigot servers.
⚡ What is LightBans?
LightBans is a modern, fully-featured punishment management plugin designed to give server administrators complete control over player moderation — without the bloat. Built with performance in mind, LightBans runs fully async database operations so your server's TPS stays untouched.
Whether you're running a small SMP or a large network, LightBans provides every tool you need to keep your community safe.
🛡️ Features
Punishment Types
- Ban — Permanently or temporarily ban players from your server
- Temp Ban — Issue time-limited bans with flexible duration formats
- IP Ban — Ban by IP address to prevent alt account evasion
- Mute — Silence players permanently or temporarily
- Temp Mute — Time-limited mutes with remaining time tracking
- IP Mute — Mute by IP address across all accounts
- Kick — Instantly remove players from the server
- Softban — Ban, clear data, kick, and immediately unban a player
- Blacklist — Permanent, irrevocable blacklist with data removal
📋 Moderation Tools
/history <player>— View a player's full punishment history/check <player>— See all currently active punishments/lightbans reload— Hot-reload configuration without restarting
🗄️ Database Support
- SQLite — Zero-configuration, works out of the box
- MySQL — Full MySQL support with HikariCP connection pooling for high-performance servers
🎨 Rich Color Support
LightBans supports multiple color formats in all messages:
- MiniMessage —
<red>,<gradient:#ff0000:#00ff00>,<color:#ff6b6b> - Legacy —
&c,&a,&l, and all classic formatting codes - Hex —
&#ff6b6b,�ccff - RGB —
rgb(255,107,107)
🔊 Sound Effects
Every punishment type comes with configurable sound effects — toggle them on or off, and customize the sound, volume, and pitch for each action.
📢 Public Broadcasts
Optionally broadcast punishments to the entire server. When a player gets banned, muted, or kicked, everyone knows. Fully configurable and can be disabled per your preference.
🔔 Staff Alerts
Staff members with the lightbans.admin permission receive detailed alerts for every moderation action, including who issued the punishment and why.
✏️ Fully Customizable Messages
Every single message — ban screens, kick screens, mute notifications, staff alerts, error messages, and more — is fully configurable through messages.yml. Personalize every interaction to match your server's brand.
📎 Commands
| Command | Description | Permission |
|---|---|---|
/ban <player> [duration] <reason> | Ban a player (permanent or temporary) | lightbans.ban |
/tempban <player> <duration> <reason> | Temporarily ban a player | lightbans.tempban |
/ipban <player> [duration] <reason> | IP ban a player | lightbans.ipban |
/mute <player> [duration] <reason> | Mute a player | lightbans.mute |
/tempmute <player> <duration> <reason> | Temporarily mute a player | lightbans.tempmute |
/muteip <player> [duration] <reason> | IP mute a player | lightbans.muteip |
/kick <player> <reason> | Kick a player | lightbans.kick |
/softban <player> <reason> | Softban a player | lightbans.softban |
/blacklist <player> <reason> | Permanently blacklist a player | lightbans.blacklist |
/unban <player> | Unban a player | lightbans.unban |
/unmute <player> | Unmute a player | lightbans.unmute |
/unblacklist <player> | Remove from blacklist | lightbans.unban |
/history <player> | View punishment history | lightbans.history |
/check <player> | Check active punishments | lightbans.history |
/lightbans reload | Reload configuration | lightbans.admin |
All commands also have
/lprefix aliases (e.g.,/lban,/lkick) to avoid conflicts with other plugins.
⏱️ Duration Format
Use any of the following for temporary punishments:
| Format | Meaning |
|---|---|
10m | 10 minutes |
5h | 5 hours |
2d | 2 days |
3w | 3 weeks |
1mo | 1 month |
1y | 1 year |
🔑 Permissions
| Permission | Description |
|---|---|
lightbans.admin | Full access to all LightBans commands |
lightbans.ban | Allow banning players |
lightbans.tempban | Allow temporarily banning players |
lightbans.ipban | Allow IP banning players |
lightbans.mute | Allow muting players |
lightbans.tempmute | Allow temporarily muting players |
lightbans.muteip | Allow IP muting players |
lightbans.kick | Allow kicking players |
lightbans.softban | Allow softbanning players |
lightbans.blacklist | Allow blacklisting players |
lightbans.unban | Allow unbanning & unblacklisting players |
lightbans.unmute | Allow unmuting players |
lightbans.history | Allow viewing punishment history & checks |
lightbans.reload | Allow reloading the plugin |
⚙️ Requirements
- Server: Paper or Spigot (1.21+)
- Java: 17 or higher
- No dependencies required — everything is built-in
🚀 Why LightBans?
- Lightweight — Minimal resource usage, designed for performance
- Async everything — All database operations run off the main thread
- Essentials compatible — Automatically overrides conflicting commands from Essentials
- Modern — Built with Adventure API and MiniMessage support
- No bloat — Does one thing and does it well: moderation
- Easy setup — Drop the JAR in your plugins folder and go. Zero configuration required.
💬 Support
Found a bug or have a suggestion? Open an issue on the discord page — feedback is always welcome!
