[TACZ] Prop Hunt

Prop Hunt – Neo/Forge 1.21.1/1.20.1

经典的 Minecraft 躲猫猫游戏模式！
变身方块，躲藏起来，寻找你的朋友，在服务器上享受混乱又紧张刺激的对局。

---

🧱 什么是 Prop Hunt？

Prop Hunt 是一款捉迷藏小游戏，玩家分为两支队伍：

• 伪装者 – 变身成方块，躲在地图中。使用冻结能力，让自己完美融入环境。
• 猎人 – 在时间耗尽前追踪并淘汰所有伪装者！

本模组支持全面配置，专为服务器设计，并支持自定义方块、自定义武器和多张地图。

---

⭐ 功能特色

方块变身

伪装者可以变身为任意方块，包括带有 NBT 数据的自定义玩家头颅。

冻结系统

伪装者可以原地冻结，看起来就像真正的方块。

可全面配置冻结时长、冷却时间和恢复速率。

自定义地图

创建任意数量的地图。

为猎人和伪装者分别设置出生点。

猎人装备

为猎人配置自定义武器和弹药。

每淘汰一名伪装者，猎人都会获得弹药奖励。

HUD 显示

实时游戏信息。

冻结条、队伍名单和游戏状态。

音效系统

伪装者会定期吹口哨，帮助猎人找到他们。

回合结束时播放胜利或失败音效。

特殊物品

• 伪装者定位器（猎人） – 每分钟，猎人会获得一个物品，使用后会在一名随机伪装者的位置播放音效。
• 诱饵（伪装者） – 每分钟，伪装者会获得一个物品，使用后会在一名随机伪装者的位置播放诱饵音效（可以是自己，也可以是其他伪装者）。

全面可配置

• 游戏时长、躲藏时长、最低玩家人数、猎人比例、冻结设置、音效间隔等，都可以通过简单的配置文件进行设置。

---

🚀 快速开始指南

1️⃣ 创建地图

1. 站在竞技场中央。

2. 运行：/prophunt create <mapname>

2️⃣ 设置出生点

1. 前往猎人的出生位置并运行：/prophunt sethunterspawn <mapname>

2. 前往伪装者的出生位置并运行：/prophunt setpropsspawn <mapname>

3️⃣ 添加伪装方块

伪装者会从地图的方块列表中随机变身为方块。

1. 手持一个方块（自定义玩家头颅也适用）。

2. 运行：/prophunt addblock <mapname> hand

3. 对每种想让伪装者使用的方块重复此操作。

4️⃣ 配置猎人装备

1. 手持你想让猎人获得的武器，然后运行：/prophunt hunteraddweapon hand

2. 手持一种弹药物品（玩家每淘汰一名伪装者时都会获得），然后运行：/prophunt addammo hand

5️⃣ 开始游戏！

1. 开始游戏：/prophunt start <mapname>

2. 玩家有60 秒时间通过以下方式加入：/prophunt join

3. 大厅计时结束后，游戏会自动开始（至少需要 2 名玩家）。

---

📋 命令参考

🎮 游戏命令

/prophunt start <map>– 管理员 – 在指定地图开始游戏
/prophunt stop – 管理员 – 停止当前游戏
/prophunt join – 所有人 – 加入当前游戏大厅
/prophunt leave – 所有人 – 离开当前游戏
/prophunt status – 所有人 – 显示当前游戏状态
/prophunt testmode – 管理员 – 以道具方身份开始单人测试模式

---

🌍 地图命令

/prophunt create <name> – 管理员 – 在你所在位置创建新地图
/prophunt maps – 所有人 – 列出所有可用地图
/prophunt mapinfo <name> – 所有人 – 显示地图详细信息
/prophunt sethunterspawn <map> – 管理员 – 将猎人出生点设在你所在位置
/prophunt setpropsspawn <map> – 管理员 – 将道具方出生点设在你所在位置
/prophunt addblock <map> hand – 所有人 – 将手持方块添加到地图的道具列表
/prophunt showblock <map> – 所有人 – 显示地图中配置的所有道具方块
/prophunt clearblock <map> – 管理员 – 移除地图中的所有方块

---

🔫 猎人装备命令

/prophunt hunteraddweapon hand – 管理员 – 将手持物品添加为猎人武器
/prophunt addammo hand – 管理员 – 将手持物品添加为弹药（击杀后获得）
/prophunt hunterloadout – 所有人 – 显示当前猎人装备
/prophunt clearloadout – 管理员 – 清除所有猎人装备物品

---

🧱 道具命令（游戏内）

/prophunt transform – 变身为附近的方块
/prophunt transform hand – 变身为手持方块（调试用）
/prophunt transform <block> – 变身为指定方块
/prophunt revert – 解除变身

---

⚙️ 配置

所有主要设置都在：config/prophunt-common.toml

从冻结条到各阶段时长，所有设置都可调整，以适应你的服务器风格。

---

⏱️ 游戏阶段

1. 大厅 – 60 秒 – 玩家使用 /prophunt join 加入游戏。

2. 躲藏 – 30 秒 – 道具方躲藏并变身，猎人则会失明并被冻结。

3. 游戏进行中 – 5 分钟 – 猎人在地图各处搜寻道具方。

4. 结束 – 播放胜利音效并宣布获胜者。

🏆 胜利条件

道具方获胜 – 时间结束时至少有一名道具方存活。

猎人获胜 – 倒计时结束前淘汰所有道具方。

---

🧙 道具方能力

冻结（潜行）

• 按住 Shift 即可原地冻结。
• 冻结时，你看起来与普通方块一模一样。
• 潜行时，冻结条会逐渐耗尽。
• 冻结条归零后，你会进入冷却，之后才能再次冻结。
• 不潜行时，冻结能力会逐渐恢复。

速度提升

• 道具有永久的 Speed II 效果。
• 当猎人靠得太近时，用它来逃跑！

诱饵物品

• 每分钟，道具会收到一个诱饵物品。
• 把它放在你的副手中来激活它。
• 会在一个随机道具（包括你自己）上播放放屁声。
• 非常适合迷惑猎人，把他们从你的真实位置引开。

---

🎯 猎人能力

自定义装备

• 猎人在游戏开始时获得配置的武器。
• 他们每次击杀一个道具时都会获得额外弹药。

道具定位器物品

• 每分钟，猎人会收到一个道具定位器（指南针）。
• 把它放在你的副手中来激活它。
• 会在一个随机道具的位置播放响亮的声音。
• 仔细听，以追踪隐藏的道具！

---

💡 提示

对于道具

• 选择与地图自然融合的方块。
• 当猎人在附近时不要移动——冻结不动。
• 使用诱饵来误导猎人，并在其他地方开始追逐。
• 当哨声即将触发时，准备好移动！

对于猎人

• 仔细听周期性的道具哨声。
• 明智地使用道具定位器——不要浪费 ping。
• 检查看起来稍微不对劲的方块。
• 一起合作并沟通，以覆盖更多区域。

---

📦 要求

• Minecraft：1.21.1
• NeoForge：21.1.x
• 端：服务端（客户端需要安装该模组以获得 HUD 和视觉效果）

---

🛠️ 支持

发现了 bug？想建议新功能？
请在GitHub 仓库或CurseForge 问题追踪器上报告问题和建议。