autopilot README

项目的 README,来自 github.com/ramenvr/autopilot。合并为一个 markdown 文件:README.md。

Aura Autopilot

By the developers of Aura, www.tryaura.dev

Aura by Ramen

Autopilot is a continually learning real-time general playtesting system. Autopilot learns your game, explores your levels, and improves its gameplay run after run.

Docs: https://www.tryaura.dev/documentation/autopilot

Official Discord: https://discord.gg/tryaura

Installation

The installation (and uninstallation) instructions in this README are relevant for the Autopilot plugin and for using the Autopilot MCP through Claude Code and Codex. If you are using Autopilot through Aura, no additional setup beyond the Aura setup is necessary. If you are interested in contributing to Autopilot, follow the instructions in CONTRIBUTING.md.

Step 1: Download

Download the latest Autopilot build for your game engine and OS from tryaura.dev/autopilot. We currently support Unreal Engine 5, Unity 6, Godot 4, and Roblox Studio on both Windows and macOS.

For advanced Unreal Engine users on Windows, we also support installing Autopilot from source and building it against your own Unreal Engine source build. Select the Unreal source build option in tryaura.dev/autopilot. If you install Autopilot from source, you can skip to Step 3: Onboarding.

Step 2A: Adding to your project (Unreal Engine)

Follow these instructions if your project is on Unreal Engine installed from the launcher.

If you are using a custom Unreal Engine source build and have run the installation from tryaura.dev/autopilot, you may skip this step and go straight to Step 3: Onboarding. If you don't know whether you are using a custom Unreal Engine source build, you are most likely not using one, which means that you should follow the instructions in this section to add Autopilot to your project.

Autopilot has builds for Unreal Engine 5.4, 5.5, 5.6, 5.7, and 5.8. If you haven't already, download them from tryaura.dev/autopilot. For Windows users, you should see an Autopilot-Unreal5.x-Win64.zip in your downloads folder. For macOS users, you should see an Autopilot-Unreal5.x-Mac.dmg in your downloads folder.

  1. Extract/open the downloaded Autopilot-Unreal5.x-Win64.zip (Windows) or Autopilot-Unreal5.x-Mac.dmg (macOS). It contains an Autopilot/ folder.
  2. Move Autopilot/ into your project's Plugins/ folder. If your project doesn't have a Plugins/ folder, create one yourself. If you complete this step successfully, you should have <YourProject>/Plugins/Autopilot/Autopilot.uplugin.
  3. At this point, it is safe to delete the downloaded zip (Windows) or eject the disk image and delete the downloaded dmg (macOS).
  4. Proceed to Step 3: Onboarding.

Step 2B: Adding to your project (Unity)

Follow these instructions if your project is on Unity.

Autopilot has a build for Unity 6 (v6000.0 or later). If you haven't already, download it from tryaura.dev/autopilot. You should see an Autopilot-Unity.zip in your downloads folder.

  1. Extract the downloaded Autopilot-Unity.zip. It contains com.ramenvr.autopilot-<version>.tgz.
  2. Open your project in Unity.
  3. Go to Window > Package Management > Package Manager.
  4. Click the + icon.
  5. Click Install package from tarball... and select com.ramenvr.autopilot-<version>.tgz.
  6. Proceed to Step 3: Onboarding.

Step 2C: Adding to your project (Godot)

Follow these instructions if your project is on Godot.

Autopilot has a build for Godot 4 (v4.7 or later). If you haven't already, download it from tryaura.dev/autopilot. You should see an Autopilot-Godot.zip in your downloads folder.

  1. Extract the downloaded Autopilot-Godot.zip. It contains an addons/autopilot/ folder.
  2. Move autopilot/ into your project's addons/ folder. If your project doesn't have an addons/ folder, create one yourself, or move addons/autopilot/ directly into your project folder. If you complete this step successfully, you should have <YourProject>/addons/autopilot/....
  3. At this point, it is safe to delete the downloaded zip.
  4. Open your project in Godot.
  5. Enable Autopilot in Project > Project Settings > Plugins.
  6. Proceed to Step 3: Onboarding.

