谋杀工坊

MurderCraft

一个受 Squeezie & Théodore Bonnet 设计的 Murder 游戏模式（其本身受 Garry's Mod Murder 启发）启发的多人 Minecraft 模组。虚张声势。偏执。黑暗中藏匿的尖刀。

踏入一场充满猜忌的紧张派对：隐藏的杀手在人群中潜行，孤身的侦探试图及时揪出他们，而无辜者的唯一任务就是——活下去。仅凭一名携带武器的守卫、每把手枪的两发子弹，以及在一轮中局才会出现的唯一一把隐藏手枪，每场对局都变成一场恐惧、指控与瞬间决策交织的螺旋。

⚠ 重要归因：本模组中的规则集遵循 Squeezie & Théodore Bonnet 设计的变体（两名互不直接知晓身份的杀手、中局出现的隐藏手枪、误伤友善玩家将永久失去武器、每轮15分钟共4轮，从第3轮开始的任务机制、每把手枪两发子弹）。没有 完全复刻原始 Garry's Mod Murder 的规则。

---

✦ 核心概念

每轮开始时，每位玩家都会被秘密分配 三种角色 之一。没人知道谁是谁——而这正是关键所在。

角色	数量	武器	目标
☠ 杀手	2	匕首（一击必杀）	暗中消灭所有无辜者。两名杀手互不直接知晓身份——但他们可以通过仅彼此可见的微妙灵魂火焰粒子相互辨认。杀手无法捡起手枪——手枪会自动以全速弹飞。
⚭ 侦探	1	手枪（2发子弹）	识别杀手并将其击毙。射击无辜者将永久失去武器（手枪会掉落在地，剩余弹药保留，只有无辜者能捡起）。
☺ 无辜者	其余所有人	无	生存。观察。向侦探低声警告。找到中局掉落的隐藏手枪，成为新的侦探。

胜利条件

• 无辜者与侦探获胜：如果两名杀手都被消灭，或者倒计时结束。
• 杀手获胜：如果他们在倒计时结束前杀死所有非杀手玩家。

---

🏆 对局结构（4轮）

一局完整的游戏包含 4轮，每轮最多 15分钟。赢得最多轮次的队伍获胜。

轮次之间有 15 秒的暂停供玩家喘息，之后角色会重新洗牌，下一轮开始。

---

🗺 随机出生与免疫

每轮开始时：

• 所有参与者会被传送至世界出生点（/setworldspawn）周围可配置半径（默认 200 格）内的 随机合法陆地位置。
• 排除海洋、河流和深海生物群系——无人会出生在水中。
• 玩家在 25 格高空 出生，并享有 8 秒完全伤害免疫（可配置）。防止混乱开局时的摔落伤害、岩浆致死和秒杀。
• 玩家之间的最小距离 会强制执行（根据玩家人数缩放：4人时为60格，16人时为30格，32人及以上时为20格）。出生点会分散，从不聚集。
• 快捷栏会显示免疫倒计时：🛡 伤害免疫：5秒...，结束后显示 ⚠ 你不再无敌！。
• 所有参与者会自动切换至 生存模式，确保公平竞技。

方形世界边界

一个可配置的方形世界边界会在游戏开始时自动设置，以世界出生点为中心。默认大小：500 格边长。强制战斗在限定区域内进行——不再有无辜者跑出 5000 格躲藏。原始的世界边界配置会在游戏结束时保存并恢复。

---

🎯 任务（从第3轮开始）

从第 3 轮开始，每轮会出现一个任务：

• 探索——一个带有神秘令牌的发光宝箱会在附近生成。第一个拿到令牌的玩家获胜。
• 合成——会公布一个随机配方（火把、梯子、面包、纸等）。第一个合成该物品的玩家获胜。

任务获胜者获得 30 秒 时间使用 /murder task reveal <玩家> 私下得知 该玩家的角色身份。是否在语音聊天中分享信息完全由玩家决定——模组只显示角色身份。

---

🔫 武器系统

手枪（仅侦探可用）

• 每把手枪 2 发子弹（Squeezie 规则）。一旦用尽，手枪只会发出无用的咔嗒声。
• 弹药数量在掉落和捡拾间保持：一把射过一发子弹的手枪在被其他人捡起时仍会剩余 1 发子弹。
• 在物品提示中可见弹药计数（有弹时为绿色，空弹时为红色），每次射击后也会在快捷栏显示。
• 尝试发射空手枪时会发出空击音效。
• 多层枪声效果，并伴有枪口闪光粒子（烟雾+火焰）。
• 射程：64 格，射击间隔：1 秒。

隐藏手枪

• 每轮开始后 60 秒（可配置）在附近随机位置生成。
• 始终发出黄色光芒，且使用 setNeverDespawn()，确保在捡起前一直可见。
• 只有无辜者能捡起它——如果杀手踩到它，手枪会被弹飞，并伴有 3 秒的捡拾延迟。
• 当无辜者捡起时，他们会自动晋升为侦探，并继承手枪中剩余的弹药。

匕首（仅杀手可用）

