CelestCombat-Xtra
一款功能全面的战斗管理插件,专为 SwordPvP、CrystalPvP 和竞技类 Minecraft 服务器设计。防止战斗登出(Combat Logging),阻止逃脱机制,集成主流保护插件,并提供高级物品限制系统,所有功能均可高度自定义。
⚔️ 战斗系统

- 战斗标记 – 造成伤害或受到伤害的玩家将在指定时长内(例如 20 秒)保持战斗状态。
- 操作栏计时器 – 以蓝色文字显示剩余战斗时间(例如 "Combat: 19s")。
- 命令拦截 – 在战斗期间黑名单或白名单某些命令(例如禁止
/tpa、/home)。
- 管理员保护 – 员工踢出或封禁玩家不会触发战斗登出惩罚。
- 飞行控制 – 被标记为战斗状态时禁用创造模式飞行。
- 名字标签与 Boss 条 – 可选的对手名称显示和倒计时。
? 操作栏冷却时间

所有计时器显示在快捷栏上方的一行中,由竖线分隔。
- 战斗 (Combat) – 蓝色倒计时,直到你可以退出战斗状态。
- 末影珍珠 (Ender Pearl) – 红色倒计时,直到你可以再次使用珍珠。
- 三叉戟 (Trident) – 浅蓝色倒计时,用于三叉戟投掷。
- 旋风棒 (Wind Charge) – 浅蓝色倒计时,用于旋风棒。
- 重锤 (Mace) – 红色倒计时,用于重锤攻击后。
处于冷却状态的物品也会在快捷栏上显示白色覆盖层,让你一目了然地查看哪些物品已就绪。
? 可配置的拦截物品
禁用物品(战斗中)
在 config.yml 的 disabled_items 中添加物品。在战斗状态下,玩家完全无法使用这些物品。
示例: SUSPICIOUS_STEW、ELYTRA、自定义物品。
玩家会看到粉色的操作栏消息:"You cannot use [item] while in combat!"

带冷却时间的物品
在 cooldowned_items 中添加带有冷却时间的物品。使用后,该物品将被锁定指定时间(例如紫颂果为 10 秒)。
- 操作栏显示倒计时(例如 "Chorus Fruit: 9s")。
- 快捷栏中的物品物理冷却覆盖层。
- 适用于战斗中和/或战斗外(可配置)。

?️ 鞘翅战斗规则
- 禁止滑翔与烟花 – 在战斗状态下禁止飞行或使用烟花加速。
- 反击计数 – 在多次尝试后(例如 2 次),插件将采取以下行动:
- 卸下装备 (Unequip) – 将鞘翅移入背包。
- 临时破坏 (TEMP_BREAK) – 如果背包已满,鞘翅将被破坏 30 秒然后恢复。
- 掉落 (DROP) – 如果背包已满,鞘翅将掉落在你脚下。
当鞘翅使用被禁止时,会显示一个划掉的鞘翅图标。

? 末影珍珠与三叉戟
末影珍珠
- 带有操作栏计时器的冷却时间。
- 可选的战斗中禁止使用。
- 按世界控制的冷却时间。
三叉戟
- 带有操作栏计时器的冷却时间。
- 可选的战斗中禁止使用(投掷与激流)。
- 按世界禁止(例如在下界禁止使用三叉戟)。
? 伤害箭矢控制
控制来自弓和弩的伤害箭矢。
- 禁止射击 – 将
bows_allow_harming 或 crossbows_allow_harming 设置为 false 以停止加载和发射伤害箭矢。
- 禁止伤害 – 将
no_damage: true 以取消对所有玩家造成的伤害箭矢伤害(箭矢仍然发射但造成 0 点伤害)。
- 发射器 – 可选的禁止发射器使用。
- 药水 – 可选的禁止伤害药水(饮用、投掷、发射)。
玩家会看到:"Harming is disallowed on this server!"

? 爆炸控制
切换以下内容的预防措施:
| Item |
Message |
| End Crystal |
"End crystals are disabled here." |
| Respawn Anchor |
"Respawn anchors are disabled here." |
| Bed (Nether/End) |
"Beds are disabled in this dimension." |
| TNT Minecart |
"TNT minecart explosions are disabled." |
所有消息以粉色显示在操作栏上。在 config.yml 中使用 prevent_placement / prevent_use / prevent_explosion。




