Skip to content

About

A powerful Minecraft 3D Model Mesh & Render Pipeline System

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

AssimpLoader

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 页尚不是完整材质节点编辑器。具体可用范围以当前指南及验收记录为准。

许可

MIT。依赖及第三方源码的许可见 第三方声明。

About

A powerful Minecraft 3D Model Mesh & Render Pipeline System

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages