CelestCombat Pro

插件

· 作者 ShyamStudio

一个简单的插件,用于在 PvP 中标记玩家,并断开连接的玩家击杀以防止战斗挂机。但这是一个更优秀的版本

0 本站下载 0 关注 更新于 1 个月前

最新 2.0.1 · 26.3 · Folia / Paper

一键开服(送7天)

CelestCombat Pro

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

鸣谢原作者:

Combat action bar bossbar safezone

? 目录

  1. ? 核心功能
  2. ? 要求与安装
  3. ? 命令与权限
  4. ⚙️ 快速入门配置指南
  5. ?️ 开发者 API
  6. ? 贡献与支持
  7. ? 许可证

? 核心功能

⚔️ 战斗标记与防退出系统

  • 自动标记: 当玩家造成伤害或受到伤害时,自动将其标记为处于战斗中。
  • 战斗飞行控制: 进入战斗状态后立即禁用飞行和鞘翅使用,防止玩家逃跑。
  • 命令拦截: 阻止玩家通过传送或实用命令逃避 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+

安装

  1. 从 Modrinth 下载最新版本。
  2. 将 .jar 文件放入服务器的 plugins 文件夹中。
  3. 重启服务器。
  4. 在 plugins/CelestCombat/config.yml 中配置设置,并在 plugins/CelestCombat/language/ 中配置语言文件。
  5. 使用 /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 许可证进行许可 - 有关详细信息,请参阅 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源