✨ 附魔限制器
阻止过于强大的附魔(例如锋利 V 255)。
- 还原 – 将等级钳制到最大值(例如锋利 V)。
- 删除 – 移除该物品。
- 支持按世界设置及权限绕过。
- 你可以看到这根棍子的锋利附魔已被还原。

? 物品限制器
限制玩家每种材料持有的数量上限(例如最多 64 颗钻石、3 下界合金锭、1 个图腾)。
- 丢弃多余物品或移除。
- 支持按世界控制。
- 拒绝时会在动作栏显示提示。
? 重新装填阻挡(战斗)
在战斗中:
- 末影箱 – 被阻挡。
- 潜影盒 – 被阻挡。
- 包裹 – 被阻挡。
聊天消息:"You cannot access enderchests/shulkers/bundles while in combat!"
?️ WorldGuard 安全区
使用 WorldGuard 阻止玩家逃入无 PvP 区域以躲避战斗。
- 红色屏障 – 区域边界处的视觉屏障。
- 击退 – 将玩家推开远离屏障。
- 紫颂果 – 阻止传送至安全区。
- 支持按世界设置。

? 新玩家保护
为新玩家提供可配置时间的保护(例如 10 分钟)。
- PvP 保护 – 不会受到其他玩家的伤害。
- Boss 条 – 绿色进度条,显示 "PvP Protection: 8m 44s"。
- 解除 – 当他们攻击其他玩家时,保护结束。
- 支持按世界设置。

? 击杀奖励
当玩家获得击杀时执行命令。在 kill_rewards.commands 中使用:
| 占位符 |
描述 |
%killer% |
击杀者名称 |
%victim% |
受害者名称 |
%killer_uuid% |
击杀者的 UUID |
%victim_uuid% |
受害者的 UUID |
%killer_health% |
执行奖励时击杀者的生命值 |
%victim_health% |
受害者的生命值(通常为 0) |
%killer_max_health% |
击杀者的最大生命值 |
%victim_max_health% |
受害者的最大生命值 |
%world% |
受害者所在的世界名称 |
%x%, %y%, %z% |
受害者的方块坐标 |
- 全局或针对每个受害者的冷却时间。示例:
donutcratecore shards give %killer% 10
? 集成
PlaceholderAPI
| 占位符 |
描述 |
%celestcombat_in_combat% |
true 或 false |
%celestcombat_time_left% |
剩余战斗秒数 |
%celestcombat_opponent% |
对手名称 |
%celestcombat_opponent_display% |
对手显示名称 |
%celestcombat_pearl_cooldown% |
珍珠冷却秒数 |
%celestcombat_trident_cooldown% |
三叉戟冷却秒数 |
%celestcombat_wind_cooldown% |
风之弹冷却秒数 |
%celestcombat_pearl_ready% |
true 或 false |
%celestcombat_trident_ready% |
true 或 false |
%celestcombat_wind_ready% |
true 或 false |
命令
| 命令 |
权限 |
描述 |
/celestcombat |
celestcombatxtra.command.use |
主命令(显示帮助) |
/celestcombat help |
celestcombatxtra.command.use |
显示帮助信息 |
/celestcombat reload |
celestcombatxtra.command.use |
重载配置和消息文件 |
/celestcombat tag <player1> [player2] |
celestcombatxtra.command.use |
手动标记玩家进入战斗状态 |
/celestcombat removeTag <player|world|all> |
celestcombatxtra.command.use |
移除战斗标记 |
/celestcombat killReward clear [player] |
celestcombatxtra.command.use |
清除击杀奖励冷却时间 |
/celestcombat newbieProtection add/remove/check <player> |
celestcombatxtra.command.use |
管理新手保护状态 |
/celestcombat config |
celestcombatxtra.command.config |
在游戏中浏览和编辑配置 |
别名: /ccx, /celestcombat, /combat
权限
| 权限 |
默认值 |
描述 |
celestcombatxtra.command.use |
OP |
使用所有插件命令 |
celestcombatxtra.command.config |
OP |
在游戏中浏览和编辑配置 |
celestcombatxtra.update.notify |
OP |
接收更新通知 |
celestcombatxtra.bypass.tag |
false |
绕过战斗标记(无掉线惩罚) |
celestcombatxtra.bypass.enchant_limit |
OP |
绕过附魔等级限制 |
celestcombatxtra.bypass.item_limit |
OP |
绕过物品限制器(按材料上限) |
celestcombatxtra.bypass.spear_control |
OP |
绕过长矛冲刺冷却和伤害规则 |
配置
主配置文件:plugins/CelestCombat/config.yml
主要部分:
combat – 持续时间、命令阻挡、名称标签、Boss 条
item_restrictions – 禁用的物品、有冷却时间的物品
elytra – 鞘翅滥用预防
item_limiter – 按材料的限制、按世界设置
enchant_limiter – 附魔上限、按世界设置
enderpearl, trident, windcharge, mace, spear_control
kill_rewards – 命令和冷却时间
newbie_protection – 持续时间、显示方式、世界
safezone_protection – WorldGuard 屏障
claim_protection – GriefPrevention 集成
使用 /celestcombat config 可在游戏中浏览和编辑配置(需相应权限)。
Discord
加入 Discord 服务器以获取支持、更新和反馈。
统计信息
许可证
本项目遵循 CC BY-NC-SA 4.0 许可证。详见 LICENSE。
要求
- Minecraft: 1.21 – 1.21.4
- 服务端: Paper、Purpur 或 Folia
- Java: 21+
可选依赖
| 插件 |
用途 |
| PlaceholderAPI |
计分板、标签页列表、全息图的占位符 |
| WorldGuard |
安全区屏障与区域保护 |
| GriefPrevention |
领地边缘屏障与领地保护 |
安装
- 下载最新版本
- 将
.jar 文件放入服务端的 plugins 文件夹中
- 重启服务器
- 编辑
plugins/CelestCombat/config.yml
- 使用
/celestcombat reload 或 /ccx reload 命令重载配置
CelestCombat-Xtra
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.
? 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.
? 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 [item] while in combat!"

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).

