
Easy and Advanced Ban, Mute System GUI Support
Professional, lightweight moderation plugin for Paper & Spigot servers.
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.
/history <player> — View a player's full punishment history/check <player> — See all currently active punishments/lightbans reload — Hot-reload configuration without restartingLightBans supports multiple color formats in all messages:
<red>, <gradient:#ff0000:#00ff00>, <color:#ff6b6b>&c, &a, &l, and all classic formatting codes&#ff6b6b, �ccffrgb(255,107,107)Every punishment type comes with configurable sound effects — toggle them on or off, and customize the sound, volume, and pitch for each action.
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 members with the lightbans.admin permission receive detailed alerts for every moderation action, including who issued the punishment and why.
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.
| 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.
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 |
| 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 |
Found a bug or have a suggestion? Open an issue on the discord page — feedback is always welcome!