速通开关

Speedrun Switch | 接力速通

Speedrunning Minecraft, but Every 10 Minutes the Player Changes! 速通 Minecraft，但每 10 分钟更换玩家！

---

中文说明

Speedrun Switch（接力速通） 是一款专为 Minecraft 多人接力速通 Fabric 模组。 在游戏过程中，同一时间仅有 1 名玩家拥有操作权，其余所有队友均为旁观视角并强制附身于活动玩家。每满 10 分钟（时间可自定义），操作权将自动轮换给下一位玩家，最终目标是击败末影龙（当然也可以作为普通接力生存一直玩下去）。

---

✨ 核心特性

• 🔄 接力轮换与断线秒切：
  • 每隔 10 分钟 自动切换操纵玩家，其余玩家保持旁观模式进行观战。
  • 接力顺序由玩家观战时间、累计操纵时间等因素决定，顺序由权重随机决定。
  • 切换玩家时会从当前在线玩家中随机选取。
  • 掉线保护机制：活动玩家掉线瞬间，系统立即将操作权转移给下一名在线玩家。
  • 旁观者按 E 键即可实时查看装备与道具。
  • 基于原版旁观附身机制，高频发送视角锁定包，严禁旁观者私自脱离视角搜寻物资/跑图报点。
  • 对旁观者玩家隐藏坐标、生物群系与区块信息。
  • 玩家发送的聊天信息仅回显给自己，防止通过游戏内聊天违规报点交流；系统公告与任务信息全员正常接收。
• 🎯 动态任务奖励系统：
  • 每次轮换后随机延迟 0300 秒发放 01 个专属任务。内置任务：击杀敌对生物、击杀末影人、挖掘石头、造成伤害、拾取食物、进入下界/末地。
  • 支持数据驱动自定义任务：无需修改代码，在配置文件中即可添加任意生物（kill_entity）、物品（collect_item）、方块（mine_block）任务。
  • 任务奖励（延长操纵时间）与超时惩罚（施加缓慢效果或扣除时间）。
• 🎙️ Simple Voice Chat 观众频道语音隔离：
  • 旁观者自动加入“观众频道”畅所欲言，操纵者无法接受到语音信息。
• 📊 详细战绩报表与断点恢复：
  • 实时记录每位玩家的可操纵时长、死亡次数与全局总耗时。
  • 击杀末影龙后自动宣告速通胜利，冻结计时器并广播通关战报。
  • 断点恢复（/speedrun resume）：服务器意外重启或崩溃后，可随时从存档恢复未完成的速通。
• 🖥️ 客户端沉浸式 HUD：
  • 屏幕左上角HUD，显示当前操纵者、倒计时。

---

⌨️ 指令列表

指令	所需权限	说明
/speedrun start [玩家]	OP	开启接力速通（带开局倒计时与音效，可指定首发玩家）
/speedrun resume	OP	从存档恢复上次中断的速通进程
/speedrun switch [玩家]	OP	立即手动交接（可指定移交给某位玩家）
/speedrun time [set] <秒数>	OP	直接设置当前操纵者的剩余时间（如 time 600 设置为 600 秒，支持 time add 增减）
/speedrun stats	全员可用	查看本局用时、完成状态、各玩家操纵时长与死亡数
/speedrun unstuck [玩家]	全员（自己）/ OP 2（他人）	视角脱离/卡死恢复（重置附身并重新跟随操纵者）
/speedrun end	OP	结束当前速通（保留统计，全员恢复生存并保留背包）
/speedrun reset	OP	清空统计数据，重置为未开启状态
/speedrun help	全员可用	查看交互式指令帮助菜单

---

⚙️ 配置文件说明 (config/speedrun-switch.json)

配置项	默认值	详细解析
switchIntervalMinutes	10	自动轮换周期（分钟）
countdownSeconds	10	轮换前倒计时时长（秒）
startCountdownSeconds	3	开局起跑倒计时（秒）
autoSwitchEnabled	true	是否启用自动定时轮换（false 时仅可通过指令切换）
minimumPlayersForSwitch	2	允许轮换的最低在线人数（低于该人数跳过切换并提示）
taskEnabled	true	是否启用每轮任务系统
taskIntervalSecondsMin / Max	0 / 300	轮换后任务随机发放延迟区间（秒）
taskTimeLimitSeconds	120	任务超时时限（秒，轮换时自动截断）
taskRewardSeconds	30	任务达成奖励的额外操纵时间（秒）
taskPenaltySeconds	30	超时扣除的操纵时间（TIME 模式下生效）
taskPenaltyMode	SLOWNESS	惩罚模式：SLOWNESS（施加缓慢效果）或 TIME（扣除时间）
taskTemplates	见上方配置	任务池配置：支持自定义任务类型、目标数量、权重与通用目标 ID
voiceChatEnabled	true	是否启用 Simple Voice Chat 观众频道自动隔离
spectatorGroupName	观众频道	语音插件中创建的旁观者群组名称
blockDebugForSpectators	true	是否封锁旁观者的 F3 调试信息

自定义任务配置模版

任务模板支持通用类型，填写对应的命名空间 ID 即可生效：

"taskTemplates": [
  { "id": "kill_entity", "target": "minecraft:blaze", "count": 3, "weight": 2 },
  { "id": "collect_item", "target": "minecraft:ender_pearl", "count": 4, "weight": 2 },
  { "id": "mine_block", "target": "minecraft:ancient_debris", "count": 1, "weight": 1 }
]

---

💡 灵感来源与鸣谢 (Credits)

特别鸣谢以下创作者带来的灵感：

• 夏天y：Bilibili 视频 (BV1vxhj6EEFc)
• Andronicus（YouTube）：视频作品 《Speedrunning Minecraft, but Every Minute the Player Changes》

---

🤖 生成式 AI 声明 (Generative AI Disclosure)

• 代码与工作流：使用生成式 AI 辅助编写、重构与优化了部分模组代码、Maven 构建配置及 CI/CD 发布工作流。
• 图片、文档与页面：本项目的图片、简介说明、README 文档以及中英双语本地化排版经由 AI 辅助润色与翻译。
• 人工主导与审核：整体玩法设计、核心运行逻辑、安全校验及发布测试均由创作者人工主导、审计并维护。