概述

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

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

阿米娅

温馨提醒

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

• 本模组添加了对永恒枪械工坊：零模组的兼容，但需要 2.2.1 及以上版本的yes steve model才可以，否则游戏内无法显示第三人称持枪动画。

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

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

• 本模组添加了对地毯和窗帘模组的兼容，现在假人也可以使用模型外观和动画了。使用/ysm model set <假人名称> <模型名称> <贴图名称>  即可让生成的假人使用对应模型外观。

• 本模组添加了对跑酷模组的兼容。

• 本模组添加了对SWEM（马术）模组的兼容。
  

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

• 本模组在2.2.2版本将贴图分辨率大小上限提升至4096x4096。

• 1.2.0 版本增强了模型加密相关功能，客户端仅支持Windows x86_64环境（Windows on Arm、MacOS、Linux 等环境均不受支持），服务端支持 Windows 与基于 glibc 的Linux发行版。如果你在不受支持的客户端环境下想要加入安装了本模组的服务器，可以删除本模组。因为从1.2.0版本开始，在客户端删除本模组不影响你加入安装了本模组的服务器。
  
  

• 本模组与Very Many Players存在兼容性问题，具体表现为模型会出现错位的问题。

• 本模组与史诗战斗（Epic Fight）存在严重兼容性问题，具体表现为模型会出现贴图错误以及无法播放史诗战斗的动画等问题。

• 本模组与更好的战斗（Better Combat）存在兼容性问题，具体表现为模型在第一人称下使用武器攻击会出现头部模型遮挡屏幕的问题。

• 本模组与钢铁咒语和魔法书（Iron's Spells 'n Spellbooks）存在兼容性问题，具体表现为模型在第一人称下使用法术时会出现头部模型遮挡屏幕的问题，可在Iron's Spells 'n Spellbooks的配置文件中禁用第一人称施法动画来部分兼容。

功能

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 模型和两个原版玩家模型。

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

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