?️ 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.

? 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!"

? Explosive Controls
Toggle prevention for:
| Item |
Message |
| End Crystal |
"End crystals are disabled here." |
| Respawn Anchor |
"Respawn anchors are disabled here." |
| Bed (Nether/End) |
"Beds are disabled in this dimension." |
| TNT Minecart |
"TNT minecart explosions are disabled." |
All messages appear in pink on the action bar. Use prevent_placement / prevent_use / prevent_explosion in config.yml.




✨ Enchant Limiter
Stops overpowered enchants (e.g. Sharpness 255).
- REVERT – Clamp to max level (e.g. Sharpness V).
- DELETE – Remove the item.
- Per-world and bypass permission.
- You can see that this max stick gets sharpness reverted.

? Item Limiter
Limit how many of each material a player can hold (e.g. max 64 diamonds, 3 netherite ingots, 1 totem).
- Drop excess or remove.
- Per-world control.
- Action bar notice when denied.
? Regearing Block (Combat)
While in combat:
- Ender chest – Blocked.
- Shulker boxes – Blocked.
- Bundles – Blocked.
Chat: "You cannot access enderchests/shulkers/bundles while in combat!"
?️ WorldGuard Safe Zone
Uses WorldGuard to stop players from escaping combat into no-PvP regions.
- Red barrier – Visual barrier at region borders.
- Push-back – Pushes players away from the barrier.
- Chorus fruit – Blocks teleporting into safe zones.
- Per-world settings.

? New Player Protection
Protects new players for a configurable time (e.g. 10 minutes).
- PvP protection – Can’t be damaged by players.
- Boss bar – Green bar with "PvP Protection: 8m 44s".
- Removal – Protection ends when they attack another player.
- Per-world settings.

