LayaIdea 使用说明
1、工具清单
Section titled “1、工具清单”1.1 下载并安装 LayaAir 3.3.9
Section titled “1.1 下载并安装 LayaAir 3.3.9”1.2 功能演示视频
Section titled “1.2 功能演示视频”2、项目创建与插件安装
Section titled “2、项目创建与插件安装”2.1 创建空白项目
Section titled “2.1 创建空白项目”使用 LayaAir 3.3.9 或以上版本，按需创建项目（例如：选择3D空白项目）。
（图1-1）
2.2 获取 LayaIdea 插件
Section titled “2.2 获取 LayaIdea 插件”访问链接地址，到 IDE资源商店 购买以下插件并【添加至我的资源】。
（图2-1）
点击右上角导航按钮【已购资源】，查看是否已经包含了 LayaIdea 插件，插件右侧有更新提示的，需要点击一下更新按钮，将插件更新至最新版本。
（图2-2）
2.3 安装插件
Section titled “2.3 安装插件”然后在IDE的 开发者——包管理器 顺序安装插件。
上一步没点更新且已经购买过的，这里也会出现更新按钮需要点击一下更新/安装。
（图3-1）
LayaIdea：组件安装过程需要消耗几分钟，请耐心等待。安装完成后IDE布局会自动刷新，当界面右侧的 LayaIdea 聊天窗口（下图左）出现 logo 时，确认为安装完成。
首次安装的用户（未配置过 API_KEY）会出现右侧图中的情况，需要获取并输入 API_KEY 后开始使用。
| 配置过 API_KEY 的用户 | 未配置过 API_KEY 的用户 |
|---|---|
 |  |
