LightBans
2.2.2Advanced Moderation & Punishment plugin for a Minecraft server. Discord webhooks for easy access to check punishments.
- Tested MC versions
- 1.19, 1.20, 1.21, 26.1, 26.2, 26.3
⚡ 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.
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.3MSueta
Chunky
Pre-generates chunks, quickly and efficiently
20.8MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta