介绍
ysmstep
根据 Yes Steve Model 的动画时钟调整脚步声时机。
非官方项目,与 Yes Steve Model 或 Presence Footsteps 均无关联。本模组不包含来自这两个模组的任何代码或资源。
与其他模组的关系——本模组不是衍生作品
ysmstep 是独立、单独开发的模组,从零编写。它不是 Yes Steve Model、Presence Footsteps 或任何其他项目的分支、移植或衍生作品。
- 本模组不包含这些模组的任何代码或资源——包括模型、纹理、动画或音效。
- 本模组不会修改或再分发它们,只会调整原版脚步声的播放时机。
- 构建时不需要 Yes Steve Model,也不会引用其中的任何内容;本模组会根据玩家移动情况和手动测量的循环时长,计算应使用的节拍。
- Presence Footsteps 支持为可选功能,仅通过一个 mixin 钩子跳过其自身的步伐触发;脚步声的具体效果仍由该模组负责。
本项目旨在与这些模组互通,方式与其他兼容性附属模组支持所兼容的模组相同。本项目互通的模组已在本页面底部列出并致谢。
采用 MIT 许可证,源代码公开。
问题
Yes Steve Model 根据动画时间播放行走动画,因此循环时长固定(默认 1.0 秒,跑步时为 0.667 秒)。原版 Minecraft 则根据移动距离触发脚步声——大约每移动 0.6 格响一次,步行时约为 0.39 秒一次。
两个互不相关的时钟。从一开始它们就会逐渐错开,因此在大多数模型上,落脚动作和声音不再同步:走了两步,却听到三声。走得越久,错位越严重。
功能
- 动画时钟节拍器。原版
Player#playStepSound会被屏蔽,并由节拍器取代;节拍器每半个动画循环触发一次脚步声,让声音始终与模型的落脚动作同步。 - 腾空时保持相位。在空中时,相位既不会前进也不会重置,因此跳过边缘或出现一帧的
onGround闪烁 - 都不会再打乱节拍。按姿势设置音效模式。
step步行、跑步和潜行可以分别设置为none、wind、flap或soft。对于悬浮或跑步时脚不着地的模型,none或wind听起来会比脚步声更自然。 - 兼容 Presence Footsteps。安装 Presence Footsteps(NeoForge)后,ysmstep 决定何时迈步,而 Presence Footsteps 仍决定脚步声听起来如何——包括方块材质、左右脚交替、楼梯、潜行和身体比例。
- 由服务器同步校准数据。你的校准数据可以上传至服务器、保存到世界存档并广播出去,让其他玩家听到与你模型步伐节奏一致的脚步声。
- 可选的镜头晃动同步。视角晃动可以由同一个节拍器驱动,而非使用原版距离时钟(
/ysmstep bob)。
运行要求
- Minecraft 1.21.1、NeoForge 21.1+
- 必须另行安装 Yes Steve Model;本模组不包含其任何资源或代码
- Presence Footsteps(NeoForge)为可选
客户端必需。服务端可选,且使用同一个 jar 文件——只有在需要为玩家间同步校准数据时才安装。
快速入门
- 在「选项 → 控制 → YSM 脚步同步」下绑定“节拍点击”键。
- 切换到第三人称视角,边走边跟着模型可见的落脚动作点击至少 4 次。系统会计算周期长度,并按模型分别保存。
- 如果脚步声总是提前或延后半拍,可用
/ysmstep offset +0.05微调相位。 - 对于跑步时会悬浮的模型,请使用
/ysmstep mode run none(或wind)。
命令
/ysmstep— 查看状态/ysmstep on//ysmstep off— 开关;关闭后恢复原版脚步声/ysmstep cycle <seconds>— 行走动画周期长度(0.2–4.0)/ysmstep offset <seconds>— 相位偏移(-1.0–1.0)/ysmstep run <factor>— 跑步周期相对于行走周期的倍数(默认 0.667)/ysmstep sneak <factor>— 潜行周期系数(默认 1.0)/ysmstep follow <0–1>— 0 = 固定节拍,1 = 随移动速度变化/ysmstep volume <multiplier>— 音量倍数/ysmstep mode <walk|run|sneak> <step|none|wind|flap|soft>— 按姿势设置声音模式/ysmstep tap [step|cycle]— 单次点击代表什么/ysmstep test— 立即播放一步,用于检查音频链路/ysmstep hud— 常驻屏幕的状态面板/ysmstep debug— 将诊断信息写入config/ysmstep-debug.txt/ysmstep pf— 切换“让 Presence Footsteps 为脚步配音”/ysmstep share [model name]— 将校准结果上传到服务器/ysmstep apply— 为同名模型应用已保存的校准结果/ysmstep bob//ysmstep bobscale <0–2>— 摄像机晃动来源与幅度
数值参数支持相对输入:+0.05、-0.05、*2;使用 =0.1 可输入绝对负值。
已知限制
- 每个模型都需要手动校准一次。 Yes Steve Model 不会提供动画长度,而
.ysm模型文件经过加密,因此只能靠听声测量周期。 - 分享时需要手动输入模型名称。名称仅作为标签,用于向其他玩家提供默认设置;本模组不会读取或修改模型文件。
- Presence Footsteps 更新后可能会导致兼容层失效。本模组通过定位
TerrestrialStepSoundGenerator#simulateFootsteps实现兼容;如果该位置发生变化,游戏内会提示[PF gate not triggered],并改用原版脚步声,不会导致崩溃。 - 相位由每个客户端分别计算。使用同步配置时,每个客户端都会按自己的节拍计时——预计会有几十毫秒的差异,并非严格锁相。
- 仅适用于行走、跑步和潜行。游泳、飞行、骑乘和鞘翅滑翔仍使用原版行为。
- 只有 64 格范围内的其他玩家会受到处理。
中文说明
YSM 的走路动画按「动画时间」循环,原版脚步声按「走过的距离」触发。两个钟不一样,越走越错——走两步响三声,脚落地和声音对不上。这个模组压掉原版那套距离触发的脚步声,改用一个按动画周期推进的节拍器发声;装了 Presence Footsteps 时,我们只决定「什么时候踩」,踩出来什么声仍由 PF 决定。周期需要按模型手动校准一次(连点 4 下),校准结果可以上传到服务端广播给同模型的玩家。
完整命令表、校准方法与原理见项目页与源码仓库。
兼容模组
以下是其他作者制作的独立项目。它们不会随包附带、不会嵌入本项目,也不是构建 ysmstep 所必需的;本项目不包含其中的代码或资源。
- Yes Steve Model(作者:寒叔 / 空气避难所)——在游戏中绘制玩家模型的模组。
ysmstep 不会读取或修改它的文件;它只让脚步声与玩家看到的动画保持节拍一致。只有安装了此模组时才有用;请另行安装。 - Presence Footsteps(作者:Hurricaaane (Ha3)、Sollace 及贡献者;NeoForge 移植版作者:Paint_Ninja 和 ZCRAFT)——可选。安装后,ysmstep 决定何时迈步,而 Presence Footsteps 仍决定听起来是什么效果。
采用 MIT 许可证。
常见问题
ysmstep 支持哪些 Minecraft 版本?
ysmstep 支持 Minecraft Java 版 1.21.1,可用的加载器:Fabric / NeoForge。下载时注意选择和你游戏版本一致的文件。
ysmstep 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分