SpeedrunUtils
一个用于 Minecraft Fabric 的模组,用于管理速通挑战,内置计时器、失明机制和运行记录功能。
注意: 此模组仍在开发中,且(大部分)由 AI 生成。
注意: 此模组旨在仅安装在服务器上,但也可以安装在客户端(未经测试)。
要求
- Minecraft 1.21.11
- Fabric Loader >= 0.18.4
- Fabric API
- Java 21+
安装
- 安装 Fabric Loader
- 安装 Fabric API
- 将模组 JAR 文件放入
mods 文件夹
功能
游戏流程
- 服务器启动: 所有玩家加入时均获得失明效果
- 开始速通: 任何玩家运行
/startrun 以开始倒计时
- 进行速通: 玩家在计时器运行时完成游戏
- 完成: 当玩家在击败末影龙后通过末地传送门退出时,计时器自动停止
自动功能
- 加入时失明: 在速通开始前或暂停期间加入的玩家会自动获得失明效果
- 时间冻结: 在速通开始前和暂停期间冻结时间,在速通开始/恢复时解冻时间
- 玩家冻结: 使用基于数据包的冻结机制,在速通开始前和暂停期间完全冻结玩家的位置(移动和交互),防止所有客户端操作,包括破坏方块、放置方块、攻击和移动
- 计时器显示: 动作栏在屏幕底部显示经过的时间,每秒更新 20 次(每个刻)
- 分段记录: 自动记录关键里程碑,将其广播到聊天窗口,并在速通期间在侧边计分板上显示
- 自动完成检测: 当末影龙被击败且玩家通过末地传送门传回主世界(在制作人员名单屏幕之后)时,速通自动完成
- 运行追踪: 所有速通记录保存到
speedruns.txt,包含:
- 日期和时间
- 玩家名称
- 最终时间(格式为 HH:MM:SS.mmm 或 MM:SS.mmm)
- 完成状态
- 分段记录(如果已记录)
分段记录
分段是在速通进行中时自动记录的。每个分段:
- 作为聊天消息广播给所有玩家
- 添加到名为 Speedrun Splits 的侧边计分板
- 反映在动作栏计时器旁边的 最新分段 中
- 在保存速通时,保存在
speedruns.txt 的 Splits: 部分下
当前分段列表
- First Iron: 获得“获取硬件”进度(熔炼/获得铁锭)
- Entered Nether: 玩家在速通期间首次进入下界
- Entered Nether Fortress: 获得“可怕的堡垒”进度(进入下界要塞)
- First Blaze Rod: 速通期间任何玩家首次获得的烈焰棒
- Blaze Rods Done: 在线玩家的烈焰棒总数达到 7
- First Ender Pearl: 速通期间任何玩家首次获得的末影珍珠
- Ender Pearls Done: 在线玩家的末影珍珠总数达到 14
- First Ender Eye: 首次合成末影之眼
- Stronghold Found: 获得“眼观六路”进度(进入 stronghold)
- Entered End: 玩家在速通期间首次进入末地
命令
/startrun
- 权限等级: 0(所有玩家)
- 描述: 开始一场带有 3 秒倒计时的速通挑战
- 行为:
- 每场速通只能运行一次(在速通开始前)
- 向所有玩家显示 3 秒倒计时
- 移除所有玩家的失明效果
- 解冻时间
- 启动计分板计时器
- 播放倒计时和开始的音效
/pauserun
- 权限等级: 0(所有玩家)
- 描述: 暂停当前速通挑战
- 行为:
- 停止计时器
- 冻结时间
- 对所有玩家应用失明效果
- 如果速通已暂停,则显示“Run already paused!”
/resumerun
- 权限等级: 0(所有玩家)
- 描述: 恢复暂停的速通挑战
- 行为:
- 继续计时器
- 解冻时间
- 移除所有玩家的失明效果
- 如果速通未暂停,则显示错误消息
/stoprun
- 权限等级: 0(所有玩家)
- 描述: 停止当前速通挑战并清除计时器
- 行为:
- 停止速通(如果有活跃的速通)
- 清除计时器
- 解冻时间
- 移除所有玩家的失明效果(以防速通处于暂停状态)
- 广播:“Run stopped. Timer cleared.”
/newrun
- 权限等级: 0(所有玩家)
- 描述: 保存当前速通并为新速通做准备
- 行为:
- 停止速通(如果有活跃的速通)
- 将当前速通数据保存到服务器根目录下的
speedruns.txt
- 记录:时间戳、玩家名称、时间和完成状态
- 重置速通状态
- 冻结时间
- 对所有玩家应用失明效果
- 通知玩家关于服务器重启以重新生成世界
SpeedrunUtils
A Minecraft Fabric mod for managing speedruns with built-in timer, blindness mechanics, and run tracking.
Note: This mod is still in development and is (mostly) generated by AI.
Note: This mod is meant to be installed server-only, but can be installed on a client (untested).
Requirements
- Minecraft 1.21.11
- Fabric Loader >= 0.18.4
- Fabric API
- Java 21+
Installation
- Install Fabric Loader
- Install Fabric API
- Place the mod JAR in your
mods folder
Features
Gameplay Flow
- Server Start: All players join with blindness effect applied
- Run Start: Any player runs
/startrun to begin the countdown
- Speedrun: Players complete the game while the timer runs
- Completion: Timer automatically stops when a player exits through the End portal after defeating the Ender Dragon
Automatic Features
- Blindness on Join: Players automatically receive blindness when joining before a run starts or during a pause
- Time Freezing: Time is frozen before the run starts and during pauses, and unfrozen when the run starts/resumes
- Player Freezing: Players are completely frozen in place (movement and interactions) before the run starts and during pauses using packet-based freezing that prevents all client actions including breaking blocks, placing blocks, attacking, and moving
- Timer Display: Action bar shows elapsed time at the bottom of the screen, updating 20 times per second (each tick)
- Splits: Automatically records key milestones, broadcasts them to chat, and shows them on a sidebar scoreboard during the run
- Auto-Complete Detection: Run automatically completes when the Ender Dragon is defeated & a player teleports
through the End portal back to the Overworld (after the credits screen)
- Run Tracking: All runs are logged to
speedruns.txt with:
- Date and time
- Player names
- Final time (formatted as HH:MM:SS.mmm or MM:SS.mmm)
- Completion status
- Splits (when recorded)
Splits
Splits are recorded automatically while a run is RUNNING. Each split is:
- Broadcast to all players as a chat message
- Added to a sidebar scoreboard titled Speedrun Splits
- Reflected next to the timer as the latest split in the action bar
- Saved under a Splits: section in
speedruns.txt when the run is saved
Current split list
- First Iron: Get the "Acquire Hardware" advancement (smelt/obtain an iron ingot)
- Entered Nether: First time a player enters the Nether during the run
- Entered Nether Fortress: Get the "A Terrible Fortress" advancement (enter a nether fortress)
- First Blaze Rod: First blaze rod retrieved by any player during the run
- Blaze Rods Done: Server-wide total blaze rods across all online players reaches 7
- First Ender Pearl: First ender pearl retrieved by any player during the run
- Ender Pearls Done: Server-wide total ender pearls across all online players reaches 14
- First Ender Eye: First time an Eye of Ender is crafted
- Stronghold Found: Get the "Eye Spy" advancement (enter a stronghold)
- Entered End: First time a player enters the End during the run
Commands
/startrun
- Permission Level: 0 (all players)
- Description: Starts a speedrun with a 3-second countdown
- Behavior:
- Can only be run once per speedrun (before the run starts)
- Displays a 3-second countdown to all players
- Removes blindness effect from all players
- Unfreezes time
- Starts the scoreboard timer
- Plays sound effects for countdown and start
/pauserun
- Permission Level: 0 (all players)
- Description: Pauses the current speedrun
- Behavior:
- Stops the timer
- Freezes time
- Applies blindness to all players
- Shows "Run already paused!" if the run is already paused
/resumerun
- Permission Level: 0 (all players)
- Description: Resumes a paused speedrun
- Behavior:
- Continues the timer
- Unfreezes time
- Removes blindness from all players
- Shows an error message if the run is not paused
/stoprun
- Permission Level: 0 (all players)
- Description: Stops the current speedrun and clears the timer
- Behavior:
- Stops the run (if one is active)
- Clears the timer
- Unfreezes time
- Removes blindness from all players (in case the run was paused)
- Broadcasts: "Run stopped. Timer cleared."
/newrun
- Permission Level: 0 (all players)
- Description: Saves the current run and prepares for a new speedrun
- Behavior:
- Stops the run (if one is active)
- Saves the current run data to
speedruns.txt in the server root
- Records: timestamp, player names, time, and completion status
- Resets the run state
- Freezes time
- Applies blindness to all players
- Notifies players about server restart for world regeneration
评论 0
登录后参与评分
还没有评论,来抢沙发吧