- 版权类型
- 二次开发
- 插件中文名称
- YSM服务端同步插件
- 插件英文名称
- Yes Steve Model
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 26.x
YSMSync 是一款专为 Minecraft 服务端设计的 Yes Steve Model (YSM) 模型同步插件。它解决了原版 YSM 模组在多人服务器中模型同步困难的问题，让玩家无需手动操作，即可在服务器中看到其他玩家选择的个性化模型。
核心功能与特性
自动模型同步：当玩家进入服务器时，服务端会自动将其选择的 YSM 模型数据推送到所有其他客户端，确保模型在全服范围内即时、准确地显示，无需玩家手动同步。
Web 模型管理门户：插件内置一个 Web 服务器（默认端口 25584），管理员通过浏览器即可上传 .ysm 模型文件和预览图片，实现了便捷的图形化管理。
简易管理命令：提供 /ysmsync reload 命令用于重载模型列表，/ysmsync setmodel <玩家> <模型ID> [材质] 命令可直接为指定玩家设置模型，方便管理员操作。
无需 ProtocolLib：本版本采用原生 Netty 实现，不再依赖 ProtocolLib，简化了安装流程，避免了额外的插件冲突。
稳健的故障降级：即使 Web 管理端口被占用，插件也只会禁用网页管理功能，核心的模型同步功能依旧照常运行，不会影响服务器正常使用。
版本兼容性（至关重要）
使用前请务必确认版本完全匹配，否则玩家将无法连接或模型无法显示：
组件 必须为
服务端 Paper 26.3
服务端 Java Java 25
客户端 Minecraft 1.21.1-26.3
客户端模组 Yes Steve Model 26.1.2
对于仍在使用旧版服务端的用户，原项目也提供了面向 Paper/Purpur 1.19.4 的历史版本。
安装与配置指南
放置插件：将插件文件放入服务端的 plugins/ 目录。
启动服务器：启动后，日志中出现 [YSMSync] All models has been loaded! 和 [YSMSync] YSM web portal: http://0.0.0.0:25584 即表示加载成功。
管理模型文件：首次启动会生成以下目录，将模型文件放入对应文件夹后，执行 /ysmsync reload 即可生效：
plugins/YSMSync/models/custom/：自定义模型（玩家可选用）
plugins/YSMSync/models/builtin/：内置模型
plugins/YSMSync/models/auth/：授权模型
访问 Web 门户：在浏览器中打开 http://服务器ip:25584/ 即可上传和管理模型。
重要注意事项
冲突避免：请勿同时加载其他 YSM 同步类插件，否则会导致数据目录或协议处理冲突，引发不可预知的问题。
Web 门户安全：Web 管理门户默认没有 TLS 加密。在对外开放前，务必通过配置 HTTPS 反向代理并限制访问 IP 范围来保障安全。
端口冲突处理：若 25584 端口被占用，可修改 config.yml 中的 web-portal.port 更换端口，或设置 web-portal.enabled: false 直接关闭网页功能，模型同步不受影响。
YSMSync 通过自动化的模型同步和便捷的 Web 管理，显著提升了 YSM 模组在 Paper 服务器上的多人游戏体验。只要确保版本严格匹配并注意相关配置，它就能成为服务器管理的有力工具。
核心功能与特性自动模型同步：当玩家进入服务器时，服务端会自动将其选择的 YSM 模型数据推送到所有其他客户端，确保模型在全服范围内即时、准确地显示，无需玩家手动同步。
Web 模型管理门户：插件内置一个 Web 服务器（默认端口 25584），管理员通过浏览器即可上传 .ysm 模型文件和预览图片，实现了便捷的图形化管理。
简易管理命令：提供 /ysmsync reload 命令用于重载模型列表，/ysmsync setmodel <玩家> <模型ID> [材质] 命令可直接为指定玩家设置模型，方便管理员操作。
无需 ProtocolLib：本版本采用原生 Netty 实现，不再依赖 ProtocolLib，简化了安装流程，避免了额外的插件冲突。
稳健的故障降级：即使 Web 管理端口被占用，插件也只会禁用网页管理功能，核心的模型同步功能依旧照常运行，不会影响服务器正常使用。
版本兼容性（至关重要）使用前请务必确认版本完全匹配，否则玩家将无法连接或模型无法显示：
组件 必须为
服务端 Paper 26.3
服务端 Java Java 25
客户端 Minecraft 1.21.1-26.3
客户端模组 Yes Steve Model 26.1.2
对于仍在使用旧版服务端的用户，原项目也提供了面向 Paper/Purpur 1.19.4 的历史版本。
安装与配置指南放置插件：将插件文件放入服务端的 plugins/ 目录。
启动服务器：启动后，日志中出现 [YSMSync] All models has been loaded! 和 [YSMSync] YSM web portal: http://0.0.0.0:25584 即表示加载成功。
管理模型文件：首次启动会生成以下目录，将模型文件放入对应文件夹后，执行 /ysmsync reload 即可生效：
plugins/YSMSync/models/custom/：自定义模型（玩家可选用）
plugins/YSMSync/models/builtin/：内置模型
plugins/YSMSync/models/auth/：授权模型
访问 Web 门户：在浏览器中打开 http://服务器ip:25584/ 即可上传和管理模型。
重要注意事项冲突避免：请勿同时加载其他 YSM 同步类插件，否则会导致数据目录或协议处理冲突，引发不可预知的问题。
Web 门户安全：Web 管理门户默认没有 TLS 加密。在对外开放前，务必通过配置 HTTPS 反向代理并限制访问 IP 范围来保障安全。
端口冲突处理：若 25584 端口被占用，可修改 config.yml 中的 web-portal.port 更换端口，或设置 web-portal.enabled: false 直接关闭网页功能，模型同步不受影响。
YSMSync 通过自动化的模型同步和便捷的 Web 管理，显著提升了 YSM 模组在 Paper 服务器上的多人游戏体验。只要确保版本严格匹配并注意相关配置，它就能成为服务器管理的有力工具。
