【标签】 学习工作
【标题】 【学习工作赛道】ModCrafting - AI原生Minecraft模组开发环境
0. 先和大家打个招呼吧 
-
你是谁： 全栈开发者，深耕 Vue 生态与 Node.js，同时具备 HarmonyOS 原生开发和游戏引擎（Cocos Creator / Godot）开发经验，关注 AI 应用集成与数据可视化。曾获 2025 鸿蒙创新赛校园星火奖、2026 温州字节黑客松二等奖等多项竞赛荣誉。
-
你是怎么用 TRAE 把 Demo 做出来的： 虽然我有全栈开发的经验，但做一个完整的 Electron 桌面应用 + AI 对话系统 + 3D 渲染引擎的组合项目，放在以前至少需要几周的全身心投入。TRAE 让我最震撼的是它对复杂架构的理解能力——我只需要把"Electron + React + AI Agent + MC 方块渲染"这几个关键词和设计思路告诉它，它就能帮我拆解出完整的模块结构和接口设计。3D 方块渲染那部分，CSS 3D Transforms 的透视、旋转矩阵、纹理映射，在 TRAE 的辅助下几个小时就出了可用的原型，这在以前我得翻半天 MDN 文档。最让我惊喜的是代码回滚功能——我随口说了句"要能撤回 AI 生成的代码就好了"，TRAE 就自动设计了 FileSnapshot + SessionStateSnapshot 的完整快照机制，连回滚警告面板的交互细节都考虑到了。作为一个写过多个项目的人，TRAE 给我的感觉不是"替代"，而是"加速"——它把那些重复的、模板化的、需要查文档的工作压缩到了分钟级别，让我能把精力集中在产品设计和核心逻辑上。
1. Demo 简介
-
是什么： 一款面向 Minecraft Fabric 模组开发的 AI 原生桌面应用（Electron 客户端）。
-
面向谁： Minecraft 模组开发者、游戏爱好者、编程初学者，特别是那些想制作模组但缺乏 Java 编程经验的玩家。
-
主要功能：
-
项目选择 — 提供 7 种预设模板（自定义方块、物品、食物、实体、工具、护甲、配方），点击即可开始模组创建流程，自动触发 AI 澄清提问获取必要信息
-
AI 对话开发 — 通过自然语言描述模组功能，AI 自动生成结构化实施计划和代码，支持实时代码解释，提供消息级版本回滚功能
-
快速模板匹配 — 动态展示模组代码结构和合成配方可视化，支持 3D 方块渲染和物品选择交互，滚动位置自动保存
-
快速模板匹配 — 点击模板后弹出信息补全面板，支持中文名称自动生成英文 ID，特殊属性支持自定义输入
-
代码编辑器 — 实时展示生成的模组代码
-
设置面板 — 配置开发环境和 AI 参数
-
项目构建和游戏测试运行 — 展示项目信息和版本
-
2. Demo 创作思路
-
灵感来源： 作为一个 Minecraft 老玩家，我一直羡慕那些能自己写模组的大佬。每次在 CurseForge 和 Modrinth 上看到各种创意十足的模组，我都想：如果我能把自己脑子里的想法也变成模组该多好？但现实是，想做一个模组不仅要学 Java，还要搞懂 Gradle 构建、Fabric API、注册系统、数据生成……光是配置开发环境就能劝退一大半人。这让我萌生了一个念头：能不能让 AI 来帮我们搞定这些繁琐的技术细节，而我们只需要专注于创意本身？
-
想解决的问题：
编程门槛过高： 大多数 Minecraft 玩家没有 Java 编程基础，即便有编程经验的也需要花大量时间学习 Fabric 框架的 API 和约定。模组开发的入门资料分散且陈旧，新手往往在环境搭建阶段就放弃了。
开发流程繁琐： 创建一个最简单的方块需要修改多个文件、注册纹理、编写 JSON 模型、设置战利品表……这些重复性的工作占据了大量时间，让开发者无法专注于核心玩法的设计。
调试反馈迟缓： 传统模组开发需要经过"编写代码 → 构建 → 启动游戏 → 测试 → 发现问题 → 关游戏 → 修改代码"的漫长循环，每次迭代都需要等待 Gradle 构建和 Minecraft 加载，效率极低。
缺乏可视化引导： 新手面对一堆代码文件和配置文件时往往不知所措，不知道哪些是必需的、哪些可以省略、各个文件之间的关联是什么。没有一个直观的方式来预览和理解模组的结构。
-
为什么做这个方向：
AI 的天然优势： 模组开发中的大量工作其实是有规律的模板化操作——注册物品、生成 JSON、配置配方等，这些恰恰是 AI 最擅长的领域。让 AI 处理这些重复性工作，能把人类开发者解放出来专注于创意设计，这是 AI + 游戏开发的绝佳结合点。
社区需求真实存在： 在 Minecraft 中文社区的各大论坛和群组中，"求教怎么做模组"是最常见的问题之一。大量的创意因为技术门槛而被搁置，这不仅是玩家的损失，也是整个社区的损失。ModCrafting 想做的就是搭一座桥，让创意和技术之间不再有鸿沟。
技术可行性验证： 在动手开发之前，我专门研究过 LLM 生成 Fabric 模组代码的能力。Claude 和 GPT-4 等模型对 Fabric API 有相当程度的了解，能够生成符合规范的注册代码、JSON 模型文件和合成配方。这意味着用 AI 辅助模组开发不是天方夜谭，而是完全可行的方向。
选择 Fabric 而非 Forge： Fabric 的 API 设计更加模块化和轻量，学习曲线比 Forge 平缓，且社区活跃、更新及时。对于 AI 辅助开发场景，Fabric 简洁的 API 和规范的项目结构更便于 AI 理解和生成代码。
3. Demo 体验地址（三选一）
-
开源项目地址：
-
视频链接：
抖音视频链接：https://v.douyin.com/cExcYL7rQrg/Bilibili视频链接：https://www.bilibili.com/video/BV12tN46iEEA/?share_source=copy_web&vd_source=29eae74d503b57b863da994f05f82546
4. TRAE 实践过程
TRAE 帮助实现了模组模板市场的交互逻辑，包括 7 种模板类型（自定义方块、物品、食物、实体、工具、护甲、配方）的点击事件处理，通过 ChatPanelRef 接口的 handleTemplateSelect 方法暴露模板选择处理逻辑，并实现了防护检查（isLoading、clarificationPending、toolchainReady、projectPath、apiKey）防止重复操作。
Session ID: .1528737997785040:4dfcad378445f40d55d5bb0366d1088e_6a4e110292c0dda9edb6ce76.6a4e332692c0dda9edb6d15c.6a4e33268a5f3524084807e9:Trae CN.T(2026/7/8 19:23:18)
最初模板生成的提示词仅含占位词导致无法生成可实际使用的模组。TRAE 帮助整合澄清提问工具，设计了详细的提问指令，并修复了多次 ask_clarification 调用导致消息分节和对话异常终止的问题，添加了 MAX_CLARIFICATION_ROUNDS=1 限制，确保 AI 使用一次 ask_clarification 调用将所有问题合并在 question 字段中一次性提出。
Session ID: .1528737997785040:456337bd66bc2d75c35b5560b0fdafa6_6a4e110292c0dda9edb6ce76.6a4e36a392c0dda9edb6d1fa.6a4e36a28a5f3524084807ec:Trae CN.T(2026/7/8 19:38:11)
TRAE 帮助实现了方块的 3D 渲染功能，使用 CSS 3D Transforms 创建立方体实现 3D 效果，方块六个面分别应用对应的纹理，固定视角约 20° 俯视、35° 旋转模拟 MC 掉落物效果。重点修复了 cube_all 模型的 all 纹理键处理问题、木头类方块使用 end 而非 top/bottom 作为纹理键的问题，以及台阶和楼梯等非立方体模型的 fallback 机制。
Session ID: .1528737997785040:bbc49b4a51b255c54b1f932fbe1ffe3f_6a4e110292c0dda9edb6ce76.6a4e42c992c0dda9edb6d32b.6a4e42c88a5f3524084807f0:Trae CN.T(2026/7/8 20:30:01)
TRAE 帮助实现了消息级代码版本管理功能，通过 FileSnapshot 接口记录文件快照，SessionStateSnapshot 接口记录会话状态快照，在 TurnDone 事件中捕获状态快照，handleRollback 函数可恢复代码文件、消息历史和实时状态，并实现了回滚警告面板和消息返还到对话输入框的功能。
Session ID: .1528737997785040:be5d90332067f902df9522469ee8e14e_6a4f5cdaeef039152ae40d9b.6a4f5d38eef039152ae40d9d.6a4f5d38449fb2d9c10ad33d:Trae CN.T(2026/7/9 16:35:04)
Session ID: .1528737997785040:2dd93b58c40da50e667468262df15ff4_6a4f5cdaeef039152ae40d9b.6a4f5fa4eef039152ae40eb3.6a4f5fa4449fb2d9c10ad33e:Trae CN.T(2026/7/9 16:45:24)
后续进行了界面优化与功能完善，进一步提升产品的用户体验。
Session ID: .1528737997785040:c4b0e215d22d65ccb968ed143ec2a860_6a50f89e12583c28d61b05b2.6a50f91912583c28d61b05b4.6a50f9177f78b623aa01a5b1:Trae CN.T(2026/7/10 21:52:25)
5. 对应的报名审核通过的帖子链接
6. 版权声明
-
开源许可证: ModCrafting 项目源码以 GPL-3.0 许可证发布。
-
版权合规说明:
-
与 Minecraft / Mojang 无关: ModCrafting 与 Mojang / Microsoft 无任何官方关联。本软件不包含 Minecraft 游戏本体，用户需自行拥有合法的 Minecraft 游戏副本，并遵守 Minecraft 最终用户许可协议。
-
第三方组件合规: 项目使用的第三方开源组件（Electron、React、Vite、Gradle、Fabric API 等）均已在 THIRD_PARTY.md 中注明许可信息，符合各自许可证要求。
-
资源文件说明: 安装包中捆绑的 JDK、Gradle 和 Fabric 依赖缓存种子，仅用于提供离线开发环境，不涉及版权侵权。用户可随时替换为自行下载的官方版本。
-
原创性保证: 项目源码为原创开发，不存在抄袭或侵权问题。
-