二次开发 开源 绯绯狐的模型加载 1.2.4

Fox Model Loader - 简介

一款 Minecraft 自定义玩家模型模组 · 基于 OpenYSM · 支持 Fabric 与 NeoForge

Fox Model Loader 是一款基于 OpenYSM 构建的 Minecraft 模组，可以将原版玩家模型替换为带完整动画的自定义模型。它使用 Minecraft 基岩版模型与动画文件，并借助 GeckoLib 实现丰富的动画播放效果，让每位玩家都能拥有独特的角色外观。

---

功能特性

自定义玩家模型

加载基岩版格式模型文件，用于替换默认的 Steve / Alex 皮肤。每位玩家都可以独立选择模型与纹理，并在不同模型和纹理之间切换。

完整动画系统

• 基于 Molang 表达式的动画引擎，支持复杂状态机
• 内置移动动作：行走、奔跑、跳跃、潜行、游泳、飞行、滑翔
• 武器动画：为剑、斧、镐、锹、锄、重锤、三叉戟和长矛提供独特姿势
• 使用动画：拉弓、进食、饮用药水、格挡、投掷等
• 主手 / 副手动画独立响应；右键行为完全匹配原版
• 自定义动画条件：手持物品、穿戴装备、骑乘实体、当前维度等

资源站

模型选择界面内置资源站，可浏览远程模型仓库，并一键下载模型：

• 支持ysm 和zip格式
• 支持搜索、筛选和下载队列管理
• 内置 CDN 加速

模型分类管理

支持创建、重命名和删除分类文件夹，并可批量在分类之间移动模型。删除分类时，可以选择保留或移除其中内容。操作完成后缓存会自动刷新。

模型预览

GUI 中提供实时 3D 预览，支持旋转和缩放，方便查看模型细节。

第一人称手臂

将原版第一人称手臂替换为与当前加载模型匹配的自定义手臂。支持独立的左手 / 右手骨骼，并可同步手持物品与动画。

联机同步

当客户端切换模型时，变更会自动同步到服务端，因此同一服务器中的其他玩家也能看到对应的自定义模型。服务端支持配置模型上传权限和文件大小限制。

Android 支持

完整支持 Android（PojavLauncher / FCL / Zalith Launcher），内置模型选择器和文件导入功能，提供与桌面端一致的使用体验。

---

平台支持

• Fabric：完整支持
• NeoForge：完整支持（自 1.2.0 起）

---

v1.2.1更新

• 支持 Minecraft 26.1.x：此前版本仅支持 26.1.2
• Elytra 渲染修复：统一自定义 Elytra 渲染检查与原版隐藏逻辑；默认开启重新启用 Elytra 选项
• 资源站 UI 改进：减少按钮、文本与条目内容之间的布局重叠；长标签现在会限制在按钮边界内
• 下载页面重做：拆分为“任务”和“已完成”区域；可显示多个排队中 / 进行中的任务；已完成或失败的任务会移动到可清理的已完成列表
• 新增翻译：日语、韩语、繁体中文、法语、西班牙语，并补齐资源站、下载页面、导入状态和调试选项的缺失文本
• 调试设置分组：将日志、性能分析器、输入状态日志和资源站调试日志选项统一归入专门的“调试”分组

兼容性

• 模组版本：1.2.1
• Minecraft：26.1.x
• Java：25
• 平台：Fabric、NeoForge