Zenith-Mod v1.1.6 - First Release

A comprehensive and professional moderation plugin for Paper servers with advanced player management tools, database persistence, and modern architecture.

🚀 What is Zenith-Mod?

Zenith-Mod is a complete moderation solution designed for modern Paper servers. Built with performance and scalability in mind, it provides everything you need to manage your community professionally.

✨ Features

🎯 Core Moderation Systems

• Advanced Ban System - Complete ban management with IP bans, temporary/permanent bans, and escalation templates
• Mute System - Chat muting with command blocking, offline player support, and template-based escalation
• Warning System - Comprehensive warning management with escalation levels and automatic punishments
• Freeze System - Player freezing with configurable restrictions and notifications

🔧 Template System

• Pre-configured punishment templates with automatic escalation
• Track offenses by player UUID or IP address
• Customizable duration levels and reason suffixes
• Template-specific permissions for staff members

💻 Offline Player Support

• Mute, ban, and warn players even when they're offline
• Automatic player creation in database for offline operations
• Complete audit trail with case IDs for all actions

📊 Advanced Player Management

• Alt Detection & Limiting - Automatic detection of alt accounts and configurable limits per IP
• History System - Complete moderation history with case IDs and audit trails
• Note System - Staff notes for players, invisible to players
• Player Info System - Real-time player information and status checks

🎨 Vanish System

• Complete invisibility from other players
• Hides from tab list, player list, and nametags
• Prevents damage, block interactions, and item pickup
• Auto god-mode and flight for vanished players
• Permission-based visibility control

⚡ Performance Optimized

• Zero thread blocking with async operations
• Async database queries throughout
• Hot-reload configuration without server restart
• Custom logging system with colored console output

🚨 Staff Notifications

• Real-time notifications for moderation events
• Banned player join attempts
• Muted player chat attempts
• Permission-based notification system

🔗 Web-API Integration (Premium)

• RESTful API for external integrations and web panels
• Token-based authentication system
• Real-time server statistics and player management
• License validation for premium features

🎮 Discord Integration (Beta)

• Discord slash commands for moderation
• Ban, mute, and player management via Discord
• Real-time moderation from Discord
• Discord embed notifications
• ⚠️ Currently in BETA - use with caution

📁 Modular Configuration

The plugin uses a modular configuration system for easy customization:

Core Configuration

• config.yml - Main plugin configuration, database settings, and general options
• messages.yml - Customizable messages, notifications, and placeholder support

Module Configurations

• modules/ban.yml - Ban system with templates and escalation
• modules/mutes.yml - Mute system with chat blocking
• modules/warn.yml - Warning system
• modules/freeze.yml - Player freeze system
• modules/kick.yml - Kick system
• modules/notes.yml - Staff notes system
• modules/essentials.yml - Essential commands
• modules/gamemodes.yml - Gamemode management
• modules/vanish.yml - Vanish system
• modules/limiter.yml - Alt detection and limiting
• modules/client-detector.yml - Client detection
• modules/chat-freeze.yml - Chat freeze system
• modules/history.yml - History tracking
• modules/check.yml - Player check system
• modules/web-api.yml - Web-API configuration
• modules/discord/discord-bot.yml - Discord bot configuration (BETA)

🛠️ Requirements & Compatibility

✅ Tested On

• Paper 1.21.4 (Primary development and testing version)

⚠️ Compatibility Rating

• Paper 1.21.4+: ✅ Fully supported and tested
• Paper 1.21.0-1.21.3: ✅ Very likely compatible
• Paper 1.20.x: ✅ Very likely compatible
• Paper 1.19.4: ⚠️ Probably compatible
• Paper 1.19.0-1.19.3: ⚠️ May work with minor issues
• Paper 1.18.x and older: ❌ Unlikely to work
• Spigot: ⚠️ Partially supported (some features may not work)

🚀 Future-Proof Design

• No Deprecated APIs: This plugin uses only current, non-deprecated Bukkit/Paper APIs
• Modern Architecture: Built with latest Paper Plugin system and async operations
• Stable Dependencies: Uses only stable, long-term supported features
• Forward Compatible: Designed to work with future Paper versions
• Clean Code: No legacy code or deprecated methods that could break in future updates

🚫 Not Supported

• Custom Paper Forks - Use at your own risk, no support provided
• PlugMan - Do not use PlugMan to load this plugin (Paper plugins not supported)
• Bukkit - Requires Paper/Spigot API features

📦 Database Support

Supported Databases

• H2 (Embedded - Default, perfect for single-server setups)
• SQLite (File-based, great for small servers)
• MySQL (Network database, ideal for multi-server setups)
• MariaDB (Network database, MySQL alternative)

Features

• HikariCP connection pooling for optimal performance
• Automatic database initialization
• Async database operations throughout
• Migration support for future updates

📝 Changelog (v1.1.6)

Fixed

• Alt Limit System: Fixed critical bug where players could bypass alt limits
• Proxy Support: Added Velocity/BungeeCord IP forwarding support
• Performance: Removed thread blocking in CommandBlocker and Discord commands

Added

• Proxy Detection: Automatic IP detection from proxy servers
• Debug Logging: Enhanced IP detection with detailed logging
• Performance Optimizations: Async operations throughout

Changed

• CommandBlocker: Now uses async operations, no more thread blocking
• MuteSlashCommand: Optimized async handling to prevent "zip file closed" errors
• IPUtils: Added Velocity proxy support with reflection-based IP detection

🎯 Getting Started

1. Download the latest version from Modrinth
2. Place the JAR file in your plugins/ folder
3. Restart your server
4. Configure the plugin in plugins/Zenith-Mod/
5. Set up your database in config.yml
6. Customize messages in messages.yml
7. Configure modules in modules/ directory

📞 Support & Resources

• Discord: Zenith Studios Discord
• Documentation: Zenith-Mod

⚠️ Important Notes

Discord Integration (BETA)

• Discord slash commands are currently in BETA
• Use with caution in production environments
• Report any issues on Discord
• Configuration available in modules/discord/discord-bot.yml

Permissions

• All permissions are documented in plugin.yml
• Use LuckPerms or your preferred permission manager
• Template permissions follow pattern: zenith.[action].template.[name]

Performance

• All database operations are async
• No thread blocking in moderation commands
• Built-in connection pooling for optimal performance
• Hot-reload with /zenith reload command

🎉 Ready to Get Started?

Zenith-Mod is the complete moderation solution you've been waiting for. Download now and revolutionize your server's moderation system!

---

Version: 1.1.6
Release Date: January 14, 2025 Platform: Paper 1.21.4+

---

Made with ❤️ by Zenith Studios