开源 Fabric NeoForge 绯绯狐的模型加载/Fox Model Loader 1.2.0正式发布——我已是完全体 1.2.0

绯绯狐加载器 1.2.0 版本介绍

适用版本：Minecraft 26.1.2
支持加载器：Fabric / NeoForge
项目基础：基于 OpenYSM 的 1.20+ 迁移与增强版本

---

版本概览

绯绯狐加载器（Fox Model Loader）是一款面向 Minecraft 26.1.2 的自定义模型加载模组。它可以加载、管理并渲染 YSM 模型，让玩家用带动画的自定义 3D 角色替换默认 Steve / Alex 外观，并支持模型选择、第一人称手臂、手持物动画、联机同步与模型导入。

1.2.0 是一次以 双端适配、资源站、模型管理、性能观测和稳定性修复 为核心的更新。Fabric 端继续作为主线版本推进，NeoForge 端则提供独立迁移构建，让更多 26.1.2 环境可以使用绯绯狐加载器。

---

核心更新

• Fabric / NeoForge 双端支持
  Fabric 版本号为 1.2.0-fa26.1.2，NeoForge 版本号为 1.2.0-neoforge。NeoForge 端采用独立工程结构，已将配置注册、玩家/实体数据、网络包分发、服务端事件与客户端事件桥接到 NeoForge 路线，并通过 compileJava 与 build 验证。
  
• 资源站功能上线
  模型选择界面新增“资源站”入口，可浏览远程模型仓库并下载导入 .ysm / .zip 模型。资源站支持 OpenYSM index.json，也支持 GitHub 仓库根地址与 tree 地址；内置 Elaina69/Yes-Steve-Model-Repo 与 sdf123098/YSM-Model 两个默认源。
  
• 更完整的资源浏览体验
  资源站支持 URL 添加、删除、保存、上一个/下一个源切换；支持按名称、文件名、描述、作者和标签搜索；支持按名称、大小、来源排序；列表可显示大小、作者、标签、描述，并异步加载预览图。
  
• 下载队列与安全导入
  资源可以单个加入队列，也可以将当前过滤结果批量入队。下载队列串行执行，避免多个 ModelUploadSession 并发冲突；失败任务可重试。远程服务器场景下，资源站导入会走服务端校验、写入、重载、同步链路，不会误写客户端本地 custom 目录。
  
• 中国大陆访问加速
  资源站提供大陆模式，GitHub API 与 Raw 文件下载可使用代理/加速候选地址，并在失败后逐级回退，减少 GitHub 仓库访问不稳定导致的加载失败。
  
• 模型分类管理
  模型选择界面新增分类面板，支持新建分类、分类改名、分类删除、批量移动模型。删除分类时可选择“保留模型”或“删除模型”；分类改名遇到同名目标时会合并到目标分类，避免生成混乱的后缀目录。
  
• 分类刷新与缓存修复
  分类改名、删除后会同步刷新模型面板缓存，移除旧路径下已加载模型，并触发本地模型重载。若当前正在浏览被删除的分类，会自动回到根目录，减少残留项和空列表问题。
  
• 动画帧分析器
  新增 AnimationFrameProfiler，可记录每帧动画的 tickCount、partialTick、frameTime、renderTickTime、seekTime、骨骼数量、控制器数量和耗时，用于定位动画卡顿、重复计算和低帧感问题。
  
• 模型内存分析器
  新增 ModelMemoryProfiler，可在模型读取、解密/解压、解析、纹理解码、纹理上传、GPU Mesh 构建、加入缓存和释放等阶段输出内存检查点，便于排查大模型、多模型场景下的内存峰值。
  
• 性能与内存优化
  新增纹理上传后释放 Java 侧 byte[] 的实验选项；新增 GPU / native 渲染缓存 LRU 上限与未使用模型保留时间；优化 GPU 渲染状态缓存、不透明纹理透明 pass 跳过、Java fallback 临时对象复用，降低多模型场景的常驻内存与每帧分配压力。
  
• 右键双手挥动修复
  修复副手持有药水、盾牌或其他物品时，主手持剑、斧、镐、锹、锄、重锤等工具/武器右键会双手同时挥动的问题。判定从“副手盾牌 + 主手工具/武器”扩展为“副手非空 + 主手为右键兜底工具/武器”，右键表现更接近原版 Minecraft。
  
• 联机模型同步修复
  修复联机时其他玩家模型只显示为模组默认模型的问题。现在其他玩家选择的自定义模型可以正常同步和渲染。
  
• 移动端与启动器兼容补强
  Android 环境下改进 zstd 处理与 Java fallback，减少 native so 不兼容导致的模型不可见问题；导入链路支持 .ysm、.zip 与文件夹；文件选择器兼容 PojavLauncher、FCL、Zalith Launcher 以及桌面端 tinyfd / AWT / Swing 回退。

---

实验性测试设置

以下选项位于配置的实验性测试分组，默认建议保持关闭，仅在排查问题或收集日志时开启：

• ModelMemoryProfiler：模型加载内存检查点日志。
• AnimationFrameProfiler：动画帧级诊断。
• AnimationDebugLog：输出详细 [YSM-ANIM] 动画计算日志，日志量较大。
• WarnRepeatedAnimationEvaluation：警告同一实体在同一渲染帧内重复计算动画。
• ReleaseTextureBytesAfterUpload：纹理上传后释放 Java 侧字节缓存。
• ResourceStationMonitorLog：输出资源站列表、HTTP、预览图与下载诊断日志。
• MaxCachedGpuModels：限制 GPU / native 渲染缓存模型数量。
• UnusedModelTtlSeconds：未使用模型缓存的保留时间。

---

平台信息

• Fabric：Minecraft 26.1.2，Fabric Loader 0.19.2，Fabric API 0.149.1+26.1.2，Java 25。
• NeoForge：Minecraft 26.1.2，NeoForge 26.1.2.70-beta，Java 25。
• 构建产物：Fabric 端目标产物为 fox-model-loader-fabric-1.2.0.jar；NeoForge 端为独立 NeoForge 构建。

说明：NeoForge 端已完成独立迁移并通过构建验证，核心模型、资源站、分类、上传同步与诊断代码已同步进入 NeoForge 工程。部分第三方兼容模块、WebP / AVIF 解码集成以及 Data Attachment 持久化细节仍会在后续版本继续完善。

点击展开...

---

升级建议

• 升级前建议备份 config/yes_steve_model 与 custom 模型目录。
• Android / 启动器环境换入新 jar 后，如旧缓存导致模型异常，可清理 cache/server 与 cache/client 后重新进入游戏。
• 实验性诊断开关会输出大量日志，日常游玩建议关闭，只在排查性能、动画或资源站问题时开启。
• 资源站下载的模型仍会经过体积限制、路径安全归一化和服务端校验，不建议绕过导入链路手动写入未知来源文件。