Zombie Apocalypse Core [ZAC]
# Zombie Apocalypse Core
Necessity for zombie apocalypse modpacks.
Continuation of the Zombie Apocalypse Core mod.
**If you have any feature ideas, open an issue on the GitHub and if its relevant, it may be added**
The Fabric version needs Fabric API as a dependency.
Compatibility
No known incompatible mods found yet, and no mod has been given explicit compatibility either.
If you find incompatible mods, please open a GitHub issue so they can be added here.
Features
'How configurable each feature is' - the measure
☔ if on/off values,
☔☔ if editable lists/numerical values,
and ☔☔☔ if on/off with editable lists/numerical values)
Or simply, more umbrellas more configuration potential
– Zombies can break blocks (☔☔☔)
– Additional zombie drops (☔☔☔)
– Entity multiplier (☔☔☔)
– Entity blocklist (☔☔)
– Daylight resistance (☔☔)
– Heavily armored zombies (☔)
– Day counter (☔)
Config
`this section is excessively verbose, read it only if you are confused with the config`
The config file is present at `your_minecraft_game_dir/config/zac-common.toml` where your_minecraft_game_dir is your minecraft game directory.
**REMEMBER!**
only registry names can be used in lists, for the additionalZombieDrops list you can use registry names of items (`minecraft:item`) and for the entity lists you can use the entity’s registry name (`minecraft:entity`) where item and entity correspond to the item/entity’s registry name.
This should work with entities and items from other mods as well, but has not been yet tested.
You would simply replace the minecraft namespace (`minecraft`) with the mod’s namespace (`mod`) and it would look like `mod:item` or `mod:entity`.
Here is a line-by-line explanation:
“`toml
# integer (1, 2, 3…)
entityMultiplierRate = 1
“`
Pretty self-explanatory
“`toml
# list [“entry1”, “entry2”]
entityMultiplierEntities = []
“`
List of entities which are going to be multipled `entityMultiplierRate` times every time they spawn.
“`toml
# list [“entry1”, “entry2”]
entityBlocklistEntities = []
“`
List of entities which either won’t spawn or will instantly get despawned.
“`toml
# list [“entry1”, “entry2”]
daylightResistantEntities = [“minecraft:zombie”]
“`
List of entities which will not burn in the day.
“`toml
# list [“entry1”, “entry2”]
additionalZombieDrops = [“minecraft:rotten_flesh=0.9”, “minecraft:bone=0.1”, “minecraft:carrot=0.009”, “minecraft:potato=0.0009”, “minecraft:iron_nugget=0.0005”, “minecraft:gold_nugget=0.0001”]
“`
List of additional zombie drops, the default zombie loottable is unchanged, these are merely extra drops with chances.
To get the percentage in decimals (as used here), just divide the percentage number by 100.
“`toml
# bool (true/false)
heavilyArmoredZombiesEnabled = false
“`
Does exactly what it says.
“`toml
# bool (true/false)
dayCounterEnabled = true
“`
Also does exactly what it says.
“`toml
# bool (true/false)
zombiesBreakBlocks = true
“`
Whether zombies should be able to break blocks in between its path to the player or not.
“`toml
# integer (1, 2, 3…)
zombieBlockBreakReach = 3
“`
How far zombies can be from a block and still be able to break it.
“`toml
blockMinimumHardness = 0
“`
Block hardness below which zombies **cannot** break blocks.
Check this out for more information about block hardness: minecraft.wiki
“`toml
blockMaximumHardness = 3
“`
Block hardness below which zombies **can** break blocks.
Zenith-Mod
# Zenith-Mod – Professional Moderation Plugin
Missing something?
Do you miss something in this Plugin? Open a Ticket in our Discord 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/
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
## 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 ` – Ban a player using a template
– `/mute ` – Mute a player using a template
– `/warn ` – Warn a player using a template
– `/freeze ` – Freeze a player in place
– `/vanish` – Toggle vanish mode
– `/history ` – View a player’s moderation history
– `/notes ` – Manage staff notes for a player
– `/check ` – 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:
“`java
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/
API Usage Example
“`java
// 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**
