🛡️ 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.0.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

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

# NexusBan Configuration

# Message settings
messages:
  prefix: "&8« &b&lNexus&3&lBan &8» &7"

# Ban screen appeal URL (shown to banned players)
appeal-url: "discord.gg/yourserver"

# Auto-punish (escalate warnings automatically)
auto-punish:
  enabled: true
  warnings-for-tempmute: 3   # 3 warnings = temp mute
  warnings-for-tempban: 5    # 5 warnings = temp ban
  warnings-for-ban: 10       # 10 warnings = permanent ban

# Auto-punishment durations
auto-durations:
  tempmute: "1h"
  tempban: "1d"

---