Skip to content

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

General

KeyDefaultWhat 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-time15How long combat lasts, in seconds.
kill-on-leavetrueKill players who log out while tagged.
tag-for-tnt-damagetrueWhether TNT damage tags players.
death-messagestrueShow ZelCombat death messages. Disable if another plugin handles them.
blacklisted-worlds[test1, test2]Worlds where combat tagging is off.
disable-bypass-permissionfalseSet true to ignore the zelcombat.bypass permission.
kill-recapfalseSend the killer a recap (victim's health, item, armor, potions).
newbie-protectiontrueEnable newbie protection for new players.
newbie-protection-time60Newbie protection duration, in seconds.
whitelisted-commands[msg, shop]Commands players may still run while tagged.

PvP toggle

KeyDefaultWhat it does
allow-pvp-toggletrueLet players turn their own PvP off. Set false to force PvP on for everyone (saved choices are kept for later).
toggle-cooldowns.pvp5Cooldown (seconds) on the PvP toggle. 0 disables it.
toggle-cooldowns.death-messages5Cooldown (seconds) on the death-message toggle. 0 disables it.

Players without the zelcombat.togglepvp permission 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

KeyDefaultWhat it does
statstrueTrack kills, deaths, K/D and streaks. Powers the stats commands and placeholders.
leaderboard-size10How many players the leaderboard and top_ placeholders show.
leaderboard-refresh-seconds60How 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.

Commandname defaultaliases default
Adminzelcombatcombat
Toggle death messagestoggledeathmsgs—
Toggle PvPtogglepvp—
Newbie protectionnewbieprotection—
Combat tag checktagct, combattag
PvP statspvpstatsstats
PvP toppvptoppvpleaderboard

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.

KeyDefaultWhat it does
region-bordersfalseMaster switch for the feature.
border-modePHYSICALPHYSICAL = a visible fake wall of border-material. DISPLAY = invisible barrier with animated red panels (1.20.2+, falls back to PHYSICAL).
border-materialGLASSBlock the PHYSICAL wall is made of (any Bukkit material).
display-panel-scale0.94Panel size per block cell in DISPLAY mode (0.90–0.98 leaves a seam).
display-animation-ticks6Grow-in animation length for DISPLAY panels. 0 = instant.
border-radius3Blocks scanned around the player for region edges. Higher = smoother, more work (3–15).
invisible-border-knockback1.5Knockback when crossing the border. 0 = hard stop, no launch.
play-effecttrueParticle effect on pushback.
blocktype-checktrueOnly 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

KeyDefaultWhat it does
block-glidingtrueStop elytra gliding in combat (unequips on glide spam).
block-fireworkstrueStop firework rockets while gliding in combat.
firework-power-limit-1Max rocket power while gliding in combat (-1 = no limit, 1–3 = cap).
firework-cooldown2Seconds between rockets while gliding in combat (-1 = off).

Blocking FIREWORK_ROCKET in blocker.yml stops all rockets in combat; the power limit and cooldown only apply when both that and block-fireworks are off.

database

KeyDefaultWhat it does
typeSQLITESQLITE (local stats.db file) or MYSQL (shared server).
cross-serverfalseShare stats and toggles across every server on the same MySQL database. Forces MySQL on.
mysql.hostlocalhostMySQL host.
mysql.port3306MySQL port.
mysql.databasezelcombatDatabase name.
mysql.usernamerootUsername.
mysql.passwordpasswordPassword.
mysql.use-sslfalseUse SSL for the connection.
mysql.max-pool10HikariCP pool size.
write-retries4Attempts for immediate cross-server writes.
retry-delay-ms100Initial 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.

KeyDefault
enabledtrue
hostlocalhost
port6379
username / password""
database0
sslfalse
key-prefixzelcombat
pool-size8
connection-timeout-ms3000
handoff-timeout-ms10000
presence-ttl-seconds20
reconcile-seconds30

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.