? Kill Rewards
Run commands when a player gets a kill. Use in kill_rewards.commands:
| Placeholder |
Description |
%killer% |
Killer’s name |
%victim% |
Victim’s name |
%killer_uuid% |
Killer’s UUID |
%victim_uuid% |
Victim’s UUID |
%killer_health% |
Killer’s health when reward runs |
%victim_health% |
Victim’s health (usually 0) |
%killer_max_health% |
Killer’s max health |
%victim_max_health% |
Victim’s max health |
%world% |
Victim’s world name |
%x%, %y%, %z% |
Victim’s block coordinates |
- Global or per-victim cooldown. Example:
donutcratecore shards give %killer% 10
? Integrations
PlaceholderAPI
| Placeholder |
Description |
%celestcombat_in_combat% |
true or false |
%celestcombat_time_left% |
Remaining combat seconds |
%celestcombat_opponent% |
Opponent name |
%celestcombat_opponent_display% |
Opponent display name |
%celestcombat_pearl_cooldown% |
Pearl cooldown seconds |
%celestcombat_trident_cooldown% |
Trident cooldown seconds |
%celestcombat_wind_cooldown% |
Wind charge cooldown seconds |
%celestcombat_pearl_ready% |
true or false |
%celestcombat_trident_ready% |
true or false |
%celestcombat_wind_ready% |
true or false |
Commands
| Command |
Permission |
Description |
/celestcombat |
celestcombatxtra.command.use |
Main command (shows help) |
/celestcombat help |
celestcombatxtra.command.use |
Display help |
/celestcombat reload |
celestcombatxtra.command.use |
Reload config and messages |
/celestcombat tag <player1> [player2] |
celestcombatxtra.command.use |
Manually tag players in combat |
/celestcombat removeTag <player|world|all> |
celestcombatxtra.command.use |
Remove combat tags |
/celestcombat killReward clear [player] |
celestcombatxtra.command.use |
Clear kill reward cooldowns |
/celestcombat newbieProtection add/remove/check <player> |
celestcombatxtra.command.use |
Manage newbie protection |
/celestcombat config |
celestcombatxtra.command.config |
Browse and edit config in-game |
Aliases: /ccx, /celestcombat, /combat
Permissions
| Permission |
Default |
Description |
celestcombatxtra.command.use |
OP |
Use all plugin commands |
celestcombatxtra.command.config |
OP |
Browse and edit config in-game |
celestcombatxtra.update.notify |
OP |
Receive update notifications |
celestcombatxtra.bypass.tag |
false |
Bypass combat tagging (no combat-log punishment) |
celestcombatxtra.bypass.enchant_limit |
OP |
Bypass enchant level limits |
celestcombatxtra.bypass.item_limit |
OP |
Bypass item limiter (per-material caps) |
celestcombatxtra.bypass.spear_control |
OP |
Bypass spear lunge cooldown and damage rules |
Configuration
Main config: plugins/CelestCombat/config.yml
Notable sections:
combat – Duration, command blocking, nametag, boss bar
item_restrictions – Disabled items, cooldowned items
elytra – Elytra abuse prevention
item_limiter – Per-material limits, per-world
enchant_limiter – Enchant caps, per-world
enderpearl, trident, windcharge, mace, spear_control
kill_rewards – Commands and cooldowns
newbie_protection – Duration, display, worlds
safezone_protection – WorldGuard barriers
claim_protection – GriefPrevention integration
Use /celestcombat config to browse and edit in-game (with permission).
Discord
Join for support, updates, and feedback.
Statistics
License
This project is licensed under the CC BY-NC-SA 4.0 License. See LICENSE for details.
Requirements
- Minecraft: 1.21 – 1.21.4
- Server: Paper, Purpur, or Folia
- Java: 21+
Optional Dependencies
| Plugin |
Purpose |
| PlaceholderAPI |
Placeholders for scoreboards, tab lists, holograms |
| WorldGuard |
Safezone barriers and region protection |
| GriefPrevention |
Claim-edge barriers and claim protection |
Installation
- Download the latest release
- Place the
.jar in your server’s plugins folder
- Restart the server
- Edit
plugins/CelestCombat/config.yml
- Reload with
/celestcombat reload or /ccx reload
评论 0
登录后参与评分
还没有评论,来抢沙发吧