<h1 align="center">🛡️ NexusBan</h1> !(https://i.imgur.com/0PDKhyj.png) <p align="center"> <b>A powerful, modern punishment system for Minecraft Spigot servers</b><br> <i>Keep your server safe with advanced moderation tools</i> </p> --- ## ✨ Features <table> <tr> <td width="50%"> ### 🔨 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 </td> <td width="50%"> ### 🔍 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 </td> </tr> </table> --- ## 📦 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 <player> ` | Permanent ban | `/ban Griefer123 Griefing spawn` | | `/tempban <player> <time> ` | Temporary ban | `/tempban Hacker 7d Using xray` | | `/unban <player>` | Remove a ban | `/unban Griefer123` | | `/ipban <player\|ip> ` | IP ban | `/ipban Evader Alt account` | | `/unipban <player\|ip>` | Remove IP ban | `/unipban 192.168.1.1` | ### Mute Commands | Command | Description | Example | |---------|-------------|---------| | `/mute <player> ` | Permanent mute | `/mute Spammer Spam in chat` | | `/tempmute <player> <time> ` | Temporary mute | `/tempmute Toxic 1h Toxic behavior` | | `/unmute <player>` | Remove mute | `/unmute Spammer` | ### Other Commands | Command | Description | |---------|-------------| | `/kick <player> ` | Kick from server | | `/warn <player> ` | 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 <details> <summary><b>Click to expand permission list</b></summary> | 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 | </details> --- ## ⚙️ Configuration ```yaml # Message settings messages: prefix: "&8 &7" # Staff Chat format staffchat-format: "&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 &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 ``` ---