Jundot Engine 文档

快速入门

用一个测试项目熟悉 Jundot 的核心流程:用户可以在项目管理器界面直接和 AI 交流,描述游戏想法,让 AI 整理项目方向并自动生成项目;进入编辑器后,AI 会先创建一个可运行的 HTML 游戏原型,供玩家审核和验证。玩家确认玩法方向通过后,AI 再把原型转换成 C# 游戏项目,并继续细化场景、脚本、UI 和资源。如果当前引擎能完成,就只改项目;如果当前引擎做不到,再进入受控的引擎改动流程。

快速入门重点

Jundot 的 AI 流程从项目管理器开始,不是必须先手动创建空项目再进入编辑器。你可以先和 AI 聊清楚想做什么,再让 AI 自动创建一个可继续迭代的项目。进入编辑器后,推荐先生成可运行 HTML 游戏原型,通过玩家审核后再转换成 C# 游戏。

准备工作

  • 已完成 安装指南 中的启动验证。
  • 准备一个空目录用于测试项目。
  • 如需使用 AI,已配置 AI 服务地址和 API Key。
  • 建议安装 Git,用于保存 AI 修改前后的项目状态。

生成项目演示

生成项目演示

演示在项目管理器中和 AI 交流,并生成项目的基础流程。

第一次使用

  1. 下载并启动 Jundot Engine。
  2. 进入项目管理器,在 AI 输入区描述你想做的游戏。
  3. 让 AI 总结项目类型、主题、核心玩法、项目名称和第一版范围。
  4. 确认方向后,让 AI 自动创建项目。
  5. 进入编辑器后,让 AI 先创建一个可运行的 HTML 游戏原型。
  6. 试玩 HTML 原型,审核玩法、操作、节奏和界面反馈。
  7. 玩家确认原型通过后,让 AI 转换成 C# 游戏项目。
  8. 继续在 AI Assistant 面板中细化场景、脚本、UI 和资源。
  9. 运行项目,检查结果,把报错、截图或玩法反馈继续交给 AI。
  10. 确认可用后,可以让 AI 整理修改、提交并上传到 GitHub。

在项目管理器里让 AI 生成项目

启动 Jundot 后,第一步可以不是手动点击“创建”再填写所有项目细节,而是先在项目管理器里告诉 AI 你想做什么。AI 会帮你把模糊想法整理成一个能开始制作的项目方向。

适合在项目管理器里交给 AI 的内容包括:

  • 根据一句话想法生成项目名称和项目方向。
  • 整理游戏类型、主题、核心玩法和第一版目标。
  • 判断第一版应该先做哪些场景、脚本和 UI。
  • 自动创建项目,并把项目意图带入后续编辑器 AI 对话。

示例输入:

我想做一个霓虹餐厅经营小游戏,玩家接单、做菜、赚金币、升级店铺。帮我整理项目方向,并自动创建一个可继续迭代的项目。

手动创建或导入项目

如果你暂时不想通过 AI 创建项目,也可以使用传统方式:

  1. 启动 Jundot,进入项目管理器。
  2. 点击“创建”或“导入”。
  3. 选择项目目录和项目名称。
  4. 进入编辑器后,先保存一个初始场景。
  5. 如果使用 Git,先提交一次初始状态。

认识编辑器区域

  • 场景树:管理当前场景里的节点层级。
  • 视口:编辑 2D/3D 场景。
  • 检查器:查看和修改节点属性。
  • 文件系统:管理 res:// 项目资源。
  • AI Assistant:在右侧或底部面板中进行聊天、项目修改和工具调用。

先生成可运行 HTML 游戏原型

项目创建后,编辑器内的推荐流程是先做 HTML 游戏原型。HTML 原型用于快速验证玩法是否成立、操作是否顺手、UI 是否清楚,而不是一开始就直接写正式 C# 游戏代码。

先做一个可以直接运行的 HTML 游戏原型。玩家可以试玩核心循环,确认玩法方向后,再转换成 C# 游戏项目。

玩家审核时重点看:

  • 核心玩法是否能跑起来。
  • 操作、反馈和节奏是否符合预期。
  • 界面信息是否清楚,没有明显遮挡或重叠。
  • 哪些规则需要调整,哪些内容可以进入 C# 项目实现。

审核通过后转换成 C# 游戏

当玩家确认 HTML 原型方向通过后,再让 AI 把原型转换成 Jundot/Godot 的 C# 游戏项目。转换时应保留已经验证过的玩法规则、交互节奏、UI 结构和验收标准。

HTML 原型方向已经确认。请把它转换成 C# 游戏项目,保留核心玩法和 UI 反馈,并在完成后检查脚本错误。

第一次让 AI 细化项目

C# 项目生成后,可以让 AI 先读取项目结构,再决定下一步实现内容:

请先查看这个项目结构,然后告诉我当前适合先创建什么场景。

也可以让 AI 直接创建一个最小可运行版本:

创建一个最小 2D 测试场景:一个玩家方块、一个地面、左右移动和跳跃脚本。完成后检查脚本错误。
好的提问方式

把游戏类型、主题、核心玩法、控制方式和验收标准说清楚。比如“先做一个可运行原型”“如果现有引擎能完成就不要改引擎”“如果必须改引擎,先说明原因和影响”。

和 AI 细化项目

第一个版本跑起来后,继续和 AI 细化:

把玩家手感调得更轻快。
增加一个敌人和简单巡逻逻辑。
做一个开始菜单和失败重试界面。
检查 UI 有没有重叠,脚本有没有错误。

每次迭代都建议让 AI 说明它改了什么,以及如何验证。

验证并上传修改

  1. 查看 AI 修改了哪些文件和场景。
  2. 保存场景并运行项目。
  3. 如果出现错误,把完整错误信息发回 AI Assistant。
  4. 让 AI 根据真实报错继续修复,而不是重新猜测。
  5. 用户确认可运行后,可以让 AI 提交并上传到 GitHub。

当 AI 认为需要改引擎

项目功能优先在项目内解决。只有当当前引擎能力确实无法满足项目需求时,才进入引擎改动流程。

推荐让 AI 先输出:

  • 为什么项目层无法解决。
  • 需要改哪些引擎模块。
  • 对当前项目的收益和维护成本。
  • 如何验证改动没有破坏其他项目。
  • 这个能力是否足够通用,是否值得整理进主引擎。

下一步

  • AI 助手 — 了解模式、工具和安全边界。
  • 脚本 API — 查看 Jundot 与 Godot API 的关系。
  • 更新与发布 — 了解 Package Builder 和 Launcher。