使用Y3开发助手进行AI辅助开发
配置流程
安装VSCode后,打开VSCode,在插件库中找到Y3开发助手并安装

由于不同服务商使用的协议不同,我们提供了两种协议选择,但是需要填写的内容都是一致的

在y3helper设置中搜索codemaker,随后根据自己购买的第三方AI服务商接口配置API地址和key,之后即可开始使用(api地址和KEY需要用户自己获取)

注意:部分服务商提供的key需要对应模型才能生效,需要再填写一下具体模型,推荐使用如GPT5.4等高性能模型。

开始开发
用Y3开发助手打开需要用AI参与制作的项目

选择打开codemaker,呼出聊天框,之后即可开始使用AI辅助开发

如果项目不使用lua,或未曾在地图项目中导入y3库,需要重新初始化一下项目(推荐配合新建项目使用Y3开发助手)

使用指南
对于项目中已经使用lua编写逻辑的用户,我们提供了知识库和一些常用的skills,可以用来优化之前的代码提高效率。
对于新工程,Y3助手可以帮助创建基础的物编、UI、批量修改json文件、对ui进行基础美化、编写游戏逻辑。
AI能帮你做什么:
- 整理当前代码
- 自动修bug
- 创建物编、UI、对UI进行简单美化
- 写游戏逻辑
- 帮你了解Y3编辑器
使用示例——在codemaker的聊天框输入你想要让AI实现的需求,例如:
- 帮我生成20个单位物编,10个小怪5个boss5个英雄,西幻风格,其中小怪5个近战5个远程,英雄3近战2远程,boss都是近战
- 帮我美化一下现有UI,所有文本居中,标题字体加粗
- 帮我写一个刷怪逻辑,20s刷新一波小怪,每5波额外出一个boss,从四面八方来进攻玩家
注意:内容越具体,生成的越符合预期,但尽量不要提太大的需求。当需求比较大时可以让AI帮你拆分,之后逐步执行
新增内容
- 对于编辑器UI、物编内容的热更,通过ai修改json文件后不用重开编辑器能直接看到结果
- 游戏窗口截图,方便ai自动验证结果
- 获取编辑器日志和游戏日志,了解地图情况,ai帮你修bug、解决地图损坏问题
- lua静态检测,提早发现脚本中的问题,提升开发效率
- 官方知识库,在ai在使用Y3制作内容时效率大大提升
MCP
Y3助手中通过MCP协议,额外增加了这些skill,AI会自动根据任务需求的场景调用相关的skill。
你也可以在任务中手动指定希望AI调用的skill。
UI 预览与调试
| MCP 工具 | 功能说明 | 传统方式对比 |
|---|---|---|
preview_ui | 在编辑器中预览指定 UI 文件 | 原来需要手动打开 UI 编辑器查看 |
screenshot_ui_preview | 截取 UI 预览画面 | AI 可以看到 UI 渲染效果,自动判断布局正确性 |
run_game_and_screenshot | 切换到指定 UI layer 并截图 | 原来需要手动在编辑器中切换和截图 |
delete_screenshot | 删除临时截图文件 | 清理临时资源 |
编辑器控制
| MCP 工具 | 功能说明 | 传统方式对比 |
|---|---|---|
hotfix_ui_editor | 热更 UI 编辑器 | 修改 UI JSON 后即时生效,无需重启 |
hotfix_object_editor | 热更物编 | 修改物编 JSON 后即时生效 |
save_editor | 保存编辑器 | 确保修改不丢失 |
get_editor_log | 获取编辑器日志 | 调试编辑器问题 |
官方资源管理
| MCP 工具 | 功能说明 |
|---|---|
get_official_editor_model | 根据 ID 查询官方模型资源详细信息 |
get_official_editor_sound | 根据 ID 查询官方声音资源详细信息 |
get_official_editor_effect | 根据 ID 查询官方特效资源详细信息 |
get_official_editor_icon | 根据 ID 查询官方图标资源详细信息 |
get_official_resource_associate_match | 查询资源的配套素材(素材联想) |
download_editor_model_resource | 批量下载模型资源 |
download_editor_effect_resource | 批量下载特效资源 |
download_editor_icon_resource | 批量下载图标资源 |
download_editor_sound_resource | 批量下载声音资源 |

