⚡ 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
- Alts: check Alts, track IP Address
- Mod: Moderate a user mute, kick, freeze, spam-kill, & teleport.
- Ban History: View current banned people and right click to unban.
- Mute History: View the current muted users & right-click to unmute.
- User History: View a user's history, view the punishments acted on them.
✏️ 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 |
/unban <player> |
Unban a player | lightbans.unban |
/unmute <player> |
Unmute a player | lightbans.unmute |
/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.
🔑 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.unban |
Allow unbanning & unblacklisting players |
lightbans.unmute |
Allow unmuting players |
lightbans.history |
Allow viewing punishment history & checks |
lightbans.reload |
Allow reloading the plugin |
lightbans.mod |
Allow moderating users |
