ZelCombat
Configuration
ZelCombat generates four files in plugins/ZelCombat/. After editing any of them, run /zelcombat reload (command names and aliases are the only settings that need a full restart).
settings.yml— core behaviourblocker.yml— items blocked in combatcooldowns.yml— per-item cooldownsmessages.yml— all messages
settings.yml
General
| Key | Default | What it does |
|---|---|---|
License-Key | — | Your ZelCombat license key. |
prefix | #FF0000ZelCombat &8| | Prefix on every plugin message. Supports & codes and #RRGGBB hex. Leave empty for none. |
combat-time | 15 | How long combat lasts, in seconds. |
kill-on-leave | true | Kill players who log out while tagged. |
tag-for-tnt-damage | true | Whether TNT damage tags players. |
death-messages | true | Show ZelCombat death messages. Disable if another plugin handles them. |
blacklisted-worlds | [test1, test2] | Worlds where combat tagging is off. |
disable-bypass-permission | false | Set true to ignore the zelcombat.bypass permission. |
kill-recap | false | Send the killer a recap (victim's health, item, armor, potions). |
newbie-protection | true | Enable newbie protection for new players. |
newbie-protection-time | 60 | Newbie protection duration, in seconds. |
whitelisted-commands | [msg, shop] | Commands players may still run while tagged. |
PvP toggle
| Key | Default | What it does |
|---|---|---|
allow-pvp-toggle | true | Let players turn their own PvP off. Set false to force PvP on for everyone (saved choices are kept for later). |
toggle-cooldowns.pvp | 5 | Cooldown (seconds) on the PvP toggle. 0 disables it. |
toggle-cooldowns.death-messages | 5 | Cooldown (seconds) on the death-message toggle. 0 disables it. |
Players without the
zelcombat.togglepvppermission always have PvP on.
Banned potions
banned-potions:
- INVISIBILITY
Effects listed here are blocked server-wide — from drinking, splash potions and tipped arrows. Use Bukkit effect names (INVISIBILITY, SPEED, NIGHT_VISION, …). Players with zelcombat.potion.bypass can still receive them on themselves. You can also edit this list in-game with /zelcombat banpotion add|remove|list.
Stats & leaderboards
| Key | Default | What it does |
|---|---|---|
stats | true | Track kills, deaths, K/D and streaks. Powers the stats commands and placeholders. |
leaderboard-size | 10 | How many players the leaderboard and top_ placeholders show. |
leaderboard-refresh-seconds | 60 | How often cached leaderboards refresh and online stats flush to the database. |
commands
Rename commands and set aliases here. Changes require a server restart. Names may use lowercase letters, numbers, underscores and hyphens.
| Command | name default | aliases default |
|---|---|---|
| Admin | zelcombat | combat |
| Toggle death messages | toggledeathmsgs | — |
| Toggle PvP | togglepvp | — |
| Newbie protection | newbieprotection | — |
| Combat tag check | tag | ct, combattag |
| PvP stats | pvpstats | stats |
| PvP top | pvptop | pvpleaderboard |
worldguard (region borders)
Requires the WorldGuard plugin. While tagged, players can't enter a region whose pvp flag is set to deny; a client-side wall blocks them and their position is corrected server-side, so it holds even against clients that ignore the fake wall. It never modifies real blocks.
| Key | Default | What it does |
|---|---|---|
region-borders | false | Master switch for the feature. |
border-mode | PHYSICAL | PHYSICAL = a visible fake wall of border-material. DISPLAY = invisible barrier with animated red panels (1.20.2+, falls back to PHYSICAL). |
border-material | GLASS | Block the PHYSICAL wall is made of (any Bukkit material). |
display-panel-scale | 0.94 | Panel size per block cell in DISPLAY mode (0.90–0.98 leaves a seam). |
display-animation-ticks | 6 | Grow-in animation length for DISPLAY panels. 0 = instant. |
border-radius | 3 | Blocks scanned around the player for region edges. Higher = smoother, more work (3–15). |
invisible-border-knockback | 1.5 | Knockback when crossing the border. 0 = hard stop, no launch. |
play-effect | true | Particle effect on pushback. |
blocktype-check | true | Only replace replaceable blocks (air, water, grass…) so the wall doesn't cover real terrain. |
Quick setup: define your safe zone with WorldEdit + /rg define spawn, run /rg flag spawn pvp deny, then set region-borders: true. Mark PvP arenas with /rg flag arena pvp allow, and use /rg setpriority <region> <n> for overlaps.
elytra
| Key | Default | What it does |
|---|---|---|
block-gliding | true | Stop elytra gliding in combat (unequips on glide spam). |
block-fireworks | true | Stop firework rockets while gliding in combat. |
firework-power-limit | -1 | Max rocket power while gliding in combat (-1 = no limit, 1–3 = cap). |
firework-cooldown | 2 | Seconds between rockets while gliding in combat (-1 = off). |
Blocking
FIREWORK_ROCKETinblocker.ymlstops all rockets in combat; the power limit and cooldown only apply when both that andblock-fireworksare off.
database
| Key | Default | What it does |
|---|---|---|
type | SQLITE | SQLITE (local stats.db file) or MYSQL (shared server). |
cross-server | false | Share stats and toggles across every server on the same MySQL database. Forces MySQL on. |
mysql.host | localhost | MySQL host. |
mysql.port | 3306 | MySQL port. |
mysql.database | zelcombat | Database name. |
mysql.username | root | Username. |
mysql.password | password | Password. |
mysql.use-ssl | false | Use SSL for the connection. |
mysql.max-pool | 10 | HikariCP pool size. |
write-retries | 4 | Attempts for immediate cross-server writes. |
retry-delay-ms | 100 | Initial retry delay (doubles each failed attempt). |
Combat tagging, newbie protection and toggle cooldowns always stay per-server. Only stats and saved toggle choices sync.
redis
Used only when database.cross-server is enabled — it coordinates player handoffs between servers and broadcasts committed MySQL updates. Every server must point at the same Redis database.
| Key | Default |
|---|---|
enabled | true |
host | localhost |
port | 6379 |
username / password | "" |
database | 0 |
ssl | false |
key-prefix | zelcombat |
pool-size | 8 |
connection-timeout-ms | 3000 |
handoff-timeout-ms | 10000 |
presence-ttl-seconds | 20 |
reconcile-seconds | 30 |
blocker.yml
Each entry under blocked: turns item use on or off while a player is in combat. All default to true.
blocked:
MACE: true
ELYTRA: true
SPEAR: true
FISHING_ROD: true
WIND_CHARGE: true
ENDER_PEARL: true
FIREWORK_ROCKET: true
BOW: true
CROSSBOW: true
END_CRYSTAL: true
RESPAWN_ANCHOR: true
GOLDEN_APPLE: true
ENCHANTED_GOLDEN_APPLE: true
Set any to false to allow that item in combat.
cooldowns.yml
Per-item cooldowns in seconds. 0 disables an item's cooldown.
cooldowns:
GOLDEN_APPLE: 10
ENCHANTED_GOLDEN_APPLE: 30
ENDER_PEARL: 15
TRIDENT: 8
MACE: 5
WIND_CHARGE: 10
BOW: 5
CROSSBOW: 5
FIREWORK_ROCKET: 3
SPEAR: 5
messages.yml
Every message ZelCombat sends lives here. You can use & color codes and #RRGGBB hex, and set a message to DISABLED to silence it. This includes the combat-tag notice, the item/command block messages, the kill recap layout (kill-recap), and the death messages — death-message for player kills and death-messages for each death type, including combat-log for kill-on-leave.