CombatLogX - 战斗标签插件

CombatLogX 是一款专注于 PvP 的插件，旨在惩罚那些在战斗中途退出游戏的玩家。它提供了丰富的配置选项，并采用扩展机制来添加额外功能，以保持核心插件的轻量化。

💡版本信息

• 推荐版本：1.19.4、1.20.6、1.21.7
• 其他 Minecraft 版本可能兼容，但未经测试。

💡依赖

• BlueSlimeCore：运行 CombatLogX 所必需的依赖插件。

🎮功能概述

CombatLogX 是一款基于 PvP 的插件，主要惩罚在战斗期间退出游戏的玩家。

• 提供多种配置选项，例如惩罚类型和执行命令。
• 采用扩展系统来增加额外功能，确保主插件保持轻量。

关于扩展

CombatLogX 的功能通过扩展实现。扩展用于为主插件添加新特性。

• 在安装插件前，请务必访问 扩展文档页面 了解详情。

🔧安装指南

CombatLogX 的安装步骤与其他插件不同，请务必按以下指引操作。

下载与准备

• 从 Jenkins 或 SpigotMC 下载 CombatLogX.zip 文件。
• 在您的电脑上解压此 ZIP 文件。

服务器文件部署

• 在服务器面板上点击“停止”按钮，或直接在控制台输入 stop 命令以关闭服务器。
• 将 CombatLogX.jar 和 BlueSlimeCore.jar 上传到服务器的 /plugins/ 文件夹。
• 将解压出的 CombatLogX/expansions/ 文件夹内的所有内容（即所有 .jar 文件）上传到服务器的 /plugins/CombatLogX/expansions/ 文件夹。

验证文件结构

部署完成后，您的服务器应包含以下文件和文件夹