（图3-2）（图3-3）
2.4 获取 API_KEY
Section titled “2.4 获取 API_KEY”按上图所示，点击 获取 LayaIdea API_KEY 文字链按钮：
API_KEY 的获取入口如下图所示，有2个，都可以进入。
在接口密钥界面，点击 新建 API_KEY 即可获取，然后将复制到的 API_KEY 回填至IDE界面中的输入框内。
| 
| 
|
（图4-1）（图4-2）
注意：API_KEY 是你访问 LayaBox 所有服务的凭证。请妥善保管，API_KEY 明文仅在创建时展示一次。
新用户配置完 API_KEY 需要刷新 IDE，Alt+Ctrl+R 进行刷新，也可以依次点击顶部菜单栏【开发者——刷新编辑器】。
（图4-3）
2.5 查看项目设置（建议）
Section titled “2.5 查看项目设置（建议）”2.5.1 检查 MCP 工具连接情况
Section titled “2.5.1 检查 MCP 工具连接情况”项目设置：通过顶部菜单选择【文件——项目设置】进入（Mac版入口略有不同）。
在 MCP Tools 中，查看各项服务的连接状态。正常情况下应该包含3项服务，且都处于正常连接状态，说明配置成功。如遇显示异常可尝试重新刷新一次编辑器。
- Ide-tools
- Laya-ide-mcp-server
- laya_mcp_server
（图5-1）
2.5.2 运行配置
Section titled “2.5.2 运行配置”根据项目的实际需求，在【运行配置】中，按需设置好当前项目的分辨率尺寸及横竖屏设置等属性。
（图5-2）
2.5.3 引擎模块
Section titled “2.5.3 引擎模块”在【引擎模块】中，勾选当前项目需要用到的2D和3D相关模块属性。
例如：在2D和3D分类中，按需勾选开发可能用到的引擎库。
例如：3D粒子、3D物理等。
（图5-3）
3、使用 LayaIdea 的 AI 功能
Section titled “3、使用 LayaIdea 的 AI 功能”3.1 服务订阅与代币充值
Section titled “3.1 服务订阅与代币充值”3.1.1 查看/订阅
Section titled “3.1.1 查看/订阅”点击工作区右上角的【查看/订阅】文字链按钮，可进行功能的开通或查看相应服务信息。
（图6-1）
3.1.2 代币充值
Section titled “3.1.2 代币充值”代币作为本平台内使用AI功能的消耗品（类似其它AI服务的 Token），有多种获取渠道：
- 充值获取代币：点击管理平台界面右上角的充值按钮，可进入代币充值界面。
- 订阅赠送通用代币：部分平台提供的订阅服务，会赠送一定数额的通用代币，这种通用代币可以用于平台内各种消耗代币的服务。
- 代币扣除规则：赠送的通用代币 ＞ 充值获取的代币。
| 
| 
|
（图6-2）（图6-3）
3.2 模式切换
Section titled “3.2 模式切换”3.2.1 模式切换按钮
Section titled “3.2.1 模式切换按钮”- 位置：顶部标题栏右侧
- 样式：齿轮图标按钮
- 默认状态：首次使用时默认为普通模式
（图7-1）
3.2.2 模式特性对比
Section titled “3.2.2 模式特性对比”点击图片可查看完整电子表格。
3.3 普通模式
Section titled “3.3 普通模式”普通模式时，可使用【AI生成2D图片】和【AI生成3D模型】技能。
（图8-1）
普通模式，聊天底部的指令入口与技能选项列表。
3.4 专业模式功能界面说明
Section titled “3.4 专业模式功能界面说明”
（图9-1）
专业模式时，增加一个 # 功能，可以自定义快捷指令。
/ 技能会显示全部技能列表。
右侧可看到一个蓝色侧边按钮，鼠标移动到上面时会显示 设置偏好、需求分析、资源管理 3个功能入口。
（图9-2）
3.4.1 设置偏好
Section titled “3.4.1 设置偏好”可根据自身使用习惯进行设置，设置完毕时，需要点击 保存设置 完成设置。
切换模型设置时，保存设置 按钮会变为 重启IDE后生效，点击即可立即重启。
| 
| 
|
（图10-1）（图10-2）
3.4.1.1 支持智谱 Coding Plan
Section titled “3.4.1.1 支持智谱 Coding Plan”全新支持 智谱 Coding Plan · GLM-5.1。
3.4.2 需求分析
Section titled “3.4.2 需求分析”需求分析模块用于帮助用户分析游戏需求，生成结构化需求文档，并提供相关配置选项，支持多种分析深度选择。
方式1：
点击右侧悬浮按钮中的 📋 图标，进入界面之后 双击编辑区域，输入需求后点击 保存需求。
然后在底部聊天窗口输入 /build，或者点击底部的 / 按钮，选择箭头所示技能，发送给聊天就可以自动开始你的游戏制作了。
| 
| 
|
（图11-1）（图11-2）
方式2：
在聊天输入框中输入带”需求”相关的文本内容，发送给聊天。例如：
我要制作一个游戏，需求如下：xxxxx......。请先帮我细化一下游戏需求。帮我生成一个游戏，需求如下：xxxxx......。
（图11-3）
3.4.3 资源管理
Section titled “3.4.3 资源管理”点击 资源管理 按钮可打开资源管理弹窗，专注于帮助用户导入、替换和优化游戏资源，支持配置批量导入方式，由AI自动进行匹配，提高资源管理效率。
3.4.3.1 打开资源列表
Section titled “3.4.3.1 打开资源列表”点击右侧悬浮按钮中的 📦 图标，可以打开资源管理界面。
3.4.3.2 配置对标方式
Section titled “3.4.3.2 配置对标方式”在资源管理界面底部点击【批量对标资源】按钮。
| 
| 
|
（图12-1）（图12-2）
3.4.3.3 匹配商店资源（默认启用）
Section titled “3.4.3.3 匹配商店资源（默认启用）”- 自动下载：在 匹配商店资源 为启用状态下，AI会根据实际需求自动分析是否下载商店资源进行场景搭建。
- 按需下载：在与AI的对话中，明确要求资源从商店中下载。
例如：我需要一棵树摆放到场景中，资源从商店中下载。
3.4.3.4 匹配本地资源（默认启用）
Section titled “3.4.3.4 匹配本地资源（默认启用）”如果已有本地资源，需要在发送需求前进行配置。在批量对标资源界面，点击 选择目录 绑定本地存放资源的目录。
绑定成功后，会显示绑定的目录地址。
在 匹配本地资源 为启用状态，且绑定了本地资源目录的情况下，AI会优先从绑定的目录内选取适合的素材应用到游戏中。
（图12-3）
本地资源的其它使用方式
Section titled “本地资源的其它使用方式”方式1：直接将资源拖到 resources 图标处
如果自己有准备好的资源，需要输入需求前将资源放入 resources 文件夹内。这样是最直接的方式。
将已经准备好的游戏素材，包含模型、特效、图片、Spine动画、音乐音效等资源，整体放入项目根目录下的 resources 文件夹内。
方式2：右键点击目录图标，在展开菜单中选择 在文件管理器中打开，通过复制粘贴的方式将本地资源存放到 resources 文件内。
（图12-4）
3.4.3.5 开始对标按钮
Section titled “3.4.3.5 开始对标按钮”主动发起一次对标，重新进行资源与需求功能的匹配，将满足需求的资源从商店或本地目录中，添加到项目资源目录。
- aigc_res：用于存放用户通过资源技能或AI生成资源窗口内下载的资源。
- downloads：用于存放从资源商店下载的资源。
- match：用于存放从本地资源目录匹配成功后拷贝过来的资源。
（图12-5）
3.4.4 资源替换
Section titled “3.4.4 资源替换”
（图13-1）
在AI执行标准工作流进行游戏构建时，会附带生成一份资源列表。
用户可以按需进行资源替换操作。
注意：在替换模型资源时，需要先点击 导入贴图 按钮，将模型贴图导入。
先替换模型后导入贴图，会显示为白模状态。此时需要右键选中模型的源文件，在右键菜单中进行2次操作：
- 步骤1. 重新导入：此操作执行后，选中的模型源文件右侧属性窗口应该就可以看到带贴图的效果了。
- 步骤2. 提取模型内部资源：如果实际使用的不是源文件，而是提取后的预制体文件，则需要此操作。
| 
| 
|
（图13-2）（图13-3）
3.5 聊天交互功能
Section titled “3.5 聊天交互功能”3.5.1 发送消息
Section titled “3.5.1 发送消息”在输入框中输入文本内容，点击发送按钮（➤）发送消息，AI会开始分析你所提出的需求，然后执行或反馈。
点击对话窗口中已经发送的消息文本，下方会出现编辑和重新发送选项按钮。
- 编辑：重新编辑消息内容。
- 重新发送：重新发送一次消息，本操作会重置本条消息下方的所有聊天内容。
（图14-1）
3.5.2 回复消息
Section titled “3.5.2 回复消息”点击AI回复的消息面板，会在聊天底部展示4个交互按钮：
- 复制：将当前 AI 回复的文本内容一键复制到剪贴板。
- 撤销：删除/隐藏当前这条 AI 回复，让对话回到上一条消息状态。
- 继续生成：当 AI 回复因长度限制被截断时，点击后让 AI 从断点处继续输出剩余内容。
- 重新生成：基于相同的用户提问，让 AI 重新构思并输出一个全新版本的回复。
注意：重新生成会覆盖当前已有的回复内容。
（图14-2）
3.5.3 辅助输入功能
Section titled “3.5.3 辅助输入功能”操作：点击底部操作栏左侧的 @ 图标，系统会在当前光标位置自动插入 @ 符号，并向上展开文件列表，点选列表中的文件，可在聊天输入框内插入一条该文件的引用块，通过键盘 [backspace] 按键可删除此引用块。
作用：提供精确的上下文（Context）和建立明确的指向性，合理控制 Token 消耗，提高AI效率。
下图示例中为输入 @p 之后，自动检索匹配可引用的文件，在列表中展示。
| 输入时 | 输入完毕后 |
|---|---|
 |  |
