NovaModeration

🌌 NovaModeration

NovaModeration is the ultimate, lightweight, and ultra-performance moderation solution designed specifically for Velocity proxies. Manage your entire network seamlessly with advanced commands, fully customizable dynamic messages, and an intelligent tab-completer system.

🚀 Key Features

• Advanced Sanction Management: Built-in commands for /ban, /unban, /kick, /mute, /unmute, and /check to cover every staff requirement.
• Duration Flexibility: Native support for both temporary punishments (e.g., 30m, 1h, 7d) and permanent options (perm).
• Dynamic Configuration Messages: Fully customize any text or notification shown to players using standard color codes (&) and dynamic placeholders (%banner%, %reason%, %duration%).
• Intelligent Tab-Completer: Context-aware automatic suggestions including online player names, example reasons, or updated lists of sanctioned users for quick unbanning/unmuting.
• Lightweight Local Storage: No external databases required. Data is stored efficiently in local flat files to ensure lightning-fast performance without bloating your proxy.
• Automatic Updates: Features an asynchronous version checker linked directly to the official Hangar repository.

🛠️ Example Configuration (config.yml)

The plugin automatically generates a configuration file featuring custom developer credits and total control over your system messages:

# ====================================================================
# NovaModeration v1.1.0 - Configuration File
# Author: leccato
# GitHub: [https://github.com/leccato-coder](https://github.com/leccato-coder)
# Hangar: [https://hangar.papermc.io/leccato-coder/NovaModeration](https://hangar.papermc.io/leccato-coder/NovaModeration)
# ====================================================================

# Enable or disable the automatic update checker via Hangar
update-checker: true

# Custom ban screen message format
ban-message: "&c&l❌ YOU HAVE BEEN BANNED ❌\n\n&7Banned by: &6%banner%\n&7Reason: &e%reason%\n&7Duration: &b%duration%"

# Kick system settings
kick-message: "&c&l❌ YOU HAVE BEEN KICKED ❌\n\n&7Kicked by: &6%kicker%\n&7Reason: &e%reason%"
kick-success: "&a[NovaModeration] The player &e%target% &ahas been kicked successfully."

# Unban Messages
unban-success: "&a[NovaModeration] The player &e%target% &ahas been successfully unbanned by &6%sender%&a."
unban-not-banned: "&c[NovaModeration] The player &e%target% &cis not currently banned."

# Mute Messages
mute-message: "&c[NovaModeration] You have been muted by &6%muter%&c. Reason: &e%reason%&c. Expiry: &b%duration%"
mute-notify-chat: "&c[NovaModeration] You cannot type in chat! You are muted until: &b%duration% &c(Reason: &e%reason%&c)"
mute-success: "&a[NovaModeration] The player &e%target% &ahas been successfully muted."
unmute-success: "&a[NovaModeration] The player &e%target% &ahas been successfully unmuted by &6%sender%&a."
unmute-not-muted: "&c[NovaModeration] The player &e%target% &cis not currently muted."

### 💻 Commands & Permissions

| Command | Description | Arguments |
| :--- | :--- | :--- |
| `/ban` | Bans a player from the network | `[player] [duration] [reason]` |
| `/unban` | Revokes a player's bando status | `[player]` |
| `/kick` | Instantly drops a player from the proxy | `[player] [reason]` |
| `/mute` | Silences a player in the network chat | `[player] [duration] [reason]` |
| `/unmute` | Permits a player to speak again | `[player]` |
| `/check` | Displays detailed status and history of a user | `[player]` |
| `/ban reload` | Instantly reloads the `config.yml` file | _None_ |

---