aigccat
输入自然语言即可生成游戏 3D 资产的完整管线
项目简介
aigccat 是一款开源的通用 AI 3D 游戏资产管线,核心理念是「输入一句自然语言,产出可交付给 Unity / Godot 的 3D 资产(GLB + Asset Contract)」。它并非单纯的模型生成 Demo,而是为解决真实游戏项目中 3D 资产管理痛点而生的完整工具链:支持文字或图片两种输入方式,覆盖建模、贴图、减面、重拓扑、UV 展开、绑骨、动画、质量检测、版本管理和引擎交付全流程,所有操作在你自己的机器上完成,数据存储在你的 MinIO 中。
核心功能
- 多输入建模:支持文字描述、单图参考、多视图和批量导入四种建模输入方式
- AI 贴图处理:可选择 AI 自动贴图、使用已有贴图、平铺或手绘贴图四种模式
- 十种后处理操作:减面、重拓扑、四边面、拆分网格、UV 智能展开、材质调整、模型放大、绑骨、动画应用、变换操作
- 101 个动画模板:内置丰富动作库,可直接应用到生成的模型上
- 资产库管理:分类聚合、搜索筛选、批量操作和回收站功能
- 资产图谱:五级节点、四种布局的无限画布可视化资产关系图
- 版本控制:支持 latest / approved / published 三态版本管理,published 状态锁定并支持一键回滚
- 质量检测:GLB 结构校验(包围盒、身高比例、拓扑统计)和 QA 多视角渲染对比
- MCP 通道:提供 17 个 MCP 工具,可在其他平台调用 aigccat 能力
- 引擎交付:内置 Unity / Godot 导入适配器,一键打包 GLB + Contract + 大纲 + manifest
技术实现
aigccat 采用前后端分离的现代化架构设计。后端基于 Rust + axum 框架,所有路由注册集中在 web/src/main.rs,各模块只提供 handler,代码结构清晰好维护。存储层使用 MinIO(S3 兼容),对象 key 采用路径形态,与本地文件系统一一对应,备份和迁移只需拷贝数据卷。
前端则采用无框架、无构建步骤的原生 HTML/JS/CSS,Three.js 本地 vendored,部署简单且避免了复杂的依赖管理。执行层运行在 Docker 容器中:amd64 镜像自带 Blender 5.2.1(用于减面、重拓扑、部件编辑和自动绑骨),arm64 镜像则自动回落使用宿主机上的 Blender。AI 绑骨功能通过 OpenCode AI 编写 Blender 脚本,由容器内桥接服务执行。订阅类平台的登录也在容器内通过 VNC + Chromium 完成,宿主机无需安装任何浏览器。
整个架构设计围绕「开箱即用」和「自托管」两大原则:一个容器里同时运行 MinIO、后端、鉴权网关、AI 绑骨执行器和浏览器环境,docker run 一条命令即可启动,无需先配环境变量,无需本地安装 Blender 或其他依赖。
快速上手
- 第一步:安装 Docker(若尚未安装,访问 docker.com 获取对应系统版本)
- 第二步:创建并进入部署目录 mkdir -p aigccat-deploy && cd aigccat-deploy
- 第三步:运行一键部署脚本 curl -sSL https://raw.githubusercontent.com/RainNameless/aigccat/main/deploy/docker-deploy.sh | bash 脚本自动下载 compose 配置、启动容器并打印初始账号密码(默认 admin / aigccat),首次启动自动生成其余密钥并种入 4 个示例资产
- 第四步:访问本地工作台并配置模型账号 打开 http://localhost:8080,使用默认账号登录。进入「AI 账号」页面,添加你所需的模型服务商(支持 OpenAI 兼容接口),保存后自动读取上游模型清单
- 第五步:开始生成 3D 资产 在工作台输入自然语言描述或上传参考图片,选择建模参数,确认后等待 AI 生成。可在资产库中查看、管理和导出已生成的资产
适用人群
- 独立游戏开发者,游戏项目中有大量 3D 资产需求,缺乏专业建模团队
- 技术美术(Technical Artist),需要管理项目中大量 3D 资产的版本和品质
- 游戏工作室,关切 3D 资产的数据安全和私有化部署
- 3D 设计爱好者,希望用自然语言方式快速生成可用的 3D 模型
- 虚拟主播和 VFX 创作者,需要快速制作角色或场景资产
相关链接
- GitHub 仓库:https://github.com/RainNameless/aigccat
- 演示站:https://aigccat.ythmai.com
- Telegram 社区:https://t.me/aigccat
- 许可证:Apache License 2.0
评论与建议
登录 后参与评论或提建议