转载 游戏模式 饥饿游戏 1.1

[MD]
## 简介

适用于 Paper 1.20.x+ （Java 17）的高性能、高可配置、可用于正式服务器环境的饥饿游戏小游戏插件。

# 饥饿游戏

适用于 **Paper 1.20.x+**（Java 17）的高性能、高可配置、可用于正式服务器环境的饥饿游戏小游戏插件。

将经典的“最后一人存活”玩法带到你的服务器，并提供现代化的便利功能、简洁的竞技场工具和可靠的回合清理机制。

## 插件特点

- 面向真实服务器环境设计，具备稳定的流程、清晰的游戏状态和安全的清理机制
- 支持使用魔杖快速选择竞技场区域
- 游戏规则与战利品行为均可自由配置
- 采用 Adventure 风格的现代聊天消息与界面反馈

## 核心玩法

- **游戏流程**：`IDLE -> COUNTDOWN -> RUNNING -> ENDING`
- 支持点击加入，并在倒计时期间发布公告
- 以**金块**作为出生点，自动扫描可用出生位置
- 提供**保护期**，期间完全禁止 PvP
- 支持会缩小的**世界边界**，包含视觉提示与边界伤害处理
- 支持**自然灾害**事件，包括视觉与战斗效果，不会永久破坏地图
- 提供淘汰后的**旁观者系统**，并支持 combat logging 处理
- 使用 **BossBar** 跟踪倒计时、保护期、存活玩家数量和边界缩小时间

## 战利品系统

- 动态生成地面战利品箱
- 在铁块上动态生成中央战利品箱
- 地面战利品与中央战利品均支持权重战利品表
- 可配置战利品可生成的方块表面、生成尝试次数及距离检测规则
- 对局结束后自动还原并清理战利品箱

## 1.1 版本更新

- 新增传送和地图设置完成后的**开局移动锁定**功能（`pre-game-movement-lock-seconds`，默认值：`5`）
- 新增铁块战利品箱生成数量上限：`loot.mid-chests-per-player`（默认值：`3`）
- 修复死亡处理逻辑：被淘汰的玩家现在会**正常掉落物品**
- 对局结束时会额外清理：
- 掉落物
- 箭矢
- 光灵箭
- 三叉戟

## 指令

### 玩家指令

- `/hg join`
- `/hg leave`
- `/hg info`

### 管理员指令

- `/hg wand`
- `/hg arena create <name>`
- `/hg arena delete <name>`
- `/hg arena list`
- `/hg arena setspawnscan <name>`
- `/hg start <arena>`
- `/hg forcestart`
- `/hg stop`
- `/hg reload`

## 权限

- `hungergames.join`（默认：true）
- `hungergames.admin`（默认：op）
- `hungergames.command.bypass`（默认：op）
- `hungergames.*`（默认：op）

## 运行要求

- **服务端**：Paper 1.20.4+（支持 1.20.x）
- **Java**：17 或更高版本

## 快速安装与配置

1. 将插件 JAR 文件放入 ``plugins/``。
2. 重启服务器。
3. 使用 ``/hg wand`` 选择竞技场的两个对角。
4. 执行 ``/hg arena create <name>``。
5. 放置 ``GOLD_BLOCK`` 出生点，且其上方必须保留空气方块。
6. 放置 ``IRON_BLOCK`` 作为中央战利品标记。
7. 使用 ``/hg start <arena>`` 开始游戏。

## 注意事项

- 自然灾害经过专门设计，不会对竞技场造成永久性破坏。
- 每局结束后，插件会还原临时生成的战利品箱，并清除遗留的战斗实体和掉落物。
- 配置文件会自动生成于 ``config.yml``。

## 计划功能

- 战利品空投
- 战利品附魔选项
- 占位符统计功能，包括胜场、击杀、死亡次数和参与场次
[/MD]