🛡️ NexusBan
A powerful, modern punishment system for Minecraft Spigot servers
Keep your server safe with advanced moderation tools
✨ Features
🔨 Punishment System
|
🔍 Advanced Features
|
📦 Installation
- Download your wished version
- Drop
NexusBan-1.1.1.jarinto your server'splugins/folder - Restart your server
- Configure in
plugins/NexusBan/config.yml
🎮 Commands
Ban Commands
| Command | Description | Example |
|---|---|---|
/ban <player> [reason] |
Permanent ban | /ban Griefer123 Griefing spawn |
/tempban <player> <time> [reason] |
Temporary ban | /tempban Hacker 7d Using xray |
/unban <player> |
Remove a ban | /unban Griefer123 |
/ipban <player|ip> [reason] |
IP ban | /ipban Evader Alt account |
/unipban <player|ip> |
Remove IP ban | /unipban 192.168.1.1 |
Mute Commands
| Command | Description | Example |
|---|---|---|
/mute <player> [reason] |
Permanent mute | /mute Spammer Spam in chat |
/tempmute <player> <time> [reason] |
Temporary mute | /tempmute Toxic 1h Toxic behavior |
/unmute <player> |
Remove mute | /unmute Spammer |
Other Commands
| Command | Description |
|---|---|
/kick <player> [reason] |
Kick from server |
/warn <player> [reason] |
Issue a warning |
/punish <player> |
Open punishment GUI |
/history <player> |
View punishment history |
/banlist |
List all active bans |
/ipbanlist |
List all IP bans |
/alts <player> |
Check for alt accounts |
/checkban <id> |
Look up ban details |
/nbreload |
Reload configuration |
⏱️ Time Format
s = Seconds m = Minutes h = Hours
d = Days w = Weeks M = Months y = Years
Examples: 30m, 2h, 7d, 2w, 1M, 1y
Combined: 1d12h30m = 1 day, 12 hours, 30 minutes
🔐 Permissions
Click to expand permission list
| Permission | Description | Default |
|---|---|---|
nexusban.* |
All permissions | OP |
nexusban.ban |
Use /ban | OP |
nexusban.tempban |
Use /tempban | OP |
nexusban.unban |
Use /unban | OP |
nexusban.ipban |
Use /ipban | OP |
nexusban.unipban |
Use /unipban | OP |
nexusban.ipbanlist |
Use /ipbanlist | OP |
nexusban.kick |
Use /kick | OP |
nexusban.mute |
Use /mute | OP |
nexusban.tempmute |
Use /tempmute | OP |
nexusban.unmute |
Use /unmute | OP |
nexusban.warn |
Use /warn | OP |
nexusban.history |
Use /history | OP |
nexusban.gui |
Use /punish GUI | OP |
nexusban.banlist |
Use /banlist | OP |
nexusban.checkban |
Use /checkban | OP |
nexusban.alts |
Use /alts | OP |
nexusban.alts.showip |
See IPs in /alts | OP |
nexusban.reload |
Use /nbreload | OP |
nexusban.notify |
Receive staff alerts | OP |
nexusban.exempt |
Cannot be punished | false |
nexusban.admin |
Admin-level staff | false |
nexusban.moderator |
Moderator-level | false |
⚙️ Configuration
# Message settings
messages:
prefix: "&8[&c&lNEXUS&4&lBAN&8] &7"
# Staff Chat format
staffchat-format: "&8[&c&lSTAFF&8] &e{sender} &8» &f{message}"
# Freeze system messages
freeze:
frozen: "&c&l⚠ YOU HAVE BEEN FROZEN ⚠\n&7You cannot move or interact..."
chat-format: "&8[&c&lFROZEN&8] &e{player} &8» &f{message}"
# Discord invite (shown on ban screens)
discord:
invite-url: "discord.gg/yourserver"
server-name: "Our Discord"
# Rejoin warnings
rejoin-warning:
enabled: true
show-for-hours: 168 # Show warning for 7 days after punishment
# Auto-punish system
auto-punish:
enabled: true
warnings-for-tempmute: 3
warnings-for-tempban: 5
warnings-for-ban: 10
