Releases: gege-tlph/OpenYSM-Updated
Release list
OpenYSM-Updated 2.6.6.1 — 女仆当乘客时不再浮在空中 (1.21.11 Fabric)
本次更新
女仆当乘客时不再浮在空中。 换用 YSM 模型的东方小女仆，坐下待命、骑马、坐船三种情况下都会
稳稳落在座位上，不再整体抬高一截。
其余载具（东方小女仆的坐垫、椅子、扫帚，以及模型作者自定义的骑乘动画）保持原样未改。
Important
需要东方小女仆 Tsumugi 0.8.5 或更高版本。
若装了更早的版本，本模组会在启动时直接拒绝加载并提示升级——这比进游戏后崩溃要好。
不安装东方小女仆则不受此限制，本模组照常工作。
运行环境
| 组件 | 要求 |
|---|---|
| Minecraft | 1.21.11 |
| Fabric Loader | 0.17.0 或更高版本 |
| Java | 21 |
| 安装位置 | 客户端与服务端 |
Fabric API、Architectury API、Cardinal Components API 与 Forge Config API Port 已包含在发布产物中，无需另行安装。
安装
从下方附件下载 openysm-fabric-2.6.6.1.jar（名称中不含 sources 或 dev-shadow），放入客户端和服务端的 mods 目录。
归属与许可证
本项目是 OpenYSM/OpenYSM 的维护分支。许可证与归属沿用上游。
校验
- 提交：
0df90b39e869430477badff15c208444b65ced2b - 可安装 JAR SHA-256：
59c65384df083ae8284772ee563910eef80ec637abf5a3dfb687c1273006e330（28,132,986 bytes）
反馈问题时请附上
logs/latest.log（客户端；服务端问题请连服务端的一起）与对应的崩溃报告- 完整模组列表与版本，以及运行环境（单人 / 局域网 / 专用服务器）
- 复现步骤，以及能否稳定复现
- 涉及女仆渲染时另附：用的哪个 YSM 模型、女仆当时的状态（待命 / 骑乘何种载具）
OpenYSM-Updated 2.6.5.9 + 车万女仆挂件渲染 (1.21.11 Fabric)
本次更新
女仆的挂件现在会渲染了。 换用 YSM 模型的东方小女仆，背包、手持物品、主副手、头饰、背旗
都会跟着模型骨骼动，游泳等姿态下位置也正确。
这个缺口此前是「通道两端都在、中间断开」：东方小女仆的挂件渲染层在移植到 1.21.11 时改用了
自家的模型状态，本模组骨骼定位桥所实现的那个定位接口成了零消费者接口。两侧都已补齐——
东方小女仆一侧加了定位组来源抽象，本模组这侧把挂件渲染接了回去。
Important
需要东方小女仆 Tsumugi 0.8.5 或更高版本。
挂件渲染要用到该版本才提供的接口。若装了更早的版本，本模组会在启动时直接拒绝加载
并提示升级——这比进游戏后崩溃要好。不安装东方小女仆则不受此限制，本模组照常工作。
运行环境
| 组件 | 要求 |
|---|---|
| Minecraft | 1.21.11 |
| Fabric Loader | 0.17.0 或更高版本 |
| Java | 21 |
| 安装位置 | 客户端与服务端 |
Fabric API、Architectury API、Cardinal Components API 与 Forge Config API Port 已包含在
发布产物中，无需另行安装。
安装
从下方附件下载 openysm-fabric-2.6.5.9.jar（名称中不含 sources 或 dev-shadow），
放入客户端和服务端的 mods 目录。
需要女仆模型兼容的话，同时安装
东方小女仆 Tsumugi 0.8.5+。
模型包若要提供女仆动画，ysm.json 中必须声明 "tlm": "animations/tlm.animation.json"，
否则女仆动画会静默不播。
校验
- 可安装 JAR SHA-256：
fd391d9da8d07a9795ddf6f42657bba75b21af7d3e5708958c935b40298f553d - 编译所用的东方小女仆：v0.8.5 正式发布产物（SHA-256
9b83a43b…8059）
归属与许可
- 上游：IzumiiKonata/OpenYSM-Updated
- 原项目：OpenYSM/OpenYSM
- 本仓库为非官方维护 fork，不代表 Yes Steve Model、OpenYSM 或其上游维护者的官方版本。
- 许可沿用上游，见仓库
LICENSE.txt。
OpenYSM-Updated 2.6.5.9 + 车万女仆兼容 (1.21.11 Fabric)
基于上游 IzumiiKonata/OpenYSM-Updated 的 2.6.5.9（Minecraft 1.21.11 Fabric），
补上车万女仆（TouhouLittleMaid）兼容层，并修掉三处与车万女仆无关的上游缺陷。
车万女仆兼容层
上游的兼容模块在 Fabric 平台上是全 stub（isLoaded() 恒返回 false、16 个女仆 molang
变量全部返回常量），装了也不会生效。本版把它做成了真的实现：
- 女仆的模型切换与渲染、13 个动画状态、材质切换、名字牌，以及雕像与手办中的动画
- 女仆专用的模型选择屏与材质选择屏
- 动画轮盘：与玩家自己的轮盘分流，仅在准星指向已切换 YSM 模型且属主为本地玩家的女仆时接管
- 骨骼定位桥：把 YSM 的骨骼与模型映射到车万女仆的定位契约
- 双向网络包，已在专用服务器与多人环境下验证
- 未安装车万女仆时完全隔离，相关类不会被加载
需配合 TouhouLittleMaid: Tsumugi 使用。
修掉的上游缺陷
以下三项与车万女仆无关，任何使用者都会踩到：
- 在 GUI 中渲染实体会被压成全黑剪影。载具模型接管的判据被放在了副作用之后，
导致每个实体都会先被重新提取一遍渲染状态。世界渲染无感，但第三方模组在 GUI
中渲染实体时就会全黑。 - 客户端在
handleLogin崩溃（仅开发环境）。玩家能力对象在构造期就读取 SERVER
作用域配置，而该对象挂在每一个玩家上，包含客户端的本地玩家。服务端未安装本模组时
那份配置永远不会送达。正式环境虽不崩溃，但会静默使用硬编码默认值而非服务端配置值。 - 动画预览界面：载具与床画不出来，且所有动画的位置都不对（即原「已知问题」那条）。
三个独立成因：载具的绘制在提交式渲染改造中留了空方法体；床的方块模型本身没有几何，
绘制单个方块的接口对它是空操作（该缺陷在 1.20.1 原版上同样存在）；
动画偏移被折进了旋转之前的平移，会被 180° 翻转取反并掺入额外分量。
仍然开着的
YSM 模型的女仆不渲染车万女仆的挂件（背包、手持物、背旗、头顶方块）。
缺口在车万女仆一侧，本分支的骨骼定位桥已就绪。
安装
需要 Minecraft 1.21.11、Java 21 与 Fabric Loader。Fabric API、Architectury、
Cardinal Components 与 Forge Config API Port 已内嵌，不需要另行安装。
下载 openysm-fabric-2.6.5.9.jar，客户端与服务器都需要安装。