Zenith-Mod - Professional Moderation Plugin

A comprehensive moderation plugin built for modern Paper servers. Zenith-Mod gives you everything you need to manage your community effectively, with a focus on performance and reliability.

Core Features

Complete Moderation Suite

Ban System - Full ban management with IP bans, temporary and permanent bans, automatic escalation, and template support. Ban players whether they're online or offline.

Mute System - Chat muting with command blocking support. Works for offline players too, so you can mute someone before they even join. Includes IP-based muting and automatic escalation.

Warning System - Track warnings with escalation levels and customizable thresholds. See a player's warning history at a glance.

Freeze System - Freeze players in place with movement restrictions. Perfect for investigations or preventing griefers from escaping.

Kick System - Enhanced kick functionality with custom reasons and staff notifications.

AutoMod - The AutoMod system automatically monitors chat and removes messages that violate your server rules — no manual intervention needed. Word Filter automatically detects and removes messages containing blacklisted words. Thanks to built-in Leetspeak normalization, bypass attempts like 1d10t, i.d.i.o.t or @ssh0le are caught automatically — you only need to add the base word to the list. AntiSpam detects two types of spam: players sending the same message repeatedly (duplicate detection) and players flooding the chat with too many messages in a short time (flood detection). Both thresholds are fully configurable. When a message is blocked, the player receives a notification and staff members with the alert permission are instantly notified in-game. Alerts are also sent to a configurable Discord channel as an embed. Staff can toggle their own alerts on/off with /automod alerts.

Banlist GUI - The Banlist GUI gives your staff a clean overview of all bans on your server — both active and inactive — directly in-game via /banlist. Active bans are displayed in red, expired or already unbanned players in green, making it easy to see the current status at a glance. Each entry shows the player head, ban reason, type (Ban or IP-Ban), remaining duration, the staff member who issued the ban, and the Case ID. Staff can filter the list to show all bans, active bans only, or inactive bans only. A built-in Case ID search lets you find a specific case instantly by typing the ID in chat. Clicking on an active ban entry unbans the player directly from the GUI.

Advanced Management Tools

Vanish System - Complete invisibility with tab list hiding, god mode, and permission-based visibility. Staff can stay hidden while monitoring the server.

Alt Detection & Limiting - Automatically detect alt accounts and limit how many accounts can connect from the same IP address (configurable up to 5 accounts per IP).

Client Detection - Detect what client players are using and take action based on that information.

Chat Freeze - Temporarily freeze all chat for announcements or emergencies. Useful for server-wide announcements.

Notes System - Staff-only notes for players with full history tracking. Keep internal notes that players can't see.

History System - Complete audit trail with case IDs for all moderation actions. Every action is logged and searchable.

Template & Escalation System

Pre-configured Templates - Ready-to-use punishment templates that automatically escalate based on repeat offenses. Set up once and let the system handle repeat offenders.

Multi-level Escalation - Automatic duration increases based on how many times a player has been punished. First offense gets a warning, second gets a short ban, third gets longer, and so on.

IP/UUID Tracking - Choose whether to track by IP address or UUID per template. Some offenses might need IP tracking, others don't.

Custom Reason Suffixes - Automatically add offense level information to ban reasons. Makes it clear why someone got a longer ban.

Template Permissions - Granular permission system so junior staff can only use certain templates.

Offline Player Support

One of Zenith-Mod's key features is that you can moderate players even when they're not currently online. This means you can ban, mute, warn, freeze, or add notes to players who are offline - the action will take effect as soon as they try to join. This is especially useful for handling reports or taking action on players who logged off before you could deal with them.

Note: This refers to players who are currently offline, not offline-mode (cracked) Minecraft servers. The plugin works with standard online-mode authentication.

API & Integrations

Java API System (Beta)

Zenith-Mod includes a comprehensive Java API for developers who want to integrate moderation features into their own plugins.

Available APIs:

• FreezeAPI - Programmatically freeze and unfreeze players with history tracking
• ChatFreezeAPI - Control server chat programmatically
• EssentialsAPI - God mode, fly mode, heal, feed, clear inventory, teleport
• VanishAPI - Vanish and unvanish players programmatically
• Event System - Listen to moderation actions with custom events (Ban, Mute, Warn, Kick events)

All API methods use CompletableFuture for non-blocking operations, so they won't slow down your server. Staff notifications and history logging happen automatically for all API actions.

API Documentation: http://javadocs.zenith-studios.org/

Other Integrations

Web-API (Premium) - RESTful API for external integrations and web panels. Token-based authentication with real-time server statistics and license validation for premium features.

Discord Integration (Beta) - Use slash commands in Discord to perform moderation actions. Great for remote moderation or integrating with Discord bots.

Performance Optimized

Everything in Zenith-Mod is built with performance in mind. All operations are fully asynchronous, so nothing blocks the main server thread. We use HikariCP for database connection pooling, which means fast and efficient database operations. Configuration changes can be reloaded without restarting the server, and all database queries are non-blocking.

