Celest Combat Xtra

# CelestCombat-Xtra (https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/ptthanh02/CelestCombat) (https://img.shields.io/badge/Paper-1.21--1.21.4-purple.svg)](https://papermc.io/) (https://img.shields.io/badge/Folia-Supported-brightgreen.svg)](https://github.com/PaperMC/Folia) (https://img.shields.io/badge/Discord-Join%20Server-5865F2?logo=discord&logoColor=white)](https://discord.gg/WpYZkrdNVe) A comprehensive combat management plugin for **SwordPvP, CrystalPvP, and competitive Minecraft servers**. Prevents combat logging, blocks escape mechanics, integrates with major protection plugins, and provides advanced item restriction systems—all highly configurable. --- # ⚔️ Combat System * **Combat tagging** – Players who hit or get hit stay in combat for a set duration (e.g. 20 seconds). * **Action bar timer** – Shows remaining combat time in blue text (e.g. *"Combat: 19s"*). * **Command blocking** – Blacklist or whitelist commands during combat (e.g. block `/tpa`, `/home`). * **Admin protection** – Staff kicks/bans don’t trigger combat-log penalties. * **Flight control** – Disable creative flight while tagged. * **Nametag & boss bar** – Optional opponent name and countdown. !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/configurablenametag.png) !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/combattimer.png) --- # 📋 Action Bar Cooldowns All timers appear in one line above the hotbar, separated by vertical bars. * **Combat** – Blue countdown until you can leave combat. * **Ender Pearl** – Red countdown before you can use pearls again. * **Trident** – Light blue countdown for trident throws. * **Wind Charge** – Light blue countdown for wind charges. * **Mace** – Red countdown after mace hits. Items on cooldown also show a **white wipe overlay** on the hotbar so you can see at a glance which items are ready. !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/cooldowns.png) --- # 🚫 Configurable Item Blocking ## Disabled Items (in combat) Add items to `disabled_items` in `config.yml`. While in combat, players **cannot use** these items at all. **Example:** `SUSPICIOUS_STEW`, `ELYTRA`, custom items. Players see a pink action bar message: *"You cannot use while in combat!"* !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/configurableblocking.png) ## Cooldowned Items Add items with cooldowns in `cooldowned_items`. After use, the item is locked for a set time (e.g. 10 seconds for Chorus Fruit). * Action bar shows the countdown (e.g. *"Chorus Fruit: 9s"*). * Physical cooldown overlay on the item in the hotbar. * Applies in combat and/or out of combat (configurable). !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/configurablecooldowns.png) !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/itemcooldown.png) --- # 🛡️ Elytra Combat Rules * **Block glide & fireworks** – No flying or firework boosting while in combat. * **Strike counter** – After repeated tries (e.g. 2 strikes), the plugin acts: * **Unequip** – Elytra is moved to inventory. * **TEMP_BREAK** – If inventory is full, the elytra is broken for 30 seconds and then restored. * **DROP** – If inventory is full, the elytra is dropped at your feet. A crossed-out elytra icon shows when elytra use is blocked. !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/elytra.png) --- # 🔮 Ender Pearl & Trident ### Ender Pearl * Cooldown with action bar timer. * Optional block in combat. * Per-world cooldown control. ### Trident * Cooldown with action bar timer. * Optional block in combat (throw & riptide). * Per-world bans (e.g. no tridents in Nether). --- # 💀 Harming Arrow Control Controls Arrows of Harming from bows and crossbows. * **Block shooting** – Set `bows_allow_harming` or `crossbows_allow_harming` to `false` to stop loading and firing harming arrows. * **Block damage** – Set `no_damage: true` to cancel all harming arrow damage to players (arrows still fire but deal 0 damage). * **Dispensers** – Optional block for dispensers. * **Potions** – Optional block for harming potions (drink, throw, dispense). Players see: *"Harming is disallowed on this server!"* !(https://raw.githubusercontent.com/vanillaxtra/celestcombatxtra/f5cf7afe9d9ee40cfaafe0f16a88a5ace7105c9b/assets/harmingarrows.png) --- # 💥 Explosive Controls Toggle prevention for: | Item | Message