转载 工具 CombatLog999 1.1.1

[MD]
# CombatLog999

CombatLog999 是一款适用于 Minecraft Java 版多人服务器的服务端插件，用于管理 PvP 战斗状态并处罚战斗中退出游戏的行为。

如需获取支持、提交功能建议或报告问题，可前往作者的 Discord：https://discord.gg/V3htVPGUGd

## 功能

### 核心战斗系统

- **战斗标记**：玩家在 PvP 中造成或受到伤害时，会自动进入战斗状态。
- **可配置的计时器时长**：可设置战斗计时器持续多久，计时结束后玩家才能安全退出。
- **战斗启动延迟**：可选设置战斗计时器启动前的延迟，避免 PvP 中的意外攻击立即触发战斗标记。
- **世界白名单**：可指定哪些世界启用战斗计时器。
- **玩家豁免**：管理员可为指定玩家授予临时战斗豁免。

### 视觉显示选项

- **Boss 栏显示**：在屏幕顶部显示带有剩余时间的彩色 Boss 栏。
- **动作栏显示**：在动作栏中显示战斗计时器。
- **动态颜色系统**：Boss 栏颜色会根据剩余时间自动变化，区分高、中、低三个阶段。
- **自定义消息**：可配置所有向玩家显示的提示消息。

### 惩罚系统

- **自定义惩罚命令**：玩家在战斗中退出时，可执行任意命令，例如击杀、扣除经济等。
- **传统背包掉落**：也可选择让战斗中退出的玩家掉落背包物品。
- **可配置惩罚**：支持定义多条惩罚命令，并可在命令中使用玩家占位符。

### 命令限制

- **战斗期间命令限制**：阻止玩家在战斗状态下使用指定命令。
- **可配置屏蔽列表**：可轻松添加或移除需要限制的命令。

### 日志与监控

- **详细战斗日志**：所有战斗中退出的违规行为都会记录到日志文件中，包含时间戳和玩家信息。
- **管理员追踪**：方便管理员查看和核实战斗中退出事件。

## 命令

### 管理员命令

- `/combatlog <player>`：切换指定玩家的战斗豁免状态。
- `/combatlogreload`：无需重启服务器即可重载插件配置。

## 权限

- `combatlog999.admin`：允许使用管理员命令。默认权限组：`OP`。

## 配置

插件的 `config.yml` 配置文件提供了丰富选项，可用于自定义插件行为。

### 计时器设置

- `combat-timer-duration`：玩家可安全退出前需要等待的时间，单位为秒。
- `combat-start-delay`：战斗计时器开始前的可选延迟，用于防止意外触发战斗标记。

### 显示设置

- `timer-display-mode`：选择显示方式，可选 `BOSS_BAR`、`ACTION_BAR` 或 `NONE`。
- `bossbar-color`：计时器剩余时间较高时使用的颜色。
- `bossbar-color-medium`：计时器剩余时间处于中等阶段时使用的颜色。
- `bossbar-color-low`：计时器剩余时间较低时使用的颜色。
- `low-time-threshold`：切换至低剩余时间颜色的阈值，单位为秒。
- `medium-time-threshold`：切换至中等剩余时间颜色的阈值，单位为秒。

### 惩罚设置

- `use-custom-punishments`：是否启用自定义命令惩罚。
- `punishments`：玩家在战斗中退出时执行的命令列表。
- `drop-inventory-on-combat-log`：传统背包掉落惩罚；仅在禁用自定义惩罚时生效。

### 世界设置

- `permitted-worlds`：启用战斗退出处罚的世界列表；留空则对所有世界生效。

### 命令限制

- `blocked-commands`：玩家处于战斗状态时禁止使用的命令列表。
[/MD]