Modern Architecture

Multi-Database Support - Works with H2 (default), SQLite, MySQL, or MariaDB. Use H2 for single servers, MySQL/MariaDB for multi-server setups.

Proxy Support - Full support for Velocity and BungeeCord IP forwarding.

Modular Configuration - Each module has its own config file, making it easy to customize what you need.

Permission-Based - Comprehensive permission system so you can control who can do what.

Error Handling - Robust error handling means the plugin won't crash your server if something goes wrong.

Modules

What we're planning:

• Punish Command - Take moderation actions through a GUI
• VoiceChat Muting - Mute people in voice chat using Simple Voice Chat

Technical Specifications

Compatibility

• Paper 1.21.4+ - Fully tested and supported
• Paper 1.21.x - Very likely compatible
• Paper 1.20.x - Very likely compatible
• Paper 1.19.4 - Probably compatible
• Paper 1.19.x - May work with minor issues
• Paper 1.18.x and older - Not supported
• Spigot - Partially supported (some features may not work)

Requirements

• Java: 17 or higher
• Server: Paper 1.19.4+ recommended
• Database: H2 (default), SQLite, MySQL, or MariaDB
• Permissions: LuckPerms or similar (recommended)

Configuration

• Hot-Reload: Use /zenith reload to reload all configs without restarting
• Modular Config: Each module has its own YAML file in the modules/ directory
• Color Support: Full hex color support and Minecraft color codes
• Placeholders: Dynamic placeholders in all messages

Key Commands

• /ban <player> <template> - Ban a player using a template
• /mute <player> <template> - Mute a player using a template
• /warn <player> <template> - Warn a player using a template
• /freeze <player> - Freeze a player in place
• /vanish - Toggle vanish mode
• /history <player> - View a player's moderation history
• /notes <player> - Manage staff notes for a player
• /check <player> - Check a player's current status
• /zenith reload - Reload all configuration files
• /zenith help - Show all available commands

Staff Features

• Real-time notifications for all moderation events
• Auto-escalation based on repeat offenses
• IP-based tracking to prevent alt account abuse
• Complete audit trail with searchable case IDs
• Offline player moderation support
• Template-only mode for junior staff members

Performance Highlights

• Async Operations: Nothing blocks the server thread
• Connection Pooling: HikariCP for optimal database performance
• Smart Caching: Frequently accessed data is cached
• File Rotation: Automatic log file rotation by date
• Error Recovery: Automatic retry for database operations

Statistics & Tracking

• Player join and leave tracking
• Moderation action counts
• Active ban and mute tracking
• Offense count per template
• Alt account detection
• IP address tracking (with proxy support)

Customization

• Messages: Fully customizable in messages.yml
• Colors: Hex color support throughout
• Placeholders: Dynamic content in all messages
• Prefix: Configurable prefix for all messages
• Duration Format: Customizable duration display

Getting Started

1. Download the plugin and place it in your plugins/ folder
2. Restart your server
3. Configure your database settings in config.yml
4. Customize messages in messages.yml if needed
5. Configure modules in the modules/ directory
6. Use /zenith reload to apply any configuration changes

For Plugin Developers

Zenith-Mod provides a comprehensive Java API for plugin integration:

ZenithAPI api = ZenithAPI.getInstance();
if (api != null && api.isAvailable()) {
    // Use FreezeAPI, ChatFreezeAPI, EssentialsAPI, VanishAPI
    // Subscribe to events with ZenithEventBus
}

Full API Documentation: http://javadocs.zenith-studios.org/

// Subscribe to ban events
ZenithEventBus bus = ZenithEventBus.getInstance();
bus.subscribe(PlayerBanEvent.class, event -> {
    getLogger().info(event.getPlayerName() + " was banned: " + event.getReason());
});

// Freeze a player via API
FreezeAPI freezeAPI = api.getFreezeAPI();
freezeAPI.freeze(playerUuid, staffUuid, "Investigation").thenAccept(success -> {
    if (success) {
        getLogger().info("Player frozen successfully");
    }
});

Important Notes

• Java API: Currently in BETA - API structure may change in future versions
• Discord Integration: Currently in BETA - use with caution
• Premium Features: Some features require a license
• Database: H2 is recommended for single-server setups
• MySQL/MariaDB: Recommended for multi-server setups

Support & Resources

• Discord: Join our Discord
• Premium Modules: Available on Discord
• Documentation: Zenith-Mod Docs
• API Documentation: Javadocs
• Support: Available on Discord

Why Zenith-Mod?

Performance First - Zero thread blocking, fully async operations
Modern Design - Built for Paper 1.21.4+ with latest APIs
Complete Solution - Everything you need in one plugin
Developer Friendly - Comprehensive Java API for integrations
Scalable - Works great for small and large servers
Professional - Enterprise-grade reliability
Configurable - Highly customizable to fit your needs
Well Documented - Comprehensive documentation and support

Made with ❤️ by Zenith Studios