CelestCombat Pro
CelestCombat Pro 是一款高度优化、功能丰富且符合企业级标准的 Minecraft 服务器战斗管理插件,专为 PvP 环境设计。完全兼容 Paper、Purpur 和 Folia,它在不牺牲服务器性能的前提下,提供全面的防战斗退出(combat logging)防止机制、力场保护、反故障系统、新手保护以及击杀奖励。
鸣谢原作者:

? 目录
? 核心功能
⚔️ 战斗标记与防退出系统
- 自动标记: 当玩家造成伤害或受到伤害时,自动将其标记为处于战斗中。
- 战斗飞行控制: 进入战斗状态后立即禁用飞行和鞘翅使用,防止玩家逃跑。
- 命令拦截: 阻止玩家通过传送或实用命令逃避 PvP。支持黑名单和白名单命令模式。
- 战斗登出惩罚: 杀死在战斗中登出的玩家,掉落其物品,执行自定义服务器命令(如全服聊天公告),并奖励攻击者。
- 管理员豁免操作: 可选地在执行管理员踢出操作时绕过战斗标记,以防止错误的登出惩罚。
?️ 力场边界与区域保护
- WorldGuard 安全区: 被标记的玩家试图进入 WorldGuard 安全区时会被施加可定制强度的推力反弹。具备精美的染色玻璃力场可视化效果(默认:
RED_STAINED_GLASS)。 - GriefPrevention 领地: 将战斗参与者推出活跃的 GriefPrevention 领地,防止战斗中的“领地跳跃”。渲染独特的视觉边界(默认:
BLUE_STAINED_GLASS)。 - UXM 领地: 对 UXM 领地内的玩家进入、战斗、物品限制(末影珍珠、珍珠、不死图腾)和命令拦截进行全面控制。支持为管理员、玩家和公共领地设置独立的规则配置文件。
? 末影珍珠与三叉戟机制
- 末影珍珠故障预防: 采用高级物理检查,防止玩家卡在方块中、进行微传送、穿过门/闸门,以及卡墙或通过狭窄空间等故障行为。
- 珍珠与三叉戟冷却: 强制执行自定义冷却时间(全局或仅限战斗),并支持按世界切换开关。
- 战斗刷新: 可选择在末影珍珠或三叉戟落地时刷新/重置战斗计时器。
- 三叉戟限制: 可选择在配置的世界(例如下界)中完全禁止使用三叉戟。
? 玩家进度与奖励
- 新手保护: 为新玩家提供临时的 PvP 和怪物伤害保护。具备可定制的血条/动作栏倒计时显示,如果他们对他人造成伤害则提前移除保护。
- 击杀奖励: 在玩家击杀其他玩家时触发自定义命令(例如给予钥匙/货币),并设有全局和同玩家重复击杀的冷却时间,以防止利用漏洞刷取奖励。
- 死亡动画: 当玩家死亡时播放令人震撼的视觉效果(闪电打击和火焰粒子)。
? 要求与安装
要求
- Minecraft 版本: 1.21 - 26.X
- 服务器软件: Paper, Purpur, Folia
- Java 版本: Java 21+
安装
- 从 Modrinth 下载最新版本。
- 将
.jar文件放入服务器的plugins文件夹中。 - 重启服务器。
- 在
plugins/CelestCombat/config.yml中配置设置,并在plugins/CelestCombat/language/中配置语言文件。 - 使用
/cc reload重新加载配置。
? 命令与权限
命令
| 命令 | 别名 | 权限 | 描述 |
|---|---|---|---|
/cc help |
/combat, /celestcombat |
celestcombat.command.use |
显示命令帮助菜单 |
/cc reload |
/combat, /celestcombat |
celestcombat.command.use |
重新加载配置、消息和动态事件优先级 |
/cc tag <player1> [player2] |
/combat, /celestcombat |
celestcombat.command.use |
手动将玩家标记为处于战斗中 |
/cc removetag <player/world/all> |
/combat, /celestcombat |
celestcombat.command.use |
立即移除战斗标记 |
权限
| 权限 | 默认值 | 描述 |
|---|---|---|
celestcombat.command.use |
OP | 访问所有插件命令 |
celestcombat.update.notify |
OP | 登录时接收更新通知 |
celestcombat.bypass.tag |
false | 完全绕过战斗标记 |
⚙️ 快速入门配置指南
以下是 config.yml 中关键部分的分解,以帮助您自定义插件。
调整事件优先级
如果其他插件覆盖了命令阻止或伤害处理,请调整监听器优先级:
event_priorities:
command_blocking: "LOW" # 选项:LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR
combat_damage: "HIGH"
teleportation: "HIGH"
配置战斗惩罚
设置当玩家在 PvP 交战期间登出时会发生什么:
combat:
duration: 20s
combat_logout:
enabled: true
kill_player: true
reward_attacker: true
punishment_commands:
- "broadcast &c%player% &7logged out during combat!"
attacker_reward_commands:
- "broadcast &a%player% &7killed &c%victim% &7(Combat Logout)"
力场与安全区
调整力场的视觉效果和击退力度:
safezone_protection:
enabled: true
barrier_material: "RED_STAINED_GLASS"
barrier_detection_radius: 5
push_back_force: 0.6
?️ 开发者 API
CelestCombat Pro 提供了强大的 API,供外部插件集成其战斗系统。
访问 API
确保导入 com.shyamstudio.celestCombatPro.api.CelestCombatAPI 并挂钩到其中:
import com.shyamstudio.celestCombatPro.api.CelestCombatAPI;
import com.shyamstudio.celestCombatPro.api.CombatAPI;
import org.bukkit.entity.Player;
public class MyPluginIntegration {
public void checkPlayerCombat(Player player) {
CombatAPI api = CelestCombatAPI.getCombatAPI();
if (api != null && api.isInCombat(player)) {
player.sendMessage("You are currently in combat!");
// 获取剩余的战斗时间
int secondsLeft = api.getRemainingCombatTime(player);
// 获取当前的对手
Player opponent = api.getCombatOpponent(player);
}
}
}
? 构建
要在本地构建 CelestCombat Pro:
git clone https://github.com/ShyamStudios/CelestCombat-Pro.git
cd CelestCombat-Pro
./gradlew build
编译后的 JAR 文件将保存在 build/libs/ 中。
? 贡献与支持
- 问题与错误报告: GitHub Issues
- Discord 社区: 加入我们的 Discord
? 统计数据
? 许可证
本项目根据 CC BY-NC-SA 4.0 许可证进行许可 - 有关详细信息,请参阅 文件。
CelestCombat Pro
CelestCombat Pro is a highly optimized, feature-rich, and enterprise-grade combat management plugin for Minecraft servers specializing in PvP environments. Fully compatible with Paper, Purpur, and Folia, it provides comprehensive combat logging prevention, forcefields, anti-glitch systems, newbie protections, and kill rewards without sacrificing server performance.
Crediting original:

? Table of Contents
- ? Core Features
- ? Requirements & Installation
- ? Commands & Permissions
- ⚙️ Quick-Start Configuration Guide
- ?️ Developer API
- ? Contributing & Support
- ? License
? Core Features
⚔️ Combat Tagging & Anti-Log System
- Auto-Tagging: Automatically tags players in combat when they deal or receive damage.
- Combat Flight Control: Disables flight and Elytra usage immediately upon entering combat to prevent players from fleeing.
- Command Blocking: Prevent players from escaping PvP using teleportation or utility commands. Supports both blacklist and whitelist command modes.
- Combat Logout Punishment: Kills players who log out during combat, drops their items, executes custom server commands (like global chat announcements), and awards attacker rewards.
- Exempt Admin Actions: Optionally bypasses combat tagging during administrative kicks to prevent false logging punishments.
?️ Forcefield Border & Area Protection
- WorldGuard Safezones: Tagged players are pushed back with customizable force when they attempt to enter WorldGuard safe zones. Features a beautiful stained-glass forcefield visualizer (default:
RED_STAINED_GLASS). - GriefPrevention Claims: Pushes combatants out of active GriefPrevention claims to prevent "claim-hopping" during fights. Renders a distinct visual boundary (default:
BLUE_STAINED_GLASS). - UXM Claims: Comprehensive control over player entry, combat, item restrictions (Chorus Fruit, Pearls, Totems), and command blocking inside UXM claims. Supports separate rule profiles for Admin, Player, and Public claims.
? Ender Pearl & Trident Mechanics
- Ender Pearl Glitch Prevention: Employs advanced physics checks to prevent players from getting stuck in blocks, doing micro-teleports, passing through doors/gates, and glitching through walls or tight spaces.
- Pearl & Trident Cooldowns: Enforces custom cooldown timers (global or combat-only) with world-specific toggles.
- Combat Refresh: Option to refresh/renew the combat timer when an Ender Pearl or Trident lands.
- Trident Restrictions: Option to ban trident usage entirely in configured worlds (e.g., Nether).
? Player Progression & Rewards
- Newbie Protection: Grants temporary PvP and mob damage protection to new players. Features customizable bossbar/actionbar countdown displays and removes protection early if they deal damage to others.
- Kill Rewards: Triggers custom commands (e.g., giving keys/currencies) upon player kills with global and same-player farming cooldowns to prevent exploitation.
- Death Animations: Plays stunning visual effects (lightning strikes and fire particles) when players die.
? Requirements & Installation
Requirements
- Minecraft Version: 1.21 - 26.X
- Server Software: Paper, Purpur, Folia
- Java Version: Java 21+
Installation
- Download the latest release from Modrinth.
- Place the
.jarfile in your server'spluginsfolder. - Restart your server.
- Configure the settings in
plugins/CelestCombat/config.ymland language files inplugins/CelestCombat/language/. - Reload the configuration with
/cc reload.
? Commands & Permissions
Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/cc help |
/combat, /celestcombat |
celestcombat.command.use |
Displays command help menu |
/cc reload |
/combat, /celestcombat |
celestcombat.command.use |
Reloads configs, messages, and dynamic event priorities |
/cc tag <player1> [player2] |
/combat, /celestcombat |
celestcombat.command.use |
Manually tags player(s) in combat |
/cc removetag <player/world/all> |
/combat, /celestcombat |
celestcombat.command.use |
Instantly removes combat tag(s) |
Permissions
| Permission | Default | Description |
|---|---|---|
celestcombat.command.use |
OP | Access to all plugin commands |
celestcombat.update.notify |
OP | Receive update notifications on login |
celestcombat.bypass.tag |
false | Completely bypasses combat tagging |
⚙️ Quick-Start Configuration Guide
Below is a breakdown of key sections in the config.yml to help you customize the plugin.
Adjusting Event Priorities
If another plugin overrides command blocking or damage handling, adjust the listener priority:
event_priorities:
command_blocking: "LOW" # Options: LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR
combat_damage: "HIGH"
teleportation: "HIGH"
Configuring Combat Punishment
Set up what happens when a player logs out during a PvP engagement:
combat:
duration: 20s
combat_logout:
enabled: true
kill_player: true
reward_attacker: true
punishment_commands:
- "broadcast &c%player% &7logged out during combat!"
attacker_reward_commands:
- "broadcast &a%player% &7killed &c%victim% &7(Combat Logout)"
Forcefields & safe zones
Adjust the forcefield visual and push back power:
safezone_protection:
enabled: true
barrier_material: "RED_STAINED_GLASS"
barrier_detection_radius: 5
push_back_force: 0.6
?️ Developer API
CelestCombat Pro provides a robust API for external plugins to integrate with its combat systems.
Accessing the API
Ensure you import com.shyamstudio.celestCombatPro.api.CelestCombatAPI and hook into it:
import com.shyamstudio.celestCombatPro.api.CelestCombatAPI;
import com.shyamstudio.celestCombatPro.api.CombatAPI;
import org.bukkit.entity.Player;
public class MyPluginIntegration {
public void checkPlayerCombat(Player player) {
CombatAPI api = CelestCombatAPI.getCombatAPI();
if (api != null && api.isInCombat(player)) {
player.sendMessage("You are currently in combat!");
// Get the remaining combat time
int secondsLeft = api.getRemainingCombatTime(player);
// Get their current opponent
Player opponent = api.getCombatOpponent(player);
}
}
}
? Building
To build CelestCombat Pro locally:
git clone https://github.com/ShyamStudios/CelestCombat-Pro.git
cd CelestCombat-Pro
./gradlew build
The compiled JAR will be saved in build/libs/.
? Contributing & Support
- Issues & Bug Reports: GitHub Issues
- Discord Community: Join our Discord
? Statistics
? License
This project is licensed under the CC BY-NC-SA 4.0 License - see the file for details.
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CelestCombat Pro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
CelestCombat-Pro 2.0.0:Folia & Canvas 稳定性更新
修复内容
- 修复了在 Folia/Canvas 上,当设置了
punishment_commands或attacker_reward_commands时,在战斗中退出会抛出 "IllegalStateException: Dispatching command async" 导致崩溃的问题。现在命令会在全局调度器中按顺序执行,且每个命令仅执行一次。 - 修复了由于冷却时间竞争导致击杀奖励有时会被发放两次的 bug。
- 修复了“最后攻击者”追踪功能。此前该功能失效是因为两个监听器副本各自维护了自己的地图数据。
- 修复了可能出现的重复战斗过期消息。
- 修复了若干空指针异常(NPE):包括光标为空时的物品栏点击、无目标位置的 UXM 传送请求,以及状态变更期间的战斗倒计时。
- 修复了回旋镖回滚尝试跨世界比较位置坐标的问题。
- 修复了冷却时间和新手保护数据文件被两次保存同时写入的问题。
Folia / Canvas 适配
- 玩家相关操作现运行在玩家自己的线程上:消息、标题、动作栏、音效、Boss 栏、物品栏、飞行、速度、传送和踢出。
- 方块变化、粒子效果和屏障方块运行在正确的区域上下文中。
- 异步任务现在仅处理文件和网络工作,不再触碰游戏逻辑。
- WorldGuard 和 GriefPrevention 的屏障代码、新手保护计时器以及两种倒计时显示均已实现区域安全。
性能优化
- 使用一个共享定时器来处理战斗和冷却时间的倒计时,取代了之前的独立任务。
- 移除了每次有人投掷三叉戟时都会启动的倒计时任务。
- 命令拦截规则仅编译一次,不再每次执行命令时都读取配置文件。
- 死亡动画设置、战斗登出设置和消息已进行缓存。
- GriefPrevention 屏障扫描不再为每个方块分配 Location 对象。
- 更新检查改为每小时运行一次,而非每次玩家加入时运行。
其他
- 所有插件任务在禁用时停止。重新加载后没有任何后台进程残留。
- 战斗、末影珍珠、三叉戟和屏障状态会在退出、死亡、重载和关闭时得到清理。
- 无需更改配置或消息设置。直接安装即可使用。
- 支持 Paper, Leaf, Folia, Canvas。MC 1.21.11,Java 21 和 25。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
插件
AbAcc AbAcc 是一款适用于 Minecraft 服务器的管理插件,可简化玩家作弊检测与举报管理工作。工作人员可以发起并管理对可疑玩家的检查流程,并在检查完成后将其释放。
评论 0
登录后参与评分
还没有评论,来抢沙发吧