跳到正文

ysmstep

作者:Elisolia

根据 Yes Steve Model 的动画时钟调整脚步声,让声音与模型自身的落脚动作同步。

收藏

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

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 文件——只有在需要为玩家间同步校准数据时才安装。

快速入门

  1. 在「选项 → 控制 → YSM 脚步同步」下绑定“节拍点击”键。
  2. 切换到第三人称视角,边走边跟着模型可见的落脚动作点击至少 4 次。系统会计算周期长度,并按模型分别保存。
  3. 如果脚步声总是提前或延后半拍,可用 /ysmstep offset +0.05 微调相位。
  4. 对于跑步时会悬浮的模型,请使用 /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/版本名 下面。

评论

登录后评论和评分