🛡️ NexusBan

![PRIDE](https://i.imgur.com/0PDKhyj.png)

A powerful, modern punishment system for Minecraft Spigot servers
Keep your server safe with advanced moderation tools

--- ## ✨ Features

### 🔨 Punishment System - **Permanent Bans** - Ban troublemakers forever - **Temporary Bans** - Time-based bans with auto-expiry - **IP Bans** - Block by IP address - **Mutes** - Permanent & temporary mutes - **Kicks** - Remove players instantly - **Warnings** - Track player behavior

### 🔍 Advanced Features - **Alt Detection** - Find alt accounts by IP - **Punishment GUI** - Easy point-and-click interface - **Ban History** - Complete punishment records - **Staff Protection** - Prevent staff from punishing each other - **Async I/O** - Zero server lag - **Auto-Punish** - Automatic escalation based on warnings

--- ## 📦 Installation 1. **Download** your wished version 2. **Drop** `NexusBan-1.1.1.jar` into your server's `plugins/` folder 3. **Restart** your server 4. **Configure** in `plugins/NexusBan/config.yml` --- ## 🎮 Commands ### Ban Commands | Command | Description | Example | |---------|-------------|---------| | `/ban [reason]` | Permanent ban | `/ban Griefer123 Griefing spawn` | | `/tempban [reason]` | Temporary ban | `/tempban Hacker 7d Using xray` | | `/unban ` | Remove a ban | `/unban Griefer123` | | `/ipban [reason]` | IP ban | `/ipban Evader Alt account` | | `/unipban ` | Remove IP ban | `/unipban 192.168.1.1` | ### Mute Commands | Command | Description | Example | |---------|-------------|---------| | `/mute [reason]` | Permanent mute | `/mute Spammer Spam in chat` | | `/tempmute [reason]` | Temporary mute | `/tempmute Toxic 1h Toxic behavior` | | `/unmute ` | Remove mute | `/unmute Spammer` | ### Other Commands | Command | Description | |---------|-------------| | `/kick [reason]` | Kick from server | | `/warn [reason]` | Issue a warning | | `/punish ` | Open punishment GUI | | `/history ` | View punishment history | | `/banlist` | List all active bans | | `/ipbanlist` | List all IP bans | | `/alts ` | Check for alt accounts | | `/checkban ` | 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 ```yaml # 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 ``` ---

leifiyoo

Organizations