转载 游戏模式 Voltrox 猎人游戏 2.0.2

[MD]
## 简介

Voltrox Manhunt 是一款功能完善、高度可自定义的 Minecraft 猎人游戏（Manhunt）服务端插件，适用于竞技与休闲服务器。插件提供实时追踪、GUI 控制、PlaceholderAPI 支持及深度配置，满足开展猎人游戏所需的各项功能。

# Voltrox 猎人游戏

**Voltrox Manhunt** 是一款功能完善、高度可自定义的 Minecraft 猎人游戏（Manhunt）服务端插件，适用于竞技与休闲服务器。插件提供实时追踪、GUI 控制、PlaceholderAPI 支持及深度配置，满足开展猎人游戏所需的各项功能。

## 核心功能

- 经典的“逃亡者对猎人”玩法。
- 实时追踪：在动作栏显示坐标，并通过指南针指向目标。
- 带有 `/vm` 的游戏内猎人游戏 GUI 控制界面。
- 可自由配置 Config.yml，包括消息、音效与游戏设置。

## 游戏机制

- **先手机制**：倒计时期间冻结猎人，为逃亡者争取准备时间。
- **猎人重生套装**：可配置重生时获得的物品。
- **追踪指南针系统**。
- **硬核模式**：猎人死亡后将被移出游戏，提高对局风险与挑战性。

## 视觉与音效

- 自定义标题公告，包括胜利、失败与击杀末影龙等事件。
- 可完全自定义的音效。
- 动作栏实时显示逃亡者追踪信息。
- 使用玩家头像 GUI 直观选择玩家。

## 外部插件支持

- 支持 PlaceholderAPI。
- 可与 LuckPerms 等权限插件配合使用，默认权限设置为 `true`。

## 可配置内容

可根据服务器需求调整以下项目：

- 消息、标题与音效
- 先手时间
- 重生套装
- 指南针冷却时间
- 猎人死亡后移出游戏的规则
- 跨维度广播
- 指南针显示名称

## PlaceholderAPI 占位符

使用以下占位符需要安装 PlaceholderAPI。

> 将 `X` 替换为数字。例如，`%voltroxmanhunt_runner1%` 会返回第 1 名逃亡者的名称。

### 逃亡者信息

| 占位符 | 说明 |
|---|---|
| `%voltroxmanhunt_runner%` | 第 1 名逃亡者的名称 |
| `%voltroxmanhunt_runner_count%` | 逃亡者数量 |
| `%voltroxmanhunt_runner_list%` | 所有逃亡者名称，以逗号分隔 |
| `%voltroxmanhunt_runnerX%` | 第 `X` 名逃亡者的名称 |
| `%voltroxmanhunt_runner_uuid%` | 第 1 名逃亡者的 UUID |
| `%voltroxmanhunt_runner_health%` | 第 1 名逃亡者的生命值 |
| `%voltroxmanhunt_runner_health_percent%` | 第 1 名逃亡者的生命值百分比 |
| `%voltroxmanhunt_runner_hunger%` | 第 1 名逃亡者的饥饿值 |
| `%voltroxmanhunt_runner_world%` | 第 1 名逃亡者所在世界名称 |
| `%voltroxmanhunt_runner_dimension%` | 第 1 名逃亡者所在维度名称 |
| `%voltroxmanhunt_runner_x%` | 第 1 名逃亡者的 X 坐标 |
| `%voltroxmanhunt_runner_y%` | 第 1 名逃亡者的 Y 坐标 |
| `%voltroxmanhunt_runner_z%` | 第 1 名逃亡者的 Z 坐标 |
| `%voltroxmanhunt_runner_names%` | 所有逃亡者的名称 |

### 指定逃亡者信息

| 占位符 | 说明 |
|---|---|
| `%voltroxmanhunt_runnerX_name%` | 第 `X` 名逃亡者的名称 |
| `%voltroxmanhunt_runnerX_uuid%` | 第 `X` 名逃亡者的 UUID |
| `%voltroxmanhunt_runnerX_health%` | 第 `X` 名逃亡者的生命值 |
| `%voltroxmanhunt_runnerX_health_percent%` | 第 `X` 名逃亡者的生命值百分比 |
| `%voltroxmanhunt_runnerX_hunger%` | 第 `X` 名逃亡者的饥饿值 |
| `%voltroxmanhunt_runnerX_world%` | 第 `X` 名逃亡者所在世界名称 |
| `%voltroxmanhunt_runnerX_dimension%` | 第 `X` 名逃亡者所在维度名称 |
| `%voltroxmanhunt_runnerX_x%` | 第 `X` 名逃亡者的 X 坐标 |
| `%voltroxmanhunt_runnerX_y%` | 第 `X` 名逃亡者的 Y 坐标 |
| `%voltroxmanhunt_runnerX_z%` | 第 `X` 名逃亡者的 Z 坐标 |
| `%voltroxmanhunt_runnerX_ping%` | 第 `X` 名逃亡者的延迟（Ping） |
| `%voltroxmanhunt_runnerX_gamemode%` | 第 `X` 名逃亡者的游戏模式 |
| `%voltroxmanhunt_runnerX_is_online%` | 第 `X` 名逃亡者是否在线；在线时返回“是” |
| `%voltroxmanhunt_runnerX_is_dead%` | 第 `X` 名逃亡者是否死亡；死亡时返回“是” |

### 猎人、观战与游戏状态

| 占位符 | 说明 |
|---|---|
| `%voltroxmanhunt_hunter_count%` | 猎人数量 |
| `%voltroxmanhunt_hunters_list%` | 所有猎人的名称，以逗号分隔 |
| `%voltroxmanhunt_is_runner%` | 当前玩家是否为逃亡者；是时返回“是” |
| `%voltroxmanhunt_is_hunter%` | 当前玩家是否为猎人；是时返回“是” |
| `%voltroxmanhunt_game_active%` | 游戏是否正在进行；进行中时返回“是” |
| `%voltroxmanhunt_headstart_active%` | 先手阶段是否正在进行；进行中时返回“是” |
| `%voltroxmanhunt_distance%` | 与猎人当前追踪目标之间的距离 |
| `%voltroxmanhunt_distance_formatted%` | 带单位的距离，单位为方块或千米 |
| `%voltroxmanhunt_direction%` | 目标所在的方位 |
| `%voltroxmanhunt_tracking_target%` | 猎人当前追踪目标的名称 |
| `%voltroxmanhunt_compass_cooldown%` | 指南针剩余冷却时间，单位为秒 |
| `%voltroxmanhunt_spectator_count%` | 观战者数量 |
| `%voltroxmanhunt_is_spectator%` | 当前玩家是否为观战者；是时返回“是” |
| `%voltroxmanhunt_spectators_list%` | 所有观战者名称，以逗号分隔 |
| `%voltroxmanhunt_status%` | 玩家状态：逃亡者、猎人、观战者、先手阶段或未参与 |
| `%voltroxmanhunt_multi_runner_enabled%` | 是否启用多逃亡者模式；启用时返回“是” |
| `%voltroxmanhunt_max_runners%` | 允许的最大逃亡者数量 |

插件已完全重构，提供更加灵活的配置能力。

## 运行要求

- **Minecraft**：1.16.5+
- **Java**：16+
- **可选前置**：PlaceholderAPI

## 支持与下载

如需帮助，请通过 [discord.](https://discord.gg/jMFHKhqxM3) 联系作者。

请仅从 Modrinth 页面及 [Spigot page](https://www.spigotmc.org/resources/voltrox-manhunt.108959/) 获取插件，不要从其他第三方网站下载。
[/MD]