🛡️ NexusBan
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
```
---
449
