速通工具

速通工具

一个全面的速通模组,包含计时器、失明机制和跑图管理命令。

工具

SpeedrunUtils

一个用于管理速通的 Minecraft Fabric 模组,内置计时器、失明机制和速通记录功能。

注意: 此模组仍在开发中,且(大部分)由 AI 生成。

注意: 此模组设计为仅安装在服务端,但也可以安装在客户端(未经测试)。

环境要求

  • Minecraft 1.21.11
  • Fabric Loader >= 0.18.4
  • Fabric API
  • Java 21+

安装

  1. 安装 Fabric Loader
  2. 安装 Fabric API
  3. 将模组 JAR 放入你的 mods 文件夹

功能特性

游戏流程

  1. 服务器启动: 所有加入的玩家都会被施加失明效果
  2. 开始速通: 任意玩家运行 /startrun 开始倒计时
  3. 速通进行: 玩家在计时器运行期间完成游戏
  4. 完成: 当玩家击败末影龙后通过末地传送门离开时,计时器自动停止

自动功能

  • 加入时失明: 在速通开始前或暂停期间加入的玩家会自动获得失明效果
  • 时间冻结: 在速通开始前和暂停期间时间被冻结,在速通开始/恢复时解冻
  • 玩家冻结: 在速通开始前和暂停期间,玩家会被完全冻结在原地(移动和交互),使用基于数据包的冻结方式,阻止所有客户端操作,包括破坏方块、放置方块、攻击和移动
  • 计时器显示: 动作栏在屏幕底部显示已用时间,每秒更新 20 次(每 tick 一次)
  • 分段计时: 自动记录关键里程碑,将其广播到聊天栏,并在速通期间的侧边栏计分板上显示
  • 自动完成检测: 当末影龙被击败且玩家通过末地传送门传送回主世界(在制作人员名单之后)时,速通自动完成
  • 速通记录: 所有速通都会记录到 speedruns.txt,包含:
    • 日期和时间
    • 玩家名称
    • 最终时间(格式为 HH:MM:SS.mmm 或 MM:SS.mmm)
    • 完成状态
    • 分段记录(当有记录时)

分段计时

分段计时会在速通处于 RUNNING(运行中)状态时自动记录。每个分段都会:

  • 作为聊天消息广播给所有玩家
  • 添加到标题为 Speedrun Splits 的侧边栏计分板
  • 在动作栏中作为最新分段显示在计时器旁边
  • 在速通保存时,保存到 speedruns.txt 中的 Splits: 部分

当前分段列表

  • First Iron(第一块铁): 获得“Acquire Hardware”进度(熔炼/获得铁锭)
  • Entered Nether(进入下界): 速通期间玩家首次进入下界
  • Entered Nether Fortress(进入下界要塞): 获得“A Terrible Fortress”进度(进入下界要塞)
  • First Blaze Rod(第一根烈焰棒): 速通期间任意玩家获得的第一根烈焰棒
  • Blaze Rods Done(烈焰棒收集完成): 所有在线玩家的烈焰棒总数达到 7 根
  • First Ender Pearl(第一颗末影珍珠): 速通期间任意玩家获得的第一颗末影珍珠
  • Ender Pearls Done(末影珍珠收集完成): 所有在线玩家的末影珍珠总数达到 14 颗
  • First Ender Eye(第一颗末影之眼): 首次合成末影之眼
  • Stronghold Found(找到要塞): 获得“Eye Spy”进度(进入要塞)
  • Entered End(进入末地): 速通期间玩家首次进入末地

命令

/startrun

  • 权限等级: 0(所有玩家)
  • 描述: 以 3 秒倒计时开始速通
  • 行为:
    • 每次速通只能运行一次(在速通开始前)
    • 向所有玩家显示 3 秒倒计时
    • 移除所有玩家的失明效果
    • 解冻时间
    • 启动计分板计时器
    • 播放倒计时和开始音效

/pauserun

  • 权限等级: 0(所有玩家)
  • 描述: 暂停当前速通
  • 行为:
    • 停止计时器
    • 冻结时间
    • 对所有玩家施加失明效果
    • 如果速通已经暂停,显示“Run already paused!”

/resumerun

  • 权限等级: 0(所有玩家)
  • 描述: 恢复已暂停的速通
  • 行为:
    • 继续计时器
    • 解冻时间
    • 移除所有玩家的失明效果
    • 如果速通未暂停,显示错误消息

/stoprun

  • 权限等级: 0(所有玩家)
  • 描述: 停止当前速通并清除计时器
  • 行为:
    • 停止速通(如果有正在进行的速通)
    • 清除计时器
    • 解冻时间
    • 移除所有玩家的失明效果(以防速通处于暂停状态)
    • 广播:“Run stopped. Timer cleared.”

/newrun

  • 权限等级: 0(所有玩家)
  • 描述: 保存当前速通并准备新的速通
  • 行为:
    • 停止速通(如果有正在进行的速通)
    • 将当前速通数据保存到服务器根目录下的 speedruns.txt
    • 记录:时间戳、玩家名称、时间和完成状态
    • 重置速通状态
    • 冻结时间
    • 对所有玩家施加失明效果
    • 通知玩家服务器将重启以重新生成世界