1.0.1
release
BansNexus
Optimized and secured PUNISH PLUGIN made specifically for Minecraft
449
BansNexus
<h1 align="center">🛡️ NexusBan</h1>
<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
- Warnings - Ban troublemakers forever - Warnings - Time-based bans with auto-expiry - Warnings - Block by IP address - Warnings - Permanent & temporary mutes - Warnings - Remove players instantly - Warnings - Track player behavior
</td> <td width="50%">
🔍 Advanced Features
- Auto-Punish - Find alt accounts by IP - Auto-Punish - Easy point-and-click interface - Auto-Punish - Complete punishment records - Auto-Punish - Prevent staff from punishing each other - Auto-Punish - Zero server lag - Auto-Punish - Automatic escalation based on warnings
</td> </tr> </table>
---
📦 Installation
1. Configure your wished version 2. Configure `NexusBan-1.1.1.jar` into your server's `plugins/` folder 3. Configure your server 4. 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
```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 ```
---