💡 关于模组

此模组为史诗战斗模组（Epic Fight Mod）添加动态替换玩家模型功能的扩展模组，支持通过 Blender 导出的自定义模型实时替换玩家模型。

特别鸣谢：SAGESSE32。

本模组与 OptiFine 不兼容

注意：本模组不提供模型资源，仅内置三个默认模型。若想要更细致的表现效果（如头发飘动），可使用新骨架制作动画，并做成史诗战斗附属。

内置模型维吉尔

✨ 功能特性

• 动态模型替换 - 实时切换玩家或人形生物（僵尸/猪灵等）的模型，支持战斗中无缝切换；

• 关节平滑弯曲，裙子头发灵活跟随 - 权重的艺术；

• 支持三角面高模 - 只要骨骼命名符合规范即可识别；

• Blender 原生支持 -  直接使用 Blender + 史诗战斗插件 导出的 Armature 和 Mesh；

• 参数化配置 - 通过 config.json 自定义模型缩放比例、护甲部件可见性、碰撞箱缩放等参数；

• 支持模型绑定武器，切换武器后自动切换模型 - 见“快速入门”

• PBR 材质支持 - 支持法线/高光/金属度贴图（需开启光影）；

• 服务器同步 - 可上传模型至服务器，他人客户端模型仅存于内存，本地不留下缓存。

碰撞箱修改

三角面高模

🌟 快速入门

• 将模型文件放入 config/efmm/你的模型名称 目录；

• 使用命令 /authEFModelFor 玩家名 模型名称 授予玩家使用权限；

• 按 Ctrl + M 键打开 GUI 选择皮肤；

• 使用命令 /removeEFModelAuth 玩家名 模型名称 移除玩家权限；

• 使用命令 /bindEFModelFor 玩家名 模型名称 强制绑定玩家皮肤；

• 使用命令 /resetEFModelFor 玩家名 模型名称 重置玩家皮肤；

• 使用命令 /efmm uploadWhiteList 玩家名 add 授予玩家上传模型至服务器的权限；

• 使用命令 /efmm uploadWhiteList 玩家名 remove 移除玩家上传权限；

• efmm 文件夹下 auto_bind_item.json 可绑定自动切换模型的物品；

• efmm-common.toml 可配置 允许接收的模型的最大的顶点数 和 服务器响应下发模型请求间隔。

GUI

🔨 模型制作指南

参考示例：model_example/Anon_Chihaya。

你的模型必须从 Blender 导出并满足以下条件:

•  兼容 Epic Fight 的骨架绑定；

•  正确完成顶点组权重绘制；

•  符合标准骨骼命名规范。

📕 文件目录

模型名称/
├── main.json # 从 Blender 导出的骨架和网格数据
├── config.json # 模型配置文件（缩放参数/护甲可见性等）
├── texture.png # 基础纹理贴图
├── texture_n.png # PBR 法线贴图（可选）
└── texture_s.png # PBR 高光贴图（可选）