• 文件：/plugins/CombatLogX.jar
• 文件：/plugins/BlueSlimeCore.jar
• 文件夹：/plugins/CombatLogX/
• 文件夹：/plugins/CombatLogX/expansions/
• 多个文件：/plugins/CombatLogX/expansions/*.jar

完成安装

• 删除下载的 CombatLogX.zip 文件。
• 通过面板或启动脚本重启服务器。
• 根据需要编辑主插件、语言文件及各扩展的配置文件。
• 在游戏内或控制台输入命令 /clx reload 以重载配置文件。

管理扩展

• 如需移除某个扩展，只需从 /plugins/CombatLogX/expansions/ 文件夹中删除对应的 .jar 文件即可。

⭐开发者信息

CombatLogX 是一个采用 GPL-3.0 协议的开源项目。

• 源代码：可在 GitHub 上查看。
• API 文档：相关信息同样位于 GitHub。
• 开发构建：可在我的 Jenkins CI 获取包含新功能的测试版本。

❓帮助与支持

遇到问题时，请确保您已

• 仔细遵循了安装指南。
• 阅读了所有配置文件说明。

如果问题依然存在，请通过以下方式寻求帮助

• 在 GitHub 页面 提交新的“Bug Report”。
• 您也可以在 Discussion 板块发帖或发送私信，但由于我较少查看这些页面，回复可能较慢。

✨赞助

本项目由 Alien Host 赞助。欢迎点击横幅了解他们！

✨额外提示

• 请勿在插件评论中提交错误报告，我无法通过评论为您提供帮助。
• 如需帮助，请使用上文提供的联系方式。

CombatLogX 是一款用于管理玩家战斗状态的插件，它能在玩家进入战斗时将其标记，并防止他们通过退出游戏等方式逃避战斗。插件提供了丰富的扩展功能，允许你自定义战斗规则、视觉效果，并与众多其他插件实现兼容。

💡核心功能

• 战斗标记：当玩家攻击其他玩家或实体时，会被标记进入战斗状态。
• 防退出惩罚：击杀在战斗状态下退出游戏的玩家。
• 自定义执行：可在玩家被标记、解除标记或受到惩罚时运行特定命令。
• 关联判定：可将宠物、抛射物、TNT 和钓鱼竿的伤害与玩家关联。
• 灵活计时器：支持全局或基于权限的战斗计时器。
• 自动更新：支持检查插件更新。

🎮命令列表

主命令：/combatlogx

别名：/clx, /ctx, /combatlog, /combattagx, /combattag

• /combatlogx help - 查看 CombatLogX 的所有子命令。
• /combatlogx about <expansion> - 查看指定扩展的详细信息。
• /combatlogx reload - 重载插件及所有扩展的配置文件。
• /combatlogx toggle <bossbar/actionbar/scoreboard> - 为你自己切换 Boss 血条、动作条或计分板的显示。
• /combatlogx tag <player> - 强制将一名玩家标记为战斗状态。
• /combatlogx untag <player> - 强制将一名玩家从战斗状态中移除。
• /combatlogx version - 查看版本信息及已启用的扩展列表。

计时器命令：/combat-timer

别名：/combattimer, /combattime, /ctime, /clt, /ct

• /combat-timer - 检查你剩余的战斗时间。
• /combat-timer <player> - 检查指定玩家剩余的战斗时间。

🔧主要权限

• combatlogx.bypass - 默认的绕过权限，可在 config.yml 中修改。
• combatlogx.bypass.force.field - 针对力场扩展的默认绕过权限，可在其配置文件中修改。
• combatlogx.command.combat-timer - 允许使用 /combat-timer 命令。
• combatlogx.command.togglepvp - 允许使用 NewbieHelper 扩展的 /togglepvp 命令。
• combatlogx.command.togglepvp.admin - 允许使用 /togglepvp 命令的管理员功能。
• combatlogx.command.combatlogx - 允许使用基础命令 /combatlogx，但不包含其子命令。
• combatlogx.command.combatlogx.toggle - 允许使用 /combatlogx toggle 命令。
• combatlogx.command.combatlogx.about - 允许使用 /combatlogx about 命令。
• combatlogx.command.combatlogx.help - 允许使用 /combatlogx help 命令。
• combatlogx.command.combatlogx.reload - 允许使用 /combatlogx reload 命令。
• combatlogx.command.combatlogx.version - 允许使用 /combatlogx version 命令。
• combatlogx.command.combatlogx.tag - 允许使用 /combatlogx tag 命令。
• combatlogx.command.combatlogx.untag - 允许使用 /combatlogx untag 命令。

✨标准扩展

动作条 (Action Bar)

在玩家物品栏上方显示剩余战斗时间的信息。

• 可使用 Unicode 字符自定义进度条样式。

Boss 血条 (Boss Bar)

在屏幕上方以假 Boss 血条的形式显示信息。

• 可自定义血条颜色和类型。
• 要求：Spigot 1.9+。

作弊预防 (Cheat Prevention)

用于防止玩家在战斗期间逃脱。请注意，这不是一个反作弊工具。

**主要功能**

• 防止玩家破坏、放置方块或与方块交互。
• 防止玩家创建下界或末地传送门（需要 1.14+）。
• 防止玩家清空或装满水桶。
• 防止玩家在聊天栏输入或使用命令。
• 防止玩家与实体交互。
• 防止玩家飞行，或在飞行时保持战斗标记。
• 防止玩家使用鞘翅滑翔，或在滑翔时保持战斗标记。
• 防止玩家切换游戏模式，或在模式改变时解除标记。
• 强制被标记的玩家进入特定游戏模式。
• 强制关闭并阻止玩家打开任何物品栏界面。
• 防止玩家丢弃或拾取物品。
• 防止玩家使用激流附魔。
• 防止玩家使用不死图腾。
• 防止玩家在拥有药水效果时进入战斗。
• 防止玩家传送离开，或在传送后解除标记。
• 当玩家使用末影珍珠时，刷新其战斗标记时间。

伤害效果 (Damage Effects)

玩家每次受到攻击时产生血液粒子效果。

伤害标记 (Damage Tagger)

允许环境伤害将玩家标记进入战斗。

**已知的伤害类型**

• BLOCK_EXPLOSION：插件造成的爆炸。
• CONTACT：触碰仙人掌或甜浆果丛。
• CRAMMING：在狭小空间内与过多生物挤在一起。
• CUSTOM：插件造成的自定义伤害。
• DROWNING：在水中停留过久。
• FALL：从高处坠落。
• FALLING_BLOCK：被下落的方块（如铁砧）砸中。
• FIRE：触碰火。
• FIRE_TICK：因接触热源而着火。
• FLY_INTO_WALL：因鞘翅操作不当撞墙。
• HOT_FLOOR：站在岩浆块上。
• LAVA：触碰或游在熔岩中。
• MAGIC：来自瞬间伤害药水的伤害。
• POISON：来自女巫或插件的毒药水伤害。
• STARVATION：饥饿。
• SUFFOCATION：被沙子掩埋或传送到墙内。
• WITHER：凋零效果。

死亡效果 (Death Effects)

• 玩家被击杀时产生闪电效果。
• 玩家被击杀时产生红石粒子（血液）效果。

末影水晶助手 (End Crystal Helper)

将放置的末影水晶实体与玩家在战斗期间关联起来。

• 要求：Spigot 1.9+。

力场 (Force Field)

在非 PvP 区域周围创建一圈方块构成的力场。

• 可自定义方块类型和半径。
• 要求：必须安装 ProtocolLib 插件以及下方列出的至少一个“区域兼容”扩展。

**重要说明**

• 力场仅是一种视觉效果，用于向玩家展示不可进入的区域。
• 不应将其用作进入阻止机制，因为玩家可以忽略发送给他们的假方块数据包。
• 如需实际的进入阻止功能，请配置你使用的区域扩展。
• 如果服务器硬件性能较弱或在线玩家很多，建议禁用此效果以提升性能。

发光 (Glowing)

使被标记进入战斗的玩家发光，战斗结束后效果移除。

• 要求：Spigot 1.9+。

日志记录器 (Logger)

将各种战斗事件的详细信息保存到文件中。

• 可更改日志文件名称和格式。
• 可配置日志信息和日期格式。
• 可选择记录所有 CombatLogX 事件以及 EntityDamageByEntityEvent。

战利品保护 (Loot Protection)

• 保护玩家在战斗期间退出游戏时掉落的物品。
• 防止玩家拾取非自己击杀的敌人掉落的物品。
• 如果玩家在虚空死亡，物品会归还给击杀者。
• 可配置物品保护时间。

生物标记 (Mob Tagger)

允许生物将玩家标记进入战斗。

• 可配置能够标记玩家的生物列表。
• 可防止特定类型的生物标记玩家。
• 可防止因特定原因（如刷怪笼）生成的生物标记玩家。

新手助手 (Newbie Helper)

用于保护新玩家免受 PvP 攻击。

• 新玩家在可配置的时间内免受攻击。
• 当新玩家攻击他人时，保护将被移除。
• 添加了 /togglepvp 命令，允许玩家切换自己的 PvP 状态。
• （仅管理员）可强制设置特定玩家的 PvP 开启/关闭状态。

奖励 (Rewards)

可在玩家击杀生物或其他玩家时执行命令。

• 可自定义奖励内容。
• 可按世界启用/禁用奖励。
• 可指定奖励针对的实体类型。
• 支持基于概率的奖励。
• 支持带有自定义条件的奖励（如 Vault 经济余额、经验值等）。

计分板 (Scoreboard)

在侧边栏显示玩家的战斗标记信息。

• 可自定义标题和内容行，且无闪烁。

✨兼容性扩展

区域兼容扩展

以下扩展与领地插件联动，可用于阻止玩家进入非 PvP 区域。

• CrashClaim Compatibility
• Factions Compatibility
• GriefDefender Compatibility
• GriefPrevention Compatibility
• HuskTowns Compatibility
• KingdomsX Compatibility
• Konquest Compatibility
• Lands Compatibility
• PreciousStones Compatibility
• ProtectionStones Compatibility
• RedProtect Compatibility
• Residence Compatibility
• Towny Compatibility
• UltimateClaims Compatibility
• WorldGuard Compatibility

WorldGuard 兼容扩展

提供以下自定义区域标记（Flag）

• no-tagging: TRUE：在此区域内的玩家不会被标记。
• damage-combat: DENY：阻止因普通伤害被标记的玩家进入。
• mob-combat: DENY：阻止与生物战斗的玩家进入。
• mythic-mob-combat: DENY：阻止与 MythicMobs 战斗的玩家进入。
• player-combat: DENY：阻止与其他玩家战斗的玩家进入。
• unknown-combat: DENY：阻止因未知原因处于战斗的玩家进入。
• prevent-leaving: custom_id：阻止玩家在战斗期间离开区域。拥有相同 ID 的区域允许玩家在其间移动。

空岛兼容扩展

以下扩展与空岛插件联动，防止同一团队的成员互相标记。

• ASkyBlock Compatibility
• BSkyBlock Compatibility
• FabledSkyBlock Compatibility
• IridiumSkyblock Compatibility
• SuperiorSkyblock Compatibility
• uSkyBlock Compatibility

隐身兼容扩展

以下扩展与隐身插件联动，防止隐身玩家标记他人或被标记。

• CMI Compatibility
• EssentialsX Compatibility
• SuperVanish Compatibility
• VanishNoPacket Compatibility

伪装兼容扩展

以下扩展与伪装插件联动，在玩家被标记时移除其伪装。

• iDisguise Compatibility
• LibsDisguises Compatibility

其他兼容扩展

• AngelChest Compatibility：防止玩家在战斗期间打开、破坏或快速搜刮天使箱子。
• Citizens Compatibility：创建 NPC 来代替执行正常的玩家惩罚。可存储最后位置、生命值和物品，支持 Sentinel 让 NPC 攻击玩家，并防止玩家在 NPC 被移除前登录。
• CrackShot Compatibility：将 CrackShot 武器的伤害与射击者关联以进行标记。
• EssentialsX Compatibility：提供隐身兼容支持，并防止玩家在战斗期间创建传送请求。
• FeatherBoard Compatibility：在玩家被标记或解除标记时向 FeatherBoard 发送触发器。
• HuskSync Compatibility：修复同时使用 CombatLogX 和 HuskSync 时可能出现的错误。
• HuskHomes Compatibility：防止玩家在战斗期间传送回家。
• LuckPerms Compatibility：为 LuckPerms 权限添加自定义上下文。详情请查看相关链接。
• MarriageMaster Compatibility：防止伴侣在战斗期间互相传送。
• MythicMobs Compatibility：防止某些 MythicMobs 标记玩家，或强制某些 MythicMobs 始终标记玩家。
• PlaceholderAPI Compatibility：添加对 CombatLogX 占位符的支持。占位符列表请查看相关链接。
• PlayerParticles Compatibility：在玩家被标记时禁用其粒子效果，并在战斗结束后重新启用。