• 对任何玩家一击必杀。
• 非杀手使用只会造成原版 1 点伤害的拳击。
• 组合三叉戟击中+羊毛破坏的音效，并伴有血液飞溅粒子。

防破坏保护

所有自定义物品（匕首、手枪、隐藏手枪、神秘令牌）无法手动丢弃。无论是按 Q 键还是拖出物品栏，物品都会立即返回，并伴有清晰的快捷栏提示。防止物品意外掉入岩浆、悬崖等，也防止玩家通过故意丢弃角色物品来破坏游戏。

---

✨ 视觉与音效优化

• 电影级标题覆盖：角色分配时显示（“你的角色：杀手”），回合开始时显示（“第 2/4 轮”），回合结束显示带有累计分数的横幅，任务完成时亦会显示。
• 杀手感知：其他杀手头顶会出现微妙的灵魂火焰粒子，仅对同伴可见——在不暴露自己的情况下协调行动。
• 角色专属提示音：杀手为凋灵环境音（恐怖氛围），侦探为钟声（正式），无辜者为烤面包声。
• 回合结束音效：无辜者获胜时播放胜利号角，杀手获胜时播放凋灵死亡音效。
• 右侧计分板 HUD，带有金色边框，显示回合、角色和倒计时——简洁且不遮挡视线。
• 多层武器音效与粒子效果，提供令人满意的战斗反馈。

---

⚙ 需求

模组	必需？	用途
Fabric API	必需	核心 API
Cloth Config	推荐	配置 GUI
Mod Menu	推荐	游戏内配置访问

• Minecraft：1.21.1
• 加载器：Fabric
• Java：21+
• 必须在服务器和所有客户端上都安装。

仅限多人游戏。 模组可在单人模式中加载，但无法开始游戏。最少需要 4 名玩家（默认推荐 5 人以达到更好平衡，最多支持 32 人）。

---

🎮 命令

命令	描述	权限
/murder join	加入大厅	所有人
/murder leave	离开大厅	所有人
/murder status	显示当前游戏状态	所有人
/murder task reveal <玩家>	揭示角色（完成任务后）	所有人
/murder start	开始游戏	OP
/murder stop	停止当前游戏	OP
/murder config show	打印当前配置	OP
/murder config minPlayers <数量>	更改最少玩家数	OP
/murder config duration <秒数>	更改回合时长	OP
/murder kick <玩家>	踢出玩家	OP

---

🔐 两种构建版本

构建版本	调试命令	生物伤害	用途
PUBLIC（本版本）	关闭（无法重新启用）	关闭	真实服务器，公开游戏
DEBUG（仅 GitHub 发布）	开启	开启	维护者的单人测试

服务器管理员可以信任公开构建版本，其行为一致且没有隐藏作弊接口——即使配置文件中有相关设置，调试标志也会被强制关闭，并会在控制台输出警告信息。

---

🛠 配置

所有设置会持久化存储在 config/murdercraft.json 中，并可通过 Mod Menu 实时调整：

• 游戏：最小/最大玩家数、游戏时长、开始倒计时、隐藏手枪延迟、每局轮数、轮次间隔
• 角色：杀手数量、侦探数量
• 玩法：匕首一击必杀开关、误伤友善玩家惩罚开关
• 出生：随机出生开关、半径、高度、免疫时长、世界边界开关、世界边界大小
• UI：自定义 HUD 开关、字幕开关

---

🗺 路线图

• 三种角色系统（杀手 / 侦探 / 无辜者）
• 4 轮对局，每轮 15 分钟
• 2 发子弹手枪，弹药持久化
• 手枪掉落规则（死亡、误伤友善玩家、杀手自动弹飞）
• 隐藏手枪自动晋升
• 任务系统与私人角色揭示
• 杀手感知粒子
• 随机出生与伤害免疫
• 可配置世界边界
• 自定义物品防掉落保护
• 标题覆盖 + 右侧计分板 HUD
• 公开/调试构建版本与安全标志
• 自定义 OGG 音效文件（目前使用原版音效）
• 持久化统计数据（击杀、胜利、MVP）
• 专用地图集成
• 通过 Architectury 支持 Forge / NeoForge

---

🐛 错误报告

这是一个公开测试版——仍需多人游戏的实际测试。出现错误是可预期的。请在 GitHub 问题追踪器 报告，并附上：

• 模组版本（例如 0.5.0-beta.7）
• Minecraft 版本（例如 1.21.1）
• 重现步骤
• 崩溃日志 / 视频（如适用）

---

📜 许可协议

在 MIT 许可协议 下发布——您可以自由地 fork、修改、重新分发，但需保留原作者署名。

---

🙌 鸣谢

• 规则灵感来源：Squeezie & Théodore Bonnet 设计的“Murder”游戏模式。本模组实现的具体规则遵循他们的变体。
• 类型起源：Garry's Mod — Murder
• 其他玩法灵感：UHC、UHC 狼人杀、Hypixel 密室杀手
• 模组设计与开发：Remilulz_91

源代码、错误报告与贡献请访问 GitHub 仓库。