⚡ What is LightBans?
LightBans is a Paper moderation plugin for managing punishments, investigating linked accounts, and keeping a clear record of moderation actions. It stores punishment and player history in a local SQLite database, with database work handled off the main server thread.
🛡️ Features
Punishments
- Ban and tempban players, with configurable duration formats
- IP ban accounts to block connections from a shared IP
- Mute and tempmute players, with remaining-time messages
- IP mute accounts sharing an IP
- Kick and warn players
- Configure commands that muted players cannot use, such as
/msg
Evasion alerts and linked accounts
- See accounts linked by IP with
/alts - Check duplicate IP history with
/dupeipfrom the console - Receive ban or mute evasion alerts when a linked account connects
- Alerts show linked account names colored by online/offline and punishment status
- Alerts are sent to online staff with the relevant ban or mute permissions
History and moderation menus
- Ban history and mute history menus show active punishments and let staff confirm revocations
- User history shows a player's recorded punishment history
/mod <player>opens a moderation menu with teleport, kill, freeze, kick, and mute actions
Discord webhooks
- Send punishment, kick, and revocation notifications to Discord
- Use clean embeds with structured player, moderator, reason, expiry, and case fields
- Configure one shared embed color and customizable field labels
Customization
- Customize player-facing messages, broadcasts, staff alerts, and punishment screens in
messages.yml - Configure duration suffixes and mute-blocked commands in
config.yml - Configure webhook URL, color, and embed titles in
discord.yml - Configure automatic warning mutes and their durations
⏱️ Duration formats
Durations can use short or long suffixes, including s, min, hour, day, week, month, and year, with plural forms supported.
Examples: 30s, 10minutes, 2weeks, 1month. Multiple units can be combined, such as 1week2days.
📎 Commands
| Command | Description | Permission |
|---|---|---|
/ban <player> [duration] <reason> |
Ban a player, permanently or for a set duration | 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, permanently or for a set duration | 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 an online player | lightbans.kick |
/warn <player> <reason> |
Warn a player | lightbans.warn |
/unban <player> [reason] |
Revoke bans for a player | lightbans.unban |
/unbanip <player> [reason] |
Revoke IP bans associated with a player or their recorded IP | lightbans.unbanip |
/unmute <player> [reason] |
Revoke mutes for a player | lightbans.unmute |
/unmuteip <player> [reason] |
Revoke IP mutes associated with a player or their recorded IP | lightbans.unmuteip |
/unwarn <player> [reason] |
Revoke a player's warnings | lightbans.unwarn |
/alts <player> |
List accounts recorded on the same IP | lightbans.alts |
/dupeip <player> |
Show duplicate-IP history; console only | lightbans.dupeip |
/history <player> [page] |
View a player's punishment history | lightbans.history |
/check <player> [page] |
Check a player's active punishments | lightbans.check |
/banhistory [page] |
Open active ban history | lightbans.banhistory |
/mutehistory [page] |
Open active mute history | lightbans.mutehistory |
/userhistory <player> [page] |
Open a player's history menu | lightbans.userhistory |
/mod <player> |
Open the moderation menu | lightbans.mod |
/lightbans reload |
Reload the plugin configuration | lightbans.admin |
🔑 Permission nodes
LightBans provides separate permission nodes for each command, listed in the command table above. The lightbans.mod permission grants access to the moderation menu, and lightbans.admin grants access to /lightbans reload.
📦 Compatibility
Built for Paper 1.21 and newer. The server must run a compatible Java version.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Small update. 2.2.2 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, paper, purpur, spigot
|
Download |
|
2.2.1 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
2.2.0 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
2.1.0 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
2.1.0 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans ${project.version} 2.0 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans 1.0.0 1.0.0 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans 1.0.0 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans 1.0.0 |
1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans 1.0.0 1.0.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
bukkit, paper, spigot
|
Download |
|
LightBans 1.0.0 1.0.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
bukkit, paper, purpur, spigot
|
Download |
|
LightBans 1.0.0 1.0.0 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
bukkit, paper, spigot
|
Download |