Minecraft Forge 1.20.1 的通用 3D 资产、动画与 GPU 渲染基础库。
将 Blender 等工具导出的 FBX / glTF / GLB 接入 Minecraft,保留材质、节点层级、骨骼和动画,在游戏内完成预览与配置。玩家角色应用已独立为 RigWorks,通过 Git 子模块引用本项目。
| 领域 | 已实现内容 |
|---|---|
| 模型导入 | Assimp 场景解析、静态与动态导入、嵌入/外部贴图、层级与枢轴、资源包及外置模型覆盖 |
| PBR 材质 | Base Color、Normal、Metallic/Roughness、AO、Emission、透明/裁切材质;Oculus / LabPBR 接入 |
| 动画运行时 | 骨骼片段、状态切换、分层混合、遮罩、程序化姿态、IK、Morph 数据、Spring 与 Bullet 物理服务 |
| GPU 管线 | 常驻顶点/索引缓冲、GPU 蒙皮、骨骼调色板、实例批处理;按能力与渲染条件启用 MDI、Compute 和 Hi-Z 路径 |
| 游戏内工作台 | 文件导入、独立 GPU 预览、层级、Transform、材质参数、挂点、时间轴、撤销/重做、项目保存与重开 |
| 数据与脚本 | JSON 实例/动画处理器、可选 KubeJS API、热重载、挂点和空间查询、可扩展工作台接口 |
| 调试 | LookDev 已加载模型列表、材质诊断、骨架/包围盒/碰撞显示和性能 HUD |
网格与索引保留在 GPU,动画求值和物理模拟按实例更新;主画面和阴影复用已经完成的姿态。Oculus 路径缓存扩展顶点和姿态数据,避免重复 CPU 蒙皮。批处理、更新间隔、距离预算和大型模型剔除均有独立策略。
这些路径有适用条件和回退方式,并非所有透明物、材质和光影组合都能合成一次 draw call。详见 GPU 批处理策略、运行时性能模式和性能记录。
需要 Minecraft 1.20.1、Forge 47.x、Java 17。安装 build/libs/assimploader-1.0.0-all.jar,其中包含 Assimp 绑定、原生库及必要的打包依赖。普通薄 JAR 不能代替它。
.\gradlew.bat build --console=plain
.\gradlew.bat runClient -PwithKubeJS --console=plain开发客户端默认包含 Oculus / Embeddium,可用 -PwithoutOculus 关闭;KubeJS 是可选依赖。发布 JAR 不捆绑这些开发模组。
在世界内按 L 或执行 /lookdev 打开工作区,进入 Edit 导入、编辑并保存项目。资源包模型和材质可用 F3+T 重载。完整流程见 快速开始和模型工作台。
KubeJS 的具体操作见 动画、骨骼、混合、IK 与烘焙动画教程,附 可运行脚本 Demo,从实例取得到重载、清理和性能约束逐步说明。
用 Agent 整理并导入资产,见 Agent 自动化工作流 和 可复用 Skill。配套 Blender / Maya / 3ds Max 一键导出 可交付 FBX、图片及初始配置;新脚本按需求未做运行验证。
本仓库维护通用引擎及独立的 AssimpShowcase 示例模组;build 分别生成引擎 -all.jar 和 assimpshowcase-1.0.0.jar。引擎不依赖 RigWorks,单独克隆即可构建。
RigWorks 负责玩家换模、原版动作重定向、装备编辑与角色配置同步。其他模组可以使用同一套引擎 API 和工作台扩展接口。
| 从这里开始 | 文档 |
|---|---|
| 美术资产与 FBX | PBR 接入规范 · 大型模型 |
| Agent 与 DCC 导出 | 自动化指南 · 三种软件导出 · Skill |
| 材质与光影 | Oculus PBR · 渲染集成 |
| 动画与脚本 | 动画指南 · 处理器 · KubeJS |
| 编辑器扩展 | 工作台 · 项目格式 |
| 示例 | 模型展台与 CIWS · 装甲车 · 火箭尾焰 |
| 全部资料 | 文档索引 · 历史记录 · 路线图 |
工作台编辑资产配置,不修改原始 Mesh、UV、蒙皮权重或动画关键帧;旧 Nodes 页尚不是完整材质节点编辑器。具体可用范围以当前指南及验收记录为准。