# LightBans<\/p>\n
**Professional, lightweight moderation plugin for Paper & Spigot servers.**<\/p>\n
—<\/p>\n
## \u26a1 What is LightBans?<\/p>\n
LightBans is a modern, fully-featured punishment management plugin designed to give server administrators complete control over player moderation \u2014 without the bloat. Built with performance in mind, LightBans runs fully async database operations so your server’s TPS stays untouched.<\/p>\n
Whether you’re running a small SMP or a large network, LightBans provides every tool you need to keep your community safe.<\/p>\n
—<\/p>\n
## \ud83d\udee1\ufe0f Features<\/p>\n
### Punishment Types
\n– **Ban** \u2014 Permanently or temporarily ban players from your server
\n– **Temp Ban** \u2014 Issue time-limited bans with flexible duration formats
\n– **IP Ban** \u2014 Ban by IP address to prevent alt account evasion
\n– **Mute** \u2014 Silence players permanently or temporarily
\n– **Temp Mute** \u2014 Time-limited mutes with remaining time tracking
\n– **IP Mute** \u2014 Mute by IP address across all accounts
\n– **Kick** \u2014 Instantly remove players from the server
\n– **Softban** \u2014 Ban, clear data, kick, and immediately unban a player
\n– **Blacklist** \u2014 Permanent, irrevocable blacklist with data removal<\/p>\n
### \ud83d\udccb Moderation Tools ### \ud83d\uddc4\ufe0f Database Support ### \ud83c\udfa8 Rich Color Support ### \ud83d\udd0a Sound Effects ### \ud83d\udce2 Public Broadcasts ### \ud83d\udd14 Staff Alerts ### \u270f\ufe0f Fully Customizable Messages —<\/p>\n ## \ud83d\udcce Commands<\/p>\n | Command | Description | Permission | > All commands also have `\/l` prefix aliases (e.g., `\/lban`, `\/lkick`) to avoid conflicts with other plugins.<\/p>\n —<\/p>\n ## \u23f1\ufe0f Duration Format<\/p>\n Use any of the following for temporary punishments:<\/p>\n | Format | Meaning | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Description | —<\/p>\n ## \u2699\ufe0f Requirements<\/p>\n – **Server:** Paper or Spigot (1.21+) —<\/p>\n ## \ud83d\ude80 Why LightBans?<\/p>\n – **Lightweight** \u2014 Minimal resource usage, designed for performance —<\/p>\n ## \ud83d\udcac Support<\/p>\n Found a bug or have a suggestion? Open an issue on the discord page \u2014 feedback is always welcome!<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" Easy and Advanced Ban, Mute System GUI Support<\/p>\n","protected":false},"featured_media":93883,"template":"","meta":{"_minecraft_slug":"lightbans","_minecraft_project_id":"DVuSteyb","_minecraft_author":"PakStudios","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":406,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lightbans.zip","_minecraft_size_bytes":13755580,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T10:59:29.446025Z","_minecraft_date_created":"2026-03-04T08:23:19.198804Z","_minecraft_date_modified":"2026-03-10T01:05:22.828711Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lightbans","_minecraft_icon_attachment_id":93883,"_minecraft_imported_at":"2026-06-05T08:53:49+00:00","_minecraft_import_hash":"10092ae36fc766f0cfeef70752002076","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-93882","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/history
\n– `\/check
\n– `\/lightbans reload` \u2014 Hot-reload configuration without restarting<\/p>\n
\n– **SQLite** \u2014 Zero-configuration, works out of the box
\n– **MySQL** \u2014 Full MySQL support with HikariCP connection pooling for high-performance servers<\/p>\n
\nLightBans supports multiple color formats in all messages:
\n– **MiniMessage** \u2014 `
\n– **Legacy** \u2014 `&c`, `&a`, `&l`, and all classic formatting codes
\n– **Hex** \u2014 `&#ff6b6b`, `�ccff`
\n– **RGB** \u2014 `rgb(255,107,107)`<\/p>\n
\nEvery punishment type comes with configurable sound effects \u2014 toggle them on or off, and customize the sound, volume, and pitch for each action.<\/p>\n
\nOptionally 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.<\/p>\n
\nStaff members with the `lightbans.admin` permission receive detailed alerts for every moderation action, including who issued the punishment and why.<\/p>\n
\nEvery single message \u2014 ban screens, kick screens, mute notifications, staff alerts, error messages, and more \u2014 is fully configurable through `messages.yml`. Personalize every interaction to match your server’s brand.<\/p>\n
\n|———|————-|————|
\n| `\/ban
\n| `\/tempban
\n| `\/ipban
\n| `\/mute
\n| `\/tempmute
\n| `\/muteip
\n| `\/kick
\n| `\/softban
\n| `\/blacklist
\n| `\/unban
\n| `\/unmute
\n| `\/unblacklist
\n| `\/history
\n| `\/check
\n| `\/lightbans reload` | Reload configuration | `lightbans.admin` |<\/p>\n
\n|——–|———|
\n| `10m` | 10 minutes |
\n| `5h` | 5 hours |
\n| `2d` | 2 days |
\n| `3w` | 3 weeks |
\n| `1mo` | 1 month |
\n| `1y` | 1 year |<\/p>\n
\n|————|————-|
\n| `lightbans.admin` | Full access to all LightBans commands |
\n| `lightbans.ban` | Allow banning players |
\n| `lightbans.tempban` | Allow temporarily banning players |
\n| `lightbans.ipban` | Allow IP banning players |
\n| `lightbans.mute` | Allow muting players |
\n| `lightbans.tempmute` | Allow temporarily muting players |
\n| `lightbans.muteip` | Allow IP muting players |
\n| `lightbans.kick` | Allow kicking players |
\n| `lightbans.softban` | Allow softbanning players |
\n| `lightbans.blacklist` | Allow blacklisting players |
\n| `lightbans.unban` | Allow unbanning & unblacklisting players |
\n| `lightbans.unmute` | Allow unmuting players |
\n| `lightbans.history` | Allow viewing punishment history & checks |
\n| `lightbans.reload` | Allow reloading the plugin |<\/p>\n
\n– **Java:** 17 or higher
\n– **No dependencies required** \u2014 everything is built-in<\/p>\n
\n– **Async everything** \u2014 All database operations run off the main thread
\n– **Essentials compatible** \u2014 Automatically overrides conflicting commands from Essentials
\n– **Modern** \u2014 Built with Adventure API and MiniMessage support
\n– **No bloat** \u2014 Does one thing and does it well: moderation
\n– **Easy setup** \u2014 Drop the JAR in your plugins folder and go. Zero configuration required.<\/p>\n