Skip to content

ZelCombat

Installation

Setting up ZelCombat takes under a minute.

1. Before you start

  • Purchase the plugin from an approved marketplace (BuiltByBit or PixelEast).
  • Your server must run Paper 1.21+ (Folia and Paper forks are supported).
  • Join the support Discord if you need help or a license.

2. Drop it in

  • Place ZelCombat-x.x.x.jar into your server's plugins/ folder.
  • Start (or restart) the server.
  • On first boot ZelCombat writes its config files to plugins/ZelCombat/:
    • settings.yml — the main config
    • blocker.yml — which items are blocked in combat
    • cooldowns.yml — per-item cooldowns
    • messages.yml — every message the plugin sends

3. Add your license key

Open plugins/ZelCombat/settings.yml and set your key:

License-Key: "YOUR-KEY-HERE"

Get your key from the Discord, then run /zelcombat reload or restart.

4. Optional integrations

These plugins are detected automatically if present — none is required:

  • PlaceholderAPI — enables the %zelcombat_...% placeholders.
  • WorldGuard — enables combat region borders (worldguard.region-borders in settings.yml).
  • ViaVersion / ViaBackwards / ViaRewind, ProtocolLib, Geyser — listed as soft-dependencies so they load first and the display barriers behave correctly for cross-version and Bedrock clients.

The database drivers (SQLite / MySQL / HikariCP) and Redis client (Jedis) are downloaded by the server at startup — you don't add any extra jars.

On Folia and Paper forks, ZelCombat schedules work through FoliaLib, so no extra setup is needed.