YSM 体验优化（YSM Enhancements）

为 YSM 2.6.5 新增 Z 按钮面板，改善模型预览、参数调整与键盘操作，并修复按键残留、快捷键误触发和界面控件等问题。

YSM 体验优化是面向 Yes Steve Model（YSM）2.6.5 的独立第三方客户端扩展。它读取模型作者定义的菜单、参数和动作，提供更直观的操作界面，并改善日常使用中的输入与界面问题。

只需在客户端安装，服务器无需安装本扩展。使用时需要保留对应版本的官方 YSM。本介绍对应 1.1.0 正式版。

新增功能与体验改进

Z 按钮面板：可替换原有 Z 键轮盘，以按钮、分类和参数列表呈现模型作者定义的内容。菜单按可用空间自动排布，宽屏最多三列，放不下时才分页；较长的参数列表支持滚动及滚动条拖动。
重新设计的界面：深色半透明面板、蓝色强调色、滑动开关、模型接地阴影和悬停过渡动画，让选中、开启及键盘焦点状态更容易辨认。
模型预览操作：拖动旋转整个模型，通过滚轮或加减按钮缩放；点击百分比可复位预览视角和缩放，方便观察模型各个方向。
更顺手的目录导航：标题显示完整目录路径，从子目录返回时保留原分页；根目录的返回按钮不会意外关闭面板。
直接输入数值：点击滑条数值即可编辑，原值预先全选，减少冗长浮点尾数；无效输入标红，Enter 确认、Esc 取消。
键盘导航：支持 Tab／Shift+Tab、方向键和 PageUp／PageDown。焦点移到列表外的参数时自动滚动；面板操作不会误触被隐藏的原轮盘控件。
独立功能开关：按钮面板与各项修复默认开启，可分别调整。关闭按钮面板即可恢复官方轮盘，其他已开启的修复继续生效。
错误回退与开销优化：面板绘制或输入处理出错时退回原轮盘，并通过缓存重复查询和文字处理结果，降低每帧开销。

模型菜单与参数的具体内容由模型作者决定。预览百分比的复位只影响观察视角和预览缩放，不会重置模型参数。

修复切换窗口、打开背包后，Ctrl 等按键仍保持按住状态的问题。
修复动作锁定快捷键忽略修饰键和游戏操作环境而误触发的问题。
修复绑定到鼠标按钮的 YSM 快捷键无法正常触发的问题。仅 Forge／NeoForge；官方 YSM 2.6.5 Fabric 已支持鼠标快捷键，无需此项修复。
修复原轮盘中，滚动区域外的隐藏控件仍能被点击的问题。
修复滚动或异步加载控件后，上下箭头状态未更新的问题。
修复科学计数法变量读取错误，例如 1e-5。
修复缩放滑条首次显示错误：零初值超出范围时，按模型作者明确的缩放回退规则初始化显示，打开界面时不修改模型变量。
修复负数且非零的变量被错误显示为未勾选的问题。
修复模型搜索结果刷新时，光标、选区及文本显示位置丢失或跳动的问题。
修复切换配置页或关闭界面后，旧异步回调造成控件叠加的问题。

Fabric 版包含以上除第 3 项外的 9 项修复，并针对动作锁定回调处理长按重复和按键状态重同步，避免一次按下触发多次切换。上述按钮面板及体验改进均已适配到两版 Fabric。

配置面板配置面板2

所有版本均需安装对应 Minecraft 和加载器版本的 官方 YSM 2.6.5。

请按 Minecraft 版本和加载器选择安装包：

Forge 1.20.1／NeoForge 1.21.1 共用包：ysm-enhancements-1.1.0-forge-neoforge.jar
Fabric 1.20.1：ysm-enhancements-1.1.0-fabric-mc1.20.1.jar
Fabric 1.21.1：ysm-enhancements-1.1.0-fabric-mc1.21.1.jar

支持范围为表中列出的具体 Minecraft 版本。Fabric 用户还需安装 YSM 要求的 Fabric API；如果所选 Fabric API 或其他模组要求更高的 Loader 版本，请同时满足其要求。

Forge／NeoForge：进入 Mods → YSM 体验优化（YSM Enhancements）→ 配置，分别开关按钮面板及各项修复。
Fabric：退出游戏后编辑实例中的 config/ysm_enhancements-client.toml；当前版本通过配置文件调整，尚无游戏内配置界面。

需要恢复官方轮盘时，将 interface.buttonPanel 设为 false。关闭面板不会关闭其他独立修复。

反馈问题时，请注明 Minecraft、加载器、YSM 和本扩展的版本，并提供复现步骤及相关日志。

本项目与 YSM 官方无隶属关系，扩展代码采用 MIT 许可证。安装包不包含 YSM 原始 JAR、模型资源或存档。