• 产品手册
  • 编辑器功能手册
  • AI
  • AI辅助开发

使用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能帮你做什么:

  1. 整理当前代码
  2. 自动修bug
  3. 创建物编、UI、对UI进行简单美化
  4. 写游戏逻辑
  5. 帮你了解Y3编辑器

使用示例——在codemaker的聊天框输入你想要让AI实现的需求,例如:

  • 帮我生成20个单位物编,10个小怪5个boss5个英雄,西幻风格,其中小怪5个近战5个远程,英雄3近战2远程,boss都是近战
  • 帮我美化一下现有UI,所有文本居中,标题字体加粗
  • 帮我写一个刷怪逻辑,20s刷新一波小怪,每5波额外出一个boss,从四面八方来进攻玩家

注意:内容越具体,生成的越符合预期,但尽量不要提太大的需求。当需求比较大时可以让AI帮你拆分,之后逐步执行

新增内容

  1. 对于编辑器UI、物编内容的热更,通过ai修改json文件后不用重开编辑器能直接看到结果
  2. 游戏窗口截图,方便ai自动验证结果
  3. 获取编辑器日志和游戏日志,了解地图情况,ai帮你修bug、解决地图损坏问题
  4. lua静态检测,提早发现脚本中的问题,提升开发效率
  5. 官方知识库,在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批量下载声音资源