Speedrun Switch | 接力速通

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

English

Speedrun Switch is a Fabric mod designed for cooperative multiplayer relay speedrunning in Minecraft.
During the game, only 1 player has control at a time, while all other teammates remain in spectator mode and are camera-bound to the active player. Every 10 minutes (customizable), control automatically rotates to the next player, with the ultimate goal of defeating the Ender Dragon (or simply playing as a casual relay survival indefinitely).

✨ Key Features

• 🔄 Relay Rotation & Instant Disconnect Safeguard:
  • Automatically switches the active runner every 10 minutes, while other players remain in spectator mode watching.
  • The relay order is determined by factors such as players' spectating time and cumulative control time, with the order decided randomly based on weights.
  • When switching players, a runner is selected randomly from currently online players.
  • Instant Disconnect Safeguard: The moment the active runner disconnects, the system immediately transfers control to the next online player.
  • Spectators can press the <kbd>E</kbd> key to inspect equipment and items in real-time.
  • Based on the native spectator attachment mechanism, high-frequency camera lock packets are sent to strictly prohibit spectators from detaching their camera to scout for resources or call out locations.
  • Hides coordinates, biomes, and chunk information from spectator players.
  • Chat messages sent by players are only echoed to themselves to prevent illegal callouts and ghosting via in-game chat; system announcements and quest information are received normally by all players.
• 🎯 Dynamic Quest Reward System:
  • Randomly issues 0~1 exclusive quest with a delay of 0~300 seconds after each rotation. Built-in quests: slaying hostile mobs, killing Endermen, mining stone, dealing damage, picking up food, entering the Nether/End.
  • Supports Data-Driven Custom Quests: Without modifying any code, you can add quests for any entity (kill_entity), item (collect_item), or block (mine_block) directly in the configuration file.
  • Quest rewards (extended control time) and timeout penalties (inflicting slowness effect or deducting time).
• 🎙️ Simple Voice Chat Spectator Channel Voice Isolation:
  • Spectators automatically join the "Spectator Channel" to chat freely; the active runner receives no voice messages.
• 📊 Detailed Match Statistics & Checkpoint Recovery:
  • Records each player's active control time, death count, and overall total elapsed time in real time.
  • Automatically announces speedrun victory upon defeating the Ender Dragon, freezing the timer and broadcasting the completion battle report.
  • Checkpoint Recovery (/speedrun resume): Interrupted speedrun runs can be resumed from the save at any time after an unexpected server restart or crash.
• 🖥️ Client Immersive HUD:
  • Top-left screen HUD displaying the current runner and countdown timer.

⌨️ Command List

⚙️ Configuration File (config/speedrun-switch.json)

Custom Quest Configuration Template

Quest templates support generic types; fill in the corresponding namespaced ID to take effect:

"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 }
]

💡 Inspiration & Credits

Special thanks to the following creators for bringing inspiration:

• 夏天y: Bilibili Video (BV1vxhj6EEFc)
• Andronicus (YouTube): Video work "Speedrunning Minecraft, but Every Minute the Player Changes"

🤖 Generative AI Disclosure

• Code & Workflows: Generative AI was used to assist in writing, refactoring, and optimizing parts of the mod's code, Maven build configurations, and CI/CD publishing workflows.
• Pictures & Documentation & Page: The project Pictures, description, README documentation, and English/Chinese bilingual localization were formatted and polished with AI assistance.
• Human Oversight: Overall game design, core mechanics, logic validation, and release testing are directed, audited, and maintained by human creators.

🇨🇳 中文说明

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

✨ 核心特性

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

⌨️ 指令列表

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

自定义任务配置模版

任务模板支持通用类型，填写对应的命名空间 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 辅助润色与翻译。
• 人工主导与审核：整体玩法设计、核心运行逻辑、安全校验及发布测试均由创作者人工主导、审计并维护。