（图15-1）（图15-2）
（图15-3）
操作：在场景节点或项目资源目录下点选任意位置时，右边聊天窗口会激活一个引用按钮（旋转的绿色虚线圆圈），点击之后直接在聊天内插入所选对象的引用。
作用：与 @ 功能的作用相同，只是引用的内容类型不同。
# 自定义快捷指令
Section titled “# 自定义快捷指令”点击聊天底部的 #，在展开的快捷指令列表标题栏右侧，点击 + 按钮，弹出自定义快捷指令弹窗。
- 弹窗内容：包含指令名称输入框、指令内容输入框（发送给AI的提示词）、取消/删除按钮和保存按钮。
- 编辑功能：自定义指令条目右侧显示编辑图标，点击后打开该条指令的编辑弹窗。
- 删除功能：点击删除按钮，删除当前指令。
- 保存功能：点击保存按钮后，系统会保存自定义指令并显示保存成功的提示信息。
- 数量限制：当前版本最多可添加10条自定义快捷指令。
点击自定义快捷指令时，可以将指令内容快速插入到聊天输入框中，用户可以进行二次编辑或直接发送给AI。
| 
| 
|
（图16-1）（图16-2）
点击聊天框底部的【/】或者在聊天窗口输入 / ，都可打开技能列表，按需选择所需技能进行目标任务的执行。
技能列表中包含【3D模型生成】和【2D图片生成】两个AI生成技能，每个技能下包含所有可选大模型列表。
选择生成技能后，聊天标题框和输入框中间会插入一条显示卡片，包含技能名称卡片和模型选择列表。
技能退出方式：
- 普通
/技能，按键盘[backspace]键删除。 - 资源生成技能，点击技能名称右侧X号。
| 
| 
|
（图16-3）（图16-4）
操作：点击底部操作栏左侧的🖼️图标，系统会打开文件选择器。
作用：将图片作为上下文发送给AI，支持同时发送多张图片。
（图16-5）
3.6 AI生成美术资源
Section titled “3.6 AI生成美术资源”3.6.1 聊天窗口使用 / 技能生成
Section titled “3.6.1 聊天窗口使用 / 技能生成”
（图17-1）
通过 / 技能选择对应的AI生成技能后，即可在聊天窗口中进行资源生成：
根据所选类型，可以输入文本或图片等提示内容进行相应资源生成。
根据所选模型不同，UI上会有区别。
2D图片生成
Section titled “2D图片生成”
（图17-2）
文生图：支持同时输入提示词和上传多张参考图。
3D模型生成
Section titled “3D模型生成”3D模型生成包含以下几种模式：
- 文生模型：通过输入文字提示词生成3D模型。
- 单图片生成模型：点击【+】号按钮，上传1张参考图片即可生成对应3D模型。
- 多视图生成模型：支持上传4张参考图片来生成3D模型。
已上传的图片会依次排列展示，达到当前模型的图片数量上限后，上传按钮将自动隐藏。
（图17-3）
3.6.2 专业生成模式
Section titled “3.6.2 专业生成模式”点击聊天底部功能栏中的 专业生成模式 按钮，可打开独立的资源生成界面。在该界面中可以使用完整的生成参数进行精细控制。
（图18-1）
（图18-2）
生成按钮上显示本次生成的费用信息。
- 预览资源：点击历史条目中左侧的资源图标，可以在预览窗口中查看资源详情。
- 复制提示词：点击历史条目中右侧的辅助按钮。
- 下载资源：点击历史条目中右侧的辅助按钮，下载到项目资源目录下的【aigc_res】文件夹内。
注意：目前历史记录仅保留2天，请在资源生成完毕后及时下载。
| 
| 
|
（图18-3）（图18-4）
3.6.3 生成结果
Section titled “3.6.3 生成结果”发起生成任务后，聊天窗口中会显示一张生成进度卡片，生成过程中可继续进行其他对话操作。
生成完成后会弹出通知提示，点击即可快速跳转到对应的生成结果位置。
- 图片可以在预览窗口中放大、缩小、拖动查看。
- 模型可以在预览窗口中放大、缩小、拖动、旋转查看。
（图19-1）
聊天窗口中，资源生成完成后，缩略图的右下角出现 下载 按钮，点击可以将资源下载到项目资源目录下的【aigc_res】文件夹内，下载后按钮变为 已下载。
【aigc_res】文件夹内包含 2d 和 3d 两个子目录，分别用于存放对应类型的资源。
（图19-2）
鼠标浮动在 已下载 文字链按钮上时，会显示资源存储路径。
点击 已下载 文字链按钮时，自动定位到项目资源目录，并选中对应的资源文件。
如何开始制作游戏
Section titled “如何开始制作游戏”直接在聊天输入框中输入带”需求”相关的文本内容，发送给聊天即可。例如：我要制作一个游戏，需求如下：xxxxx......。
如何管理项目资源
Section titled “如何管理项目资源”点击右侧功能按钮打开资源管理面板，可浏览、筛选和管理项目资源。
替换模型资源后，场景中的模型变成了白模（没显示贴图）
Section titled “替换模型资源后，场景中的模型变成了白模（没显示贴图）”导入模型资源前，需要先将模型的贴图进行导入（批量拉取模型资源时同理，需前置拉取贴图文件）。如果出现白模情况，只需要再重复一次导入贴图——替换模型即可恢复贴图显示。
使用引用方式精准描述资源替换需求
Section titled “使用引用方式精准描述资源替换需求”在聊天中需要替换资源时，建议通过引用操作配合自然语言描述来组织替换逻辑：
- 先在场景节点或项目资源目录中点选需要替换的目标对象，点击聊天窗口中的引用按钮将其插入聊天。
- 再用自然语言描述替换需求，例如：
将这个模型替换为AI生成的新模型。
AI会根据引用的对象和描述，自动完成节点/预制体与AI生成资源之间的替换操作。
将使用的资源在资源清单中列出
Section titled “将使用的资源在资源清单中列出”直接与AI对话，明确告知将目标资源列入资源清单，这样等资源列入清单后就方便对资源进行替换管理了。
API_KEY 丢失或忘记了怎么办
Section titled “API_KEY 丢失或忘记了怎么办”API_KEY 明文仅在创建时展示一次，无法再次查看。如果丢失，请前往接口密钥界面重新创建一个新的 API_KEY，然后在相应使用位置重新填入。
安装插件后右侧没有出现聊天窗口怎么办
Section titled “安装插件后右侧没有出现聊天窗口怎么办”LayaIdea 插件安装过程需要几分钟，请耐心等待 IDE 布局刷新完成。如果长时间未出现聊天窗口，可尝试按 Ctrl+Alt+R 刷新编辑器，或通过顶部菜单栏【开发者——刷新编辑器】手动刷新。
MCP Tools 显示连接异常怎么办
Section titled “MCP Tools 显示连接异常怎么办”通过【文件——项目设置】进入项目设置，在【MCP Tools】中确认 Ide-tools、Laya-ide-mcp-server、laya_mcp_server 三项服务是否都处于正常连接状态。如有异常，先尝试刷新编辑器（Ctrl+Alt+R）。若仍未恢复，可尝试重新安装 LayaIdea 插件。
普通模式和专业模式有什么区别？该选哪个
Section titled “普通模式和专业模式有什么区别？该选哪个”普通模式UI和技能等操作选项较为简洁，适合快速上手。专业模式在此基础上增加了 #自定义快捷指令、设置偏好、需求分析、资源管理 等高级功能，适合有明确项目需求、需要精细控制生成流程的用户。可通过顶部标题栏右侧的齿轮图标随时切换。
AI 生成的资源在哪里？为什么找不到了
Section titled “AI 生成的资源在哪里？为什么找不到了”通过聊天窗口生成的资源，需要手动点击缩略图右下角的 下载 按钮，资源会保存到项目资源目录下的【aigc_res】文件夹内（2d 和 3d 资源分别存放在对应子目录中）。另外请注意，历史记录仅保留2天，请及时下载所需资源。
切换模型后设置没有生效
Section titled “切换模型后设置没有生效”在设置偏好中切换模型后，保存设置 按钮会变为 重启IDE后生效，需要点击该按钮立即重启 IDE，模型切换才会生效。
代币不够用了怎么补充
Section titled “代币不够用了怎么补充”通过聊天窗口右上角的【查看/订阅】，可以打开管理后台，点击管理后台界面右上角的充值按钮，即可进入代币充值界面。此外，部分订阅服务会赠送通用代币，系统会优先消耗赠送代币，再消耗充值代币。