概述

Yes Steve Model 模组是一个修改原版玩家模型的 Minecraft Forge/Fabric 模组。

它采用了 GeckoLib 作为核心，使用 Minecraft 基岩版模型和动画文件。从而使玩家能够随心所欲的自定义玩家模型和动画。

阿米娅

温馨提醒

• 本模组添加了对永恒枪械工坊模组的兼容，但需要 0.3.7 及以上版本的永恒枪械工坊模组才可以，否则游戏内持枪会导致游戏崩溃。

• 本模组添加了对更真实的第一人称模型模组的兼容，但特定动画下玩家视角还是会有些许异常。

• 本模组添加了对搬运模组的兼容，但 1.19.2 版本以下的 carry on 动画会额外渲染原版手臂，可以在 carry on 的配置选项中关闭。

• 在 Mod 版本 1.2.0 之前的模型包文件不要大于 2MB 大小，否则服务器同步玩家模型时，会因为包文件过大而导致玩家无法进服。如果你坚持要使用文件大小超过 2MB 的模型文件，可以安装 Packet Fixer 模组，它可以解决这一问题。1.2.0 版本则取消了这一限制（但仍然不建议模型过大）。

功能

Yes Steve Model 模组考虑到了服务器群体的模组需求，采用了诸多适用于服务器环境的设计，包括但不限于：

• 自动同步客户端模型：普通玩家在进入服务器时，服务器会自动把模型同步到玩家的电脑上。

• 加密模型文件：发送到玩家客户端的模型全部是加密的二进制文件，有效避免模型窃取问题！

• 模型权限功能：模型可以单独设置授权，只有 OP 输入指令授权后，特定的模型才可以使用。如果模型作者在导出 ysm 模型时在info.json里添加free字段，则服务器无法授权该模型，所有玩家均可使用。

• 原版玩家模型修改：添加了默认的 Steve 和 Alex 模型，这两个模型均可自动调用玩家皮肤显示。

• 简单的自定义功能：模型自定义功能极其简单，只需要在特定文件夹放置模型、材质和动画文件，在游戏内输入重载指令即可自动加载、同步。不需要编写任何配置文件！动画轮盘功能：当按下 Z 键时，能够打开⼀个轮盘动画。通过它，玩家可以方便播放各种有趣的动画（比如动作、表情等）

GUI

对于客户端玩家来说，使用也极其简单。当玩家首次进入服务器后等待十几秒（模型同步的耗时），即可使用快捷键 Alt + Y 打开如下 GUI 界面：

1. 模型切换按钮：点击即可切换为对应的模型。如果按钮右上角图标为红色，说明该模型未授权。图标内数字代表该模型可切换的材质数量；

2. 模型类别切换按钮：可以切换所有模型、已授权模型、收藏模型和原版模型，其中原版模型只有 Steve 和 Alex 模型；

3. 详情界面按钮：点击可进入模型详情界面，查看模型所有可用材质和动画。中间的预览窗口可以使用鼠标左键拖拽旋转模型、 鼠标右键拖拽移动模型、鼠标滚轮滑动缩放模型。点击右侧材质选择框可以选择不同的材质。点击左侧动画列表，可以预览播放不同的动画。

指令使用

模组全部采用 /ysm 开头的指令，均需要 OP 2 等级权限才可以使用，单机模式下则无需权限。所有的指令添加了游戏内的提示功能，所有模型 ID 、玩家 ID 即可智能提示。 

• /ysm model reload 重载全部模型文件：同时还会将模型文件向所有客户端玩家全部同步⼀次；

• /ysm model set <player> <model_id> <texture_id> [ignore_auth] 将特定模型、材质赋予给某个玩家，最后的 ignore_auth 参数是可选参数，当设置为 true 时，会无视模型授权，强制为玩家赋予模型； 

• /ysm play <player> <animation_name> 强制玩家播放 xxx 动画；

• /ysm play <player> stop 清除之前强制玩家播放的动画；

• /ysm auth <player> all 向玩家授权全部模型； 

• /ysm auth <player> clear 清除玩家所有授权模型； 

• /ysm auth <player> add <model_id> 向玩家授权 xxx 模型； 

• /ysm auth <player> remove <model_id> 清除玩家授权的 xxx 模型； 

• /ysm export <model_id> 将某个模型导出成 ysm 专属模型格式。 

YSM 专属格式的模型采用了⼀些成熟的加密功能，将模型、材质、动画等全部打包为⼀个文件，并能方便地被游戏所读取。既可以让模型制作者共享他们制作的模型，又可以保护其模型不被第三方玩家通过建模软件窃取并倒卖。

使用注意

• 本模组只提供自定义模型加载功能，只附带了原创的一个 CC0 协议模型、一个 CC BY-NC-SA 4.0 模型和两个原版玩家模型。

• 在玩家设计自定义模型时，请注意设计的模型与第三方可能导致的版权冲突问题。

• 因为自定义模型版权问题导致的与第三方冲突纠纷，与本模组无关。