Step 2D: Adding to your project (Roblox Studio)

Follow these instructions if your project is on Roblox Studio.

If you haven't already, download the Autopilot build for Roblox Studio from tryaura.dev/autopilot. You should see an Autopilot-Roblox.zip in your downloads folder.

  1. Extract the downloaded Autopilot-Roblox.zip.
  2. From the extracted folder in your terminal, run powershell -ExecutionPolicy Bypass -File agent_service\install.ps1 (Windows) or sh agent_service/install.sh (macOS). This installs the autopilot command.
  3. Copy Autopilot.rbxmx found in the extracted folder into your Roblox Studio Plugins folder, which is %LOCALAPPDATA%\Roblox\Plugins (Windows) or ~/Documents/Roblox/Plugins (macOS).
  4. Open your project in Roblox Studio.
  5. Enable the Roblox Studio MCP server. Find the Assistant panel in Roblox Studio, then go to ... > Settings > MCP Servers and enable Enable Studio as MCP server. You should see "MCP Ready" on the bottom right corner.
  6. Run autopilot serve in a new terminal window. This terminal window must be open throughout your Autopilot use.

Step 3: Onboarding

The Autopilot onboarding flow installs the agent service and sets up the models (LLMs and decision models) for Autopilot to work.

  1. Open the Autopilot window. For Unreal and Godot users, click the Autopilot icon (orange controller). For Unity users, click Window > Autopilot. For Roblox Studio users, click Plugins > Autopilot.
  2. We recommend using Autopilot with your Aura account so you can track your usage in one centralized platform. Click Create Account if you don't yet have an Aura account, or Sign in if you are a returning user. You also have the option to BYOK.
  3. Wait for Autopilot to set up and start the agent service. Once it is done, you are automatically redirected to the signup/signin page.
  4. Complete the signup/signin process. If you are a new user (signup), confirm your email and then sign in to your Aura account through the Autopilot window.
  5. Upon successful authentication, you should see "Signed in as " in the Autopilot window. Click Continue.
  6. You should see "Agent service ready". Click Continue.
  7. You have the option to enable/disable sharing your runs to improve Autopilot. As the developers of Autopilot, we would of course appreciate your enabling this! Once you are happy with your choice, click Finish.
  8. If you haven't used Autopilot in your project before (or have emptied your Autopilot project memory), you have the option to run a 10-minute exploration run to populate your Autopilot project memory. Autopilot visibly improves the more it plays your game. It is safe to skip this and jump straight to sending your own prompt.
  9. Prompt Autopilot! See the types of prompts you can try in Things to Know.

With Coding Agents

You can use Autopilot through Claude Code and/or Codex via our MCP server.

  1. Complete all installation steps. Signing in with your Aura account allows this to work out of the box; Aura will only count your decision model usage, which means that your LLM usage is counted against your own Claude and/or ChatGPT subscription and not against Aura. If you want to BYOK, you need to provide a TypeSafe API key.
  2. To run the one-time setup, run autopilot connect claude for Claude Code or autopilot connect codex for Codex.
  3. Open Claude Code / Codex and prompt it to "Use Autopilot to ...".

Things to Know

An Autopilot prompt is one of 4 types:

For every prompt, Autopilot will automatically launch a PIE window and start reading your project's source code, probe PIE, and start playing according to your prompt. Autopilot plays by using an LLM coding agent to craft harnesses for a decision model according to what it knows about your game, and requests decisions (action choices) from the decision model during gameplay. Once Autopilot is done, the PIE window will close automatically, and Autopilot generates a report for you.

Your first few runs allow Autopilot to learn about your game as it gradually populates its memory. Expect some suboptimal behavior for the first few harness attempts. Autopilot visibly improves the more it plays your game, and later harness attempts and runs both take a shorter time to complete a given task, as well as exhibit more intelligent behavior (e.g. faster dodging, equipping better weapons, playing smarter strategies, better aiming).

Uninstallation

