跳到正文
Bullet Hero
文档
本页内容
关卡作者

AI助手

支持MCP的AI客户端可以在你眼前编辑编辑器中打开的关卡。每个AI批量操作都是一个撤销步骤，AI不能发布、删除文件，也不能覆盖其他关卡

为此，Windows、Linux和Mac上的游戏自带一个MCP服务器。AI用和你相同的操作进行编辑，所以每处改动都会立刻出现在视口中，并像你自己的操作一样进入历史记录

任何支持MCP的客户端都可以，比如聊天应用或编程助手。游戏中没有任何东西绑定在某一个AI上

连接客户端

  1. 打开设置 → 编辑器 → AI 代理（MCP）
  2. 勾选允许 AI 连接。设置下方的状态行会显示编辑器监听的端口
  3. 按下复制客户端配置。剪贴板中就有了已填好两个路径的客户端配置
  4. 把它粘贴到你的客户端的MCP服务器设置中
  5. 在编辑器中打开一个关卡，或者让AI自己打开编辑器或关卡

复制的配置是这样的：

{ "mcpServers": { "bullet-hero": { "command": "<path to BH.MCP>", "args": ["--endpoint", "<path to endpoint.json>"] } } }

服务器文件BH.MCP位于游戏旁边：

系统服务器文件
Windows<游戏文件夹>/BH.MCP.exe
Linux<游戏文件夹>/BH.MCP
Mac<game>.app/Contents/Resources/mcp/osx-arm64/BH.MCP，Intel上用osx-x64代替osx-arm64

只有本机可以连接，并且同一时间只能连接一个客户端。手机和平板上没有MCP部分：助手只在电脑上可用

可以同时运行多个游戏副本。在你要求切换之前，AI在最后启动的那个副本中工作，它也可以列出所有副本。每个副本仍然只接受一个客户端。运行多个副本时，请把端口保持为0，因为两个副本不能监听同一个端口

AI能做什么，不能做什么

你能做的事，AI几乎都能做：

  • 读取关卡：层级、物体、关键帧、事件和资源
  • 创建、修改和删除物体、关键帧、标记、检查点、音频轨道和节拍网格
  • 运行生成器，打包和放置预制件，在预制件模式中工作
  • 把纹理、字体或音频文件导入关卡
  • 导入纹理、字体或音频文件后，填写它的署名记录：标题、描述、链接、来源和作者。更多：资源记录
  • 使用游戏自带的预设主题、字体和界面音效。resources_list会把它们标记为游戏的资源，无需导入。游戏不提供预设特效：AI放置的特效要么是关卡里已有的，要么是它新建的
  • 按角点把任意轮廓画成关卡形状，给形状上渐变色，设置文本的字体和对齐，创建和编辑关卡的主题
  • 撤销和重做，保存打开的关卡，打开其他关卡，创建新关卡
  • 开始和暂停播放，和你的播放按钮一样
  • 用与启动时相同的参数把游戏切换到其他界面，例如编辑器、某个关卡或设置 - 启动参数
  • 在游戏未运行时启动游戏，前提是服务器位于已安装的游戏旁边且MCP已经开启

这样开始的游玩和其他游玩一样计入你的统计，所以AI只在你要求时才会开始游玩

它不能：

  • 发布到Steam创意工坊
  • 删除关卡或任何文件
  • 覆盖其他关卡或其他文件。文件名已被占用的导入会被拒绝
  • 打开只读关卡，或者本次会话中你还没输入过密码的受保护关卡
  • 在打开的关卡有未保存的修改时打开其他关卡

一个AI批量操作就是历史记录中的一步。它在历史标签页中显示为AI 批量操作，并带有AI自己写的说明。按一次Ctrl+Z就会撤销整个批量操作。关于历史记录的更多内容：关卡设置 › 历史

AI 绝不会让两个同时播放的物体位于同一图层。 如果一个批次会这样做，它会在同一步里把较晚的物体抬到下一个空闲图层，并说明这一点。预制件的内容是例外：它可以和关卡其余部分共用图层

第一个修改关卡的AI批量操作会把关卡的AI 生成设为AI 生成，而且是在同一步中。撤销这个批量操作也会把它还原。更多：元数据与分享关卡 › AI生成

你优先

