ZakoHealthIndicator

A client-side Fabric mod that shows an on-screen health indicator when you hit another player in PvP. The health value is displayed as a colored HUD element that scales up at low HP, with customizable position, scale, and display duration.

ZaffeineSMP

Welcome to ZaffeineSMP, the ultimate Minecraft mod pack designed to enhance your multiplayer experience with seamless performance, immersive communication, and breathtaking vistas.

**Optimized Performance:**
ZaffeineSMP is carefully curated with multiple performance-enhancing mods, ensuring that Minecraft runs smoothly on a wide range of hardware configurations. Whether you’re playing on a high-end gaming rig or a modest laptop, you’ll enjoy buttery-smooth gameplay without compromising on visuals or features.

**Proximity Voice Chat Mod:**
Communication is key in any multiplayer adventure, and ZaffeineSMP takes it to the next level with a preinstalled Proximity Voice Chat Mod. Say goodbye to clunky third-party voice chat software – now you can effortlessly chat with nearby players in real-time, adding a new layer of immersion to your Minecraft experience. Whether you’re coordinating a daring raid or simply chatting with friends while exploring, the Proximity Voice Chat Mod keeps you connected like never before.

**Bobby Mod for Enhanced View Distance:**
Immerse yourself in the stunning landscapes of Minecraft like never before with the Bobby Mod, included in ZaffeineSMP. Say farewell to the limitations of standard view distances and expand your horizons to breathtaking new heights. Explore vast landscapes, majestic mountains, and sprawling vistas with unparalleled clarity and detail, making every adventure in ZaffeineSMP a visual feast for the eyes.

Join the ZaffeineSMP community today and experience Minecraft like never before – with optimized performance, immersive communication, and unparalleled vistas awaiting you at every turn. Connect with fellow players, share your adventures, and stay up-to-date on the latest news and events by joining our Discord server: [https://discord.gg/FP7QgQMcJj](https://discord.gg/FP7QgQMcJj)

Zenith-Mod

# Zenith-Mod – Professional Moderation Plugin

Missing something?

Do you miss something in this Plugin? Open a Ticket in our [Discord](https://discord.gg/2a4a3mWR4r) and we’ll implement it very asap!

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/](http://javadocs.zenith-studios.org/)

API Beta Notice

The Java API is currently in **Beta**. While core plugin functionality is stable, API features may undergo changes in future versions. Use at your own risk.

#### 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

| Module | Description |
|——–|————-|
| **Ban** | Complete ban management with IP bans and escalation |
| **Mute** | Chat muting with command blocking and escalation |
| **Warn** | Warning system with customizable thresholds |
| **Freeze** | Player freezing with restrictions |
| **Kick** | Enhanced kick system |
| **Vanish** | Complete invisibility system |
| **Limiter** | Alt detection and IP limiting |
| **History** | Complete moderation history tracking |
| **Notes** | Staff notes system |
| **Check** | Player information and status checks |
| **Client Detector** | Client type detection |
| **Chat Freeze** | Temporary chat freezing |
| **Essentials** | God mode, fly mode, heal, feed, clear, teleport |
| **Web-API** (Premium) | RESTful API integration |
| **Discord** (Beta) | Discord bot integration |

**What we’re planning:**
– Punish Command – Take moderation actions through a GUI
– VoiceChat Muting – Mute people in voice chat using [Simple Voice Chat](https://modrinth.com/plugin/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