LightBans

## ⚡ 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 - **Softban**: Ban, clear data, kick, and immediately unban a player - **Blacklist**: Permanent, irrevocable blacklist with data removal - **Alts**: check Alts, track IP Address ### ✏️ 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> <reason>` | Ban a player (permanent or temporary) | `lightbans.ban` | | `/tempban <player> <duration> <reason>` | Temporarily ban a player | `lightbans.tempban` | | `/ipban <player> <reason>` | IP ban a player | `lightbans.ipban` | | `/mute <player> <reason>` | Mute a player | `lightbans.mute` | | `/tempmute <player> <duration> <reason>` | Temporarily mute a player | `lightbans.tempmute` | | `/muteip <player> <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 `/l` prefix 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.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 | ---