🛡️ NexusBan

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

✨ Features

📦 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> [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

⚙️ 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