# CelestCombat-Xtra<\/p>\n
\n
\n
\n<\/p>\n
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\u2014all highly configurable.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Minecraft:** 1.21 \u2013 1.21.4
\n– **Server:** Paper, Purpur, or Folia
\n– **Java:** 21+<\/p>\n
### Optional Dependencies<\/p>\n
| Plugin | Purpose |
\n|——–|———|
\n| **PlaceholderAPI** | Placeholders for scoreboards, tab lists, holograms |
\n| **WorldGuard** | Safezone barriers and region protection |
\n| **GriefPrevention** | Claim-edge barriers and claim protection |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the latest release
\n2. Place the `.jar` in your server\u2019s `plugins` folder
\n3. Restart the server
\n4. Edit `plugins\/CelestCombat\/config.yml`
\n5. Reload with `\/celestcombat reload` or `\/ccx reload`<\/p>\n
—<\/p>\n
# \u2694\ufe0f Combat System<\/p>\n
* **Combat tagging** \u2013 Players who hit or get hit stay in combat for a set duration (e.g. 20 seconds).
\n* **Action bar timer** \u2013 Shows remaining combat time in blue text (e.g. *”Combat: 19s”*).
\n* **Command blocking** \u2013 Blacklist or whitelist commands during combat (e.g. block `\/tpa`, `\/home`).
\n* **Admin protection** \u2013 Staff kicks\/bans don\u2019t trigger combat-log penalties.
\n* **Flight control** \u2013 Disable creative flight while tagged.
\n* **Nametag & boss bar** \u2013 Optional opponent name and countdown.<\/p>\n
\n<\/p>\n
—<\/p>\n
# \ud83d\udccb Action Bar Cooldowns<\/p>\n
All timers appear in one line above the hotbar, separated by vertical bars.<\/p>\n
* **Combat** \u2013 Blue countdown until you can leave combat.
\n* **Ender Pearl** \u2013 Red countdown before you can use pearls again.
\n* **Trident** \u2013 Light blue countdown for trident throws.
\n* **Wind Charge** \u2013 Light blue countdown for wind charges.
\n* **Mace** \u2013 Red countdown after mace hits.<\/p>\n
Items on cooldown also show a **white wipe overlay** on the hotbar so you can see at a glance which items are ready.<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83d\udeab Configurable Item Blocking<\/p>\n
## Disabled Items (in combat)<\/p>\n
Add items to `disabled_items` in `config.yml`. While in combat, players **cannot use** these items at all.<\/p>\n
**Example:** `SUSPICIOUS_STEW`, `ELYTRA`, custom items.<\/p>\n
Players see a pink action bar message: *”You cannot use [item] while in combat!”*<\/p>\n
<\/p>\n
## Cooldowned Items<\/p>\n
Add items with cooldowns in `cooldowned_items`. After use, the item is locked for a set time (e.g. 10 seconds for Chorus Fruit).<\/p>\n
* Action bar shows the countdown (e.g. *”Chorus Fruit: 9s”*).
\n* Physical cooldown overlay on the item in the hotbar.
\n* Applies in combat and\/or out of combat (configurable).<\/p>\n
\n<\/p>\n
—<\/p>\n
# \ud83d\udee1\ufe0f Elytra Combat Rules<\/p>\n
* **Block glide & fireworks** \u2013 No flying or firework boosting while in combat.
\n* **Strike counter** \u2013 After repeated tries (e.g. 2 strikes), the plugin acts:
\n * **Unequip** \u2013 Elytra is moved to inventory.
\n * **TEMP_BREAK** \u2013 If inventory is full, the elytra is broken for 30 seconds and then restored.
\n * **DROP** \u2013 If inventory is full, the elytra is dropped at your feet.<\/p>\n
A crossed-out elytra icon shows when elytra use is blocked.<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83d\udd2e Ender Pearl & Trident<\/p>\n
### Ender Pearl
\n* Cooldown with action bar timer.
\n* Optional block in combat.
\n* Per-world cooldown control.<\/p>\n
### Trident
\n* Cooldown with action bar timer.
\n* Optional block in combat (throw & riptide).
\n* Per-world bans (e.g. no tridents in Nether).<\/p>\n
—<\/p>\n
# \ud83d\udc80 Harming Arrow Control<\/p>\n
Controls Arrows of Harming from bows and crossbows.<\/p>\n
* **Block shooting** \u2013 Set `bows_allow_harming` or `crossbows_allow_harming` to `false` to stop loading and firing harming arrows.
\n* **Block damage** \u2013 Set `no_damage: true` to cancel all harming arrow damage to players (arrows still fire but deal 0 damage).
\n* **Dispensers** \u2013 Optional block for dispensers.
\n* **Potions** \u2013 Optional block for harming potions (drink, throw, dispense).<\/p>\n
Players see: *”Harming is disallowed on this server!”*<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83d\udca5 Explosive Controls<\/p>\n
Toggle prevention for:<\/p>\n
| Item | Message |
\n|—————–|—————————————-|
\n| End Crystal | *”End crystals are disabled here.”* |
\n| Respawn Anchor | *”Respawn anchors are disabled here.”*|
\n| Bed (Nether\/End)| *”Beds are disabled in this dimension.”* |
\n| TNT Minecart | *”TNT minecart explosions are disabled.”* |<\/p>\n
All messages appear in pink on the action bar. Use `prevent_placement` \/ `prevent_use` \/ `prevent_explosion` in `config.yml`.<\/p>\n
\n
\n
\n<\/p>\n
—<\/p>\n
# \u2728 Enchant Limiter<\/p>\n
Stops overpowered enchants (e.g. Sharpness 255).<\/p>\n
* **REVERT** \u2013 Clamp to max level (e.g. Sharpness V).
\n* **DELETE** \u2013 Remove the item.
\n* Per-world and bypass permission.
\n* You can see that this max stick gets sharpness reverted.<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83d\udce6 Item Limiter<\/p>\n
Limit how many of each material a player can hold (e.g. max 64 diamonds, 3 netherite ingots, 1 totem).<\/p>\n
* Drop excess or remove.
\n* Per-world control.
\n* Action bar notice when denied.<\/p>\n
—<\/p>\n
# \ud83d\udd12 Regearing Block (Combat)<\/p>\n
While in combat:
\n* **Ender chest** \u2013 Blocked.
\n* **Shulker boxes** \u2013 Blocked.
\n* **Bundles** \u2013 Blocked.<\/p>\n
Chat: *”You cannot access enderchests\/shulkers\/bundles while in combat!”*<\/p>\n
—<\/p>\n
# \ud83d\udee1\ufe0f WorldGuard Safe Zone<\/p>\n
Uses **WorldGuard** to stop players from escaping combat into no-PvP regions.<\/p>\n
* **Red barrier** \u2013 Visual barrier at region borders.
\n* **Push-back** \u2013 Pushes players away from the barrier.
\n* **Chorus fruit** \u2013 Blocks teleporting into safe zones.
\n* Per-world settings.<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83d\udc76 New Player Protection<\/p>\n
Protects new players for a configurable time (e.g. 10 minutes).<\/p>\n
* **PvP protection** \u2013 Can\u2019t be damaged by players.
\n* **Boss bar** \u2013 Green bar with *”PvP Protection: 8m 44s”*.
\n* **Removal** \u2013 Protection ends when they attack another player.
\n* Per-world settings.<\/p>\n
<\/p>\n
—<\/p>\n
# \ud83c\udfc6 Kill Rewards<\/p>\n
Run commands when a player gets a kill. Use in `kill_rewards.commands`:<\/p>\n
| Placeholder | Description |
\n|————-|————-|
\n| `%killer%` | Killer\u2019s name |
\n| `%victim%` | Victim\u2019s name |
\n| `%killer_uuid%` | Killer\u2019s UUID |
\n| `%victim_uuid%` | Victim\u2019s UUID |
\n| `%killer_health%` | Killer\u2019s health when reward runs |
\n| `%victim_health%` | Victim\u2019s health (usually 0) |
\n| `%killer_max_health%` | Killer\u2019s max health |
\n| `%victim_max_health%` | Victim\u2019s max health |
\n| `%world%` | Victim\u2019s world name |
\n| `%x%`, `%y%`, `%z%` | Victim\u2019s block coordinates |<\/p>\n
* Global or per-victim cooldown. Example: `donutcratecore shards give %killer% 10`<\/p>\n
—<\/p>\n
# \ud83d\udd0c Integrations<\/p>\n
## PlaceholderAPI<\/p>\n
| Placeholder | Description |
\n|————-|————-|
\n| `%celestcombat_in_combat%` | `true` or `false` |
\n| `%celestcombat_time_left%` | Remaining combat seconds |
\n| `%celestcombat_opponent%` | Opponent name |
\n| `%celestcombat_opponent_display%` | Opponent display name |
\n| `%celestcombat_pearl_cooldown%` | Pearl cooldown seconds |
\n| `%celestcombat_trident_cooldown%` | Trident cooldown seconds |
\n| `%celestcombat_wind_cooldown%` | Wind charge cooldown seconds |
\n| `%celestcombat_pearl_ready%` | `true` or `false` |
\n| `%celestcombat_trident_ready%` | `true` or `false` |
\n| `%celestcombat_wind_ready%` | `true` or `false` |<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Permission | Description | **Aliases:** `\/ccx`, `\/celestcombat`, `\/combat`<\/p>\n —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## Configuration<\/p>\n Main config: `plugins\/CelestCombat\/config.yml`<\/p>\n Notable sections:<\/p>\n – `combat` \u2013 Duration, command blocking, nametag, boss bar Use `\/celestcombat config` to browse and edit in-game (with permission).<\/p>\n —<\/p>\n ## Discord<\/p>\n <\/p>\n Join for support, updates, and feedback.<\/p>\n —<\/p>\n ## Statistics<\/p>\n This plugin uses bStats to collect anonymous usage statistics (server count, Minecraft version, etc.). This helps prioritize development. You can opt out in the bStats config.<\/p>\n —<\/p>\n ## License<\/p>\n This project is licensed under the CC BY-NC-SA 4.0 License. See [LICENSE](LICENSE) for details.<\/p>\n","protected":false},"excerpt":{"rendered":" A simple plugin that tags players in PvP and kills those who disconnect to prevent combat logging. but a better version with more features<\/p>\n","protected":false},"featured_media":38025,"template":"","meta":{"_minecraft_slug":"celestcombat-xtra","_minecraft_project_id":"4GvKVgg3","_minecraft_author":"not.authorised","_minecraft_license":"CC-BY-NC-SA-4.0","_minecraft_downloads":73,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"celestcombat-xtra.zip","_minecraft_size_bytes":560858,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:27:31.349942Z","_minecraft_date_created":"2026-04-10T19:47:44.879853Z","_minecraft_date_modified":"2026-03-23T00:10:33.347998Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/celestcombat-xtra","_minecraft_icon_attachment_id":38025,"_minecraft_imported_at":"2026-06-01T19:31:40+00:00","_minecraft_import_hash":"ac92d9ae3e395b679dec23ae5aa89777","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-38026","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————|————-|
\n| `\/celestcombat` | `celestcombatxtra.command.use` | Main command (shows help) |
\n| `\/celestcombat help` | `celestcombatxtra.command.use` | Display help |
\n| `\/celestcombat reload` | `celestcombatxtra.command.use` | Reload config and messages |
\n| `\/celestcombat tag
\n| `\/celestcombat removeTag
\n| `\/celestcombat killReward clear [player]` | `celestcombatxtra.command.use` | Clear kill reward cooldowns |
\n| `\/celestcombat newbieProtection add\/remove\/check
\n| `\/celestcombat config` | `celestcombatxtra.command.config` | Browse and edit config in-game |<\/p>\n
\n|————|———|————-|
\n| `celestcombatxtra.command.use` | OP | Use all plugin commands |
\n| `celestcombatxtra.command.config` | OP | Browse and edit config in-game |
\n| `celestcombatxtra.update.notify` | OP | Receive update notifications |
\n| `celestcombatxtra.bypass.tag` | false | Bypass combat tagging (no combat-log punishment) |
\n| `celestcombatxtra.bypass.enchant_limit` | OP | Bypass enchant level limits |
\n| `celestcombatxtra.bypass.item_limit` | OP | Bypass item limiter (per-material caps) |
\n| `celestcombatxtra.bypass.spear_control` | OP | Bypass spear lunge cooldown and damage rules |<\/p>\n
\n– `item_restrictions` \u2013 Disabled items, cooldowned items
\n– `elytra` \u2013 Elytra abuse prevention
\n– `item_limiter` \u2013 Per-material limits, per-world
\n– `enchant_limiter` \u2013 Enchant caps, per-world
\n– `enderpearl`, `trident`, `windcharge`, `mace`, `spear_control`
\n– `kill_rewards` \u2013 Commands and cooldowns
\n– `newbie_protection` \u2013 Duration, display, worlds
\n– `safezone_protection` \u2013 WorldGuard barriers
\n– `claim_protection` \u2013 GriefPrevention integration<\/p>\n