AI从不和你争夺编辑器：

  • 你拖动控制柄手柄或拖动时间轴时，AI的编辑会被拒绝，它会等待并重试
  • AI只在你空闲时才使用播放头：没有在游玩、拖动、输入或保存
  • 编辑器在打开关卡时就开始播放，所以AI可以把它暂停，以便查看画面。AI自己打开或创建的关卡保持暂停。如果你是有意在看播放，AI会先问你
  • AI查看某一帧时你动了编辑器，AI会立刻停下。播放头留在你放的位置
  • 历史记录跳转进行期间，AI也无法编辑

客户端连接期间，视口右上角的搜索按钮下方会显示AI标记。它的颜色就是状态：绿色表示已连接，黄色表示AI正在工作，红色表示AI的上一次调用以错误结束。客户端断开后，标记还会保留30秒，这样每一步都重新连接的AI不会闪烁。它会和视口工具一起隐藏。把指针停在它上面可以看到文字状态：AI已连接，AI工作时则显示它正在做的事的说明。旁边的叉号会断开客户端并拒绝它连接，标记随之消失

停止状态不会保存。关闭再重新开启允许 AI 连接或重启游戏都会解除它

AI看到什么

AI用两种方式观察关卡：

  • 示意图。任意一帧的图片，在屏幕外计算出来。它不移动播放头。上面有形状和判定框，但没有文本和特效
  • 截图。真实的像素，和关卡绘制的完全一样，通过你的播放头拍下。播放头会短暂跳到那一帧，编辑器的叠加层会隐藏。然后播放头回到你离开时的位置，除非开启了播放头跟随AI。画面由关卡摄像机取景，而不是编辑器摄像机。要近看某个细节，AI也可以改为拍摄世界中的一个矩形区域。关卡本身不会改变

跳转之后的特效截图接近连续播放时的样子，但不一定完全相同

AI听不到音乐。它把音轨变成数字：速度、节拍、小节、段落、每个频段的响度。这只是带置信度的估计，可能出错，比如速度差一半或一倍。你在关卡中设置的节拍网格比AI的估计更可信。AI根据分析提出的节拍网格中，与整数相差不到0.01的速度会取整为该整数，偏移总是短于一小节

所以在时机很重要时，AI可能会请你听一下。它在编辑器中播放最长45秒的一段，这也会移动播放头。你一动编辑器，播放就停在当前位置

编辑器的声音关闭时，AI不会播放任何内容，而是请你打开声音

AI自己的操作不会发出界面音效：它引起的撤销、保存或拒绝都是静音的。只有它有意播放的内容才能听到

ai文件夹

AI把关于关卡的记忆保存在关卡文件夹内的ai文件夹中。下一次会话，无论用哪个客户端，都会先读它，从上一次停下的地方继续

里面有：

  • CONTEXT.md：任务、音乐、段落计划、决定、你的意见和未解决的问题
  • AI决定保留的其他文件，只能是.md或.json
  • manifest.json：文件夹是否随关卡一起传送。AI无法修改它

只有当AI第一次有东西要写时，这个文件夹才会出现。一个文件最多256KB，整个文件夹最多1MB。这些都是普通的文本文件：你可以自己阅读、编辑或删除

警告

ai文件夹不属于关卡的历史记录。Ctrl+Z不会撤销AI写进去的内容

默认情况下，文件夹会随关卡一起传送：进入导出的归档包和Steam创意工坊上传内容。想把它留在本地，就在关卡设置的元数据标签页中取消勾选随关卡共享AI上下文。文件夹存在后这个复选框才会出现。它会立即保存到文件，所以Ctrl+Z也不会还原它

带密码的导出模式从不包含这个文件夹，无论复选框怎么设置。更多：导出与保护 › 导出关卡

在本设备上复制关卡时，文件夹会一起复制，因为复制不是分享

设置

所有设置都在设置 → 编辑器 → AI 代理（MCP）中，只保存在本设备上：

  • 允许 AI 连接：客户端到底能不能连接。默认关闭
  • 端口：编辑器监听的端口。0表示每次启动自动选一个空闲端口
  • 播放头跟随AI：开启时，截图之后播放头停在AI查看的那一帧并暂停
  • 显示AI的编辑：每次AI编辑后，选中并定位它创建或修改的内容
  • AI操作间隔（秒）：编辑器在两次AI操作之间等待的时间，方便你看清每一步。0表示每次立即执行

所有设置及其默认值：编辑器设置 › AI代理

接下来：避免丢失工作、导出与保护