转载 前置/API 工具 ZonePracOldCombat 1.0.0

[MD]
## 简介

1.8 通过 OldCombatMechanics 为 ZonePractice Pro 强制应用 PvP 战斗模式。

# ZonePracOldCombat

1.8 通过 [OldCombatMechanics](https://github.com/kernitus/BukkitOldCombatMechanics/releases) 为 [ZonePractice Pro](https://modrinth.com/plugin/zonepractice-pro) 强制应用 PvP 战斗模式。

## 简介

本插件用于连接 ZonePractice Pro 与 OldCombatMechanics。它会将竞技场天梯映射到 OCM 战斗模式（旧版 / 新版），并在对局开始时为每位玩家应用对应的模块覆盖设置。

无需再为不同世界的限制而烦恼，也不必手动输入 /ocm 模式命令——玩家会自动获得正确的战斗模式。

## 前置依赖

- ZonePractice Pro（必需）
- OldCombatMechanics（必需）

## 安装方法

1. 安装 ZonePractice Pro 和 OldCombatMechanics。
2. 将 ZonePracOldCombat.jar 放入服务器的 `plugins/` 文件夹。
3. 重启服务器。
4. 编辑 `plugins/ZonePracOldCombat/config.yml`，配置各天梯对应的战斗模式。

## 配置

配置文件：`config.yml`

```yaml
# 指定每个天梯使用的战斗模式
ladder-modes:
Nodebuff: old
BuildUHC: old
# ...

# 为每种模式启用的模块（必须与 OCM 的模块名称一致）
modules:
old:
- "disable-attack-cooldown"
- "disable-sword-sweep"
- "old-tool-damage"
- "sword-blocking"
- "shield-damage-reduction"
- "old-golden-apples"
- "old-player-knockback"
- "old-player-regen"
- "old-armour-strength"
- "old-potion-effects"
- "old-critical-hits"
- "disable-attack-sounds"
new: []
```

## 工作原理

- 监听 `MatchStartEvent` 与 `MatchRoundStartEvent`。
- 在运行时从比赛中获取天梯名称。
- 查询该天梯配置的战斗模式（`old` 或 `new`）。
- 对该模式下列出的所有模块调用 `setModuleOverridesForPlayer()`，并以 `FORCE_ENABLED` 强制启用。
- 此方式可绕过 OCM 基于世界的模式集限制。
- 在 `MatchEndEvent` 触发时清除所有模块覆盖设置。

## 兼容性

兼容同时受 ZonePractice Pro 与 OldCombatMechanics 支持的所有 Minecraft 版本。
[/MD]