To do a clean uninstall of Autopilot, do the following steps:

  1. In Autopilot, go to Settings and click Uninstall. By default, Autopilot keeps your project's memories; you can choose to delete memories instead (this is a destructive action).
  2. Remove the plugin from each project:
    • Unreal: Close the editor and delete Plugins/Autopilot/.
    • Unity: Remove the Autopilot package in the Package Manager.
    • Godot: Disable Autopilot in Project > Project Settings > Plugins, then delete addons/autopilot/.
    • Roblox Studio: Delete Autopilot.rbxmx from your Roblox Studio Plugins folder.

Contributing

Contributions are welcome. CONTRIBUTING.md explains how to set up a development environment, run the tests, and add support for a new engine. Please follow the Code of Conduct.

License

Apache License 2.0. The plugins bundle fonts under the SIL Open Font License; see each font's OFL file.

autopilot (ramenvr/autopilot)

正在搜索数据库…

这是什么?Autopilot 是由 Aura 团队开发的一套持续学习、实时运行的游戏试玩测试系统。你把它安装到游戏项目中,它会探索你的关卡、测试玩法,并且每轮运行后都会改进自己的游玩表现。它支持 Unreal Engine 5、Unity 6 和 Godot 4。
这是独立应用,还是我要添加到游戏引擎里的插件?它是一个编辑器插件,而不是独立应用。你把下载好的安装包放进 Unreal 的 Plugins 文件夹、Unity 的包管理器,或 Godot 的 addons 文件夹,它就会在编辑器中添加一个停靠面板。
我该怎么把它跑起来?下载适用于你的引擎和操作系统的预编译 Autopilot 版本,将其安装到项目的插件文件夹中(Unreal 的 Plugins/、通过包管理器安装的 Unity 包,或 Godot 的 addons/),然后启用它,并按照编辑器内的设置向导完成登录。
用它之前我需要注册 Aura 账号吗?设置过程会引导你创建或登录 Aura 账号,以运行智能体服务。不过,如果你改为通过 Claude Code 或 Codex 来驱动它,则会使用你自己的 Claude 或 ChatGPT 订阅,或自带密钥(BYOK)的 API 密钥。
它一上手就能玩得很好吗?不能。最初几轮运行是为了让 Autopilot 学习你的游戏,因为它的记忆是空的,所以一开始的测试框架尝试会比较笨拙、缓慢。随着项目记忆不断积累,它会明显变得更快、更聪明。
它支持哪些引擎和操作系统?Unreal Engine 5.4-5.8、Unity 6 或更高版本,以及 Godot 4.7 或更高版本,运行于 Windows 和 MacOS 上。
许可证有什么特别之处吗?项目本身采用 Apache 2.0 许可证,但随附的字体单独采用 SIL Open Font License 许可。
Autopilot 在游戏里到底是怎么决定做什么的?它使用 LLM 编程智能体读取你游戏的源代码,编写定制的测试框架代码,供一个决策模型使用。随后,在 Autopilot 通过 PIE 运行你的项目时,该决策模型会在游戏中做出行动选择。
我能不用编辑器,而是通过 Claude Code 或 Codex 来操作 Autopilot 吗?可以。在终端中运行 'autopilot connect claude' 或 'autopilot connect codex',然后让 Claude Code 或 Codex 通过其 skills 和 MCP 服务器来使用 Autopilot。费用由你自己的 Claude 或 ChatGPT 订阅承担。
我可以给 Autopilot 下哪些类型的指令?共四种类型:探索类('Explore the crafting system')、测试类('tell me everything that looks wrong')、验证类('Verify that the tree shakes when hit'),以及目标类任务('kill the boss while keeping health above 20%')。
以后我能撤销或卸载 Autopilot 吗?可以。先在 Autopilot 的设置菜单中卸载(可选择同时删除其学到的记忆),然后从 Unreal、Unity 或 Godot 项目中删除插件文件。
作者
ramenvr
大小
6.1 MB
星标
873
时长
19天
提交 · 90 天