OpenYSM

YSM开源替代品，基于2.6.5 forge

说明

本仓库包含了 YesSteveModel (YSM) 2.6.5（2026年4月）版本的完整源代码。

包含1.20.1 Forge版本的全部源码。

请注意：项目并非 Production Ready，可能存在命名语义错误，渲染错误等问题，如果您在使用过程中遇到了任何问题请打开 Issue 反馈，最好附带截图和可能的报错日志。

为什么开源？

我们决定将新版 YSM 源码开源，主要基于以下几个原因：

1. 新版本的完全重置

新版 YSM 已经经过完全重新设计和开发，采用了全新的架构和加密方式。

我们认为这个全新的架构和加密方式很酷，因此发布了源代码供大家学习研究和使用。

2. 新版加密的现状

此前社区已经出现了一个破解 YSM 2.6.5 及以下版本加密的工具和方法，新版的加密机制实际上已经失去了保护作用。

同时，目前社区中的大部分新模型都已经公布了源文件或者被解密，新版加密已经毫无实际意义。

3. 支持开放的游戏氛围

我们注意到社区中没有开发者制作了去除加密功能的最新 YSM 版本，这表明了这是一个蓝海市场。

OpenYSM 开发组一直非常支持开放、自由的游戏开发氛围，我们希望通过开源新版源码，为其他开发者的二次开发和学习提供便利。

TODO

• Ogg Opus音频解码播放
• Webp、Avif等纹理的解码
• 符合YSM标准的服务器客户端通讯握手流程
• 模型的读取与渲染
• 子模型动画控制器
• SIMD加速渲染未完工
• 与服务器通讯握手时默认模型未正确处理
• 未测试低版本二进制模型/未加密模型的兼容性
• YSGPHeader生成

修改

我们相比已经发布的 YSM 版本做出了以下修改

• 使用 Java 重写了加载和渲染逻辑，现在可以脱离 Native 运行，例如在 MacOS，RISC-V 甚至手机上
• 支持现有的已加密的 YSM 模型
• 添加了/openysm cache dump命令帮助你调试模型传输，导出服务器中的所有模型

开源协议

源代码协议

本项目的源代码采用 MIT License 开放，您可以自由地使用、修改和分发代码，仅需要保留原始的版权声明。

详细的许可证条款请参见 LICENSE 文件。

模型资源协议

仓库中自带的模型文件采用不同的协议：

• 默认模型: 采用 CC0 (Creative Commons Zero) 协议，完全开放，无任何使用限制
• 酒狐 (Wine Fox) 模型: 采用 CC BY-NC-SA 4.0 协议，允许非商业使用，需要署名，并且衍生作品需要采用相同协议

请在使用相应模型时严格遵守对应的协议要求。

使用建议

我们鼓励开发者基于此源码进行二次开发，创造出更加开放、易用的模型加载工具。