[YSM]是，史蒂夫模型 模组使用指南

一、简介

Yes Steve Model 是一个修改原版玩家模型的模组，它使用了 Minecraft 基岩版模型和动画文件，并提供了诸多优化与模型加密功能。

二、基本介绍

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

• 自动同步客户端模型：普通玩家在进入服务器时，服务器会==自动==把模型同步到玩家的电脑上。
• 加密模型文件：发送到玩家客户端的模型全部是==加密的二进制文件==，有效避免模型窃取问题！
• 模型权限功能：模型可以单独设置授权，只有 OP 输入指令授权后，特定的模型才可以使用。
• 原版玩家模型修改：添加了默认的 Steve 和 Alex 模型，这两个模型均可自动调用玩家皮肤显示。
• 动画轮盘功能：当按下 Z 键时，能够打开一个轮盘动画。通过它你可以方便播放各种有趣的动画（比如动作、表情等）。
• 女仆模组渲染支持：使用 2.4.0 及以后版本的 Yes Steve Model 模组和 1.2.0 版本以后的 Touhou Little Maid 模组，即可对女仆也使用相应模型和动画。

三、使用说明

1.NeoForge / Forge 版本的说明

玩家首次进入服务器后，等待十几秒（这是模型同步的耗时，具体时长会根据服务器模型数量的多少而有所不同），便可使用快捷键 Alt + Y 打开如下 GUI 界面：

① 模型切换按钮：点击该按钮，可切换为对应的模型。若按钮背景为灰色，则表明该模型未授权。左上角的数字代表该模型可切换的材质数量。

② 模型类别切换按钮：能够在所有模型、已授权模型、收藏模型之间进行切换。

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

四、指令说明

1.主指令

• /ysm model reload：重载全部模型文件，同时会将模型文件同步给所有客户端玩家。
• /ysm model set <player> <model_id> <texture_id> [ignore_auth]：为指定玩家赋予特定的模型和材质。最后的 ignore_auth 参数为可选参数，若设置为 true，将无视模型授权，强制为玩家赋予该模型。
• /ysm play <player> <animation_name>：强制指定玩家播放指定名称的动画。
• /ysm play <player> stop：清除之前强制玩家播放的动画。
• /ysm auth <player> all：为玩家授权所有模型。
• /ysm auth <player> clear：清除玩家的所有授权模型。
• /ysm auth <player> add <model_id>：为玩家授权指定的模型。
• /ysm auth <player> remove <model_id>：清除玩家对指定模型的授权。
• /ysm export <model_id> [extra_info]：将指定模型导出为 ysm 专属模型格式，还可添加附加信息。
• /ysm ping：测试客户端与服务端的联通性。若出现 “服务端模组和客户端版本不一致” 的提示，可执行此指令，该指令无需权限。
• /ysm molang execute <player> <expr>：在指定玩家身上执行 molang 表达式，该指令在多人游戏中可用，但不会打印执行结果。

2.客户端指令

• /ysmclient watch var <expr>：2.4.0 版本新增的简化版指令，可快速向自定义调试屏幕添加 molang 表达式，并实时计算和更新。
• /ysmclient watch state <controller>：2.4.0 版本新增指令，可快速向自定义调试屏幕监听控制器的当前状态，并实时计算和更新。
• /ysmclient watch clear：2.4.0 版本新增的简化版指令，用于清除之前添加的所有 molang 表达式和控制器监听。
• /ysmclient molang execute <expr>：在本地玩家身上执行 molang 表达式，并将结果输出到聊天框。
• /ysmclient molang watch add [pre|post] <name> <expr>：向自定义调试屏幕添加 molang 表达式，并实时计算和更新。
  • pre 表示在动画更新前执行，post 表示在动画更新后执行。
  • 在 2.2.2 及之前的版本中，需按两次 Alt + B 才能进入自定义调试屏幕。
  • 在 2.3.0 及之后的版本中，只需按一次 Alt + B 即可进入自定义调试屏幕。
• /ysmclient molang watch remove <name>：移除之前添加的指定 molang 表达式。
• /ysmclient molang watch clear：清除之前添加的所有 molang 表达式。