快速入门
用一个测试项目熟悉 Jundot 的核心流程:用户可以在项目管理器界面直接和 AI 交流,描述游戏想法,让 AI 整理项目方向并自动生成项目;进入编辑器后,AI 会先创建一个可运行的 HTML 游戏原型,供玩家审核和验证。玩家确认玩法方向通过后,AI 再把原型转换成 C# 游戏项目,并继续细化场景、脚本、UI 和资源。如果当前引擎能完成,就只改项目;如果当前引擎做不到,再进入受控的引擎改动流程。
Jundot 的 AI 流程从项目管理器开始,不是必须先手动创建空项目再进入编辑器。你可以先和 AI 聊清楚想做什么,再让 AI 自动创建一个可继续迭代的项目。进入编辑器后,推荐先生成可运行 HTML 游戏原型,通过玩家审核后再转换成 C# 游戏。
准备工作
- 已完成 安装指南 中的启动验证。
- 准备一个空目录用于测试项目。
- 如需使用 AI,已配置 AI 服务地址和 API Key。
- 建议安装 Git,用于保存 AI 修改前后的项目状态。
生成项目演示
生成项目演示
演示在项目管理器中和 AI 交流,并生成项目的基础流程。
第一次使用
- 下载并启动 Jundot Engine。
- 进入项目管理器,在 AI 输入区描述你想做的游戏。
- 让 AI 总结项目类型、主题、核心玩法、项目名称和第一版范围。
- 确认方向后,让 AI 自动创建项目。
- 进入编辑器后,让 AI 先创建一个可运行的 HTML 游戏原型。
- 试玩 HTML 原型,审核玩法、操作、节奏和界面反馈。
- 玩家确认原型通过后,让 AI 转换成 C# 游戏项目。
- 继续在 AI Assistant 面板中细化场景、脚本、UI 和资源。
- 运行项目,检查结果,把报错、截图或玩法反馈继续交给 AI。
- 确认可用后,可以让 AI 整理修改、提交并上传到 GitHub。
在项目管理器里让 AI 生成项目
启动 Jundot 后,第一步可以不是手动点击“创建”再填写所有项目细节,而是先在项目管理器里告诉 AI 你想做什么。AI 会帮你把模糊想法整理成一个能开始制作的项目方向。
适合在项目管理器里交给 AI 的内容包括:
- 根据一句话想法生成项目名称和项目方向。
- 整理游戏类型、主题、核心玩法和第一版目标。
- 判断第一版应该先做哪些场景、脚本和 UI。
- 自动创建项目,并把项目意图带入后续编辑器 AI 对话。
示例输入:
我想做一个霓虹餐厅经营小游戏,玩家接单、做菜、赚金币、升级店铺。帮我整理项目方向,并自动创建一个可继续迭代的项目。
手动创建或导入项目
如果你暂时不想通过 AI 创建项目,也可以使用传统方式:
- 启动 Jundot,进入项目管理器。
- 点击“创建”或“导入”。
- 选择项目目录和项目名称。
- 进入编辑器后,先保存一个初始场景。
- 如果使用 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 说明它改了什么,以及如何验证。
验证并上传修改
- 查看 AI 修改了哪些文件和场景。
- 保存场景并运行项目。
- 如果出现错误,把完整错误信息发回 AI Assistant。
- 让 AI 根据真实报错继续修复,而不是重新猜测。
- 用户确认可运行后,可以让 AI 提交并上传到 GitHub。
当 AI 认为需要改引擎
项目功能优先在项目内解决。只有当当前引擎能力确实无法满足项目需求时,才进入引擎改动流程。
推荐让 AI 先输出:
- 为什么项目层无法解决。
- 需要改哪些引擎模块。
- 对当前项目的收益和维护成本。
- 如何验证改动没有破坏其他项目。
- 这个能力是否足够通用,是否值得整理进主引擎。