Skip to content

v1.0.0

Choose a tag to compare

View all tags
@ueboxai ueboxai released this 18 Sep 16:16
· 381 commits to main since this release
v1.0.0
cdfa7c3

First public release of UE Box.

An agent harness for Unreal Engine: give it a goal, and the AI does the work inside the project you already have open — placing Actors, editing Blueprints, wiring materials, compiling C++. When it says it's done, it goes back into the engine, verifies, and shows you the evidence.

This is the community core edition: fully offline, no account, no dependency on our servers, no regional gating. Everything local works out of the box; AI features just need your own model API key, which never leaves your machine.

Download

Windows only in this release — uebox-1.0.0-setup.exe.

Windows is the primary platform and where every feature is verified. macOS and Linux build and run from source, but the macOS plugin binaries and release validation aren't finished, and Linux engine auto-discovery isn't adapted yet — so there are no installers for them. Build from source if you need one.

Supports Unreal Engine 5.0 through 5.8. The UnrealAgentLink plugin that connects to the engine ships prebuilt and installs itself when you import a project — you don't need to know how to compile.

Getting started

  1. Install and open it
  2. Preferences → Models: add a provider, enter your API key, bind it to the "Chat" role — that one binding is enough to run the whole app
  3. Import your UE project and open the editor

Fully local and free is also an option: install Ollama for inference, and pull nomic-embed-text or bge-m3 for knowledge-base embeddings.

What's in it

  • 100+ Unreal Engine tools covering Actors, Blueprints, materials, geometry editing, Sequencer, Content Browser, and C++ compilation
  • Project health checks — just ask "which assets take up the most space" or "why is this level slow" and get a cost ranking aggregated by asset
  • Performance sampling that isn't a single-frame snapshot: continuous sampling via the engine's own CSV Profiler, with p50/p95/p99 and bottleneck attribution. Need more detail? Record an Unreal Insights trace
  • Step-by-step approval — destructive operations stop and ask before they run
  • Bring your own model: a built-in catalog of 39 providers covering local inference, self-hosted gateways, and cloud vendors. API keys can be entered directly, referenced as an environment variable name, or fetched on demand via !command from tools like the 1Password CLI
  • Project library, asset library, Blueprint and material libraries, notes and knowledge base — each usable on its own

Full change list in CHANGELOG.md.

License

Apache-2.0 for the application, MIT for the UnrealAgentLink plugin.

This project is not affiliated with or endorsed by Epic Games. Unreal and Unreal Engine are trademarks of Epic Games, Inc.

🐛 Issues · 🔒 Report security vulnerabilities privately per SECURITY.md

中文

虚幻盒子首次公开发布。

一套让 AI Agent 能实际操作虚幻工程的本地运行环境：给一个目标，它在你正开着的编辑器里把活干完 —— 放 Actor、改蓝图、连材质、编译 C++，改完回引擎核实再向你举证。

社区核心版：完全离线运行，不需要账号，不依赖我们的服务器，没有区域门禁。装完不配任何东西就能用全部本地功能；AI 功能自带模型 API Key 即可，密钥只存在本机。

下载

本次只提供 Windows 安装包 —— uebox-1.0.0-setup.exe。

Windows 是主力平台，功能都在这上面验证过。macOS / Linux 可以自己从源码构建并跑起来，但 Mac 插件二进制的构建与发布验收尚未完成，Linux 的引擎自动发现还没适配，所以暂不提供安装包。有需要的可以自行编译。

支持虚幻引擎 5.0 ~ 5.8。连接引擎的 UnrealAgentLink 插件已随包附带预编译版本，导入工程时自动安装，不需要你会编译。

用起来需要什么

  1. 装好，打开
  2. 偏好设置 → 模型，添加一个 Provider，填自己的 API Key，绑给「对话」角色 —— 只配这一项整个应用就能跑
  3. 导入你的 UE 工程，打开编辑器

想完全本地免费也可以：装 Ollama，模型走本机推理，知识库的嵌入模型拉 nomic-embed-text 或 bge-m3。

这个版本有什么

  • 100+ 个虚幻引擎工具，覆盖 Actor、蓝图、材质、几何编辑、序列器、内容浏览器、C++ 编译
  • 工程体检：直接问「哪些资源最占地方」「这个关卡为什么卡」，给出按资产聚合的开销排行
  • 性能采样：不是单帧快照，走引擎自带的 CSV Profiler 连续采样，给 p50/p95/p99 和瓶颈定位；需要更细可以再录 Unreal Insights trace
  • 逐步审批：破坏性操作在执行前停下来问你
  • 模型接入自由：内置 39 家厂商目录，本机推理 / 自建网关 / 云厂商都支持。API Key 可以直接填、可以填环境变量名、也可以用 !命令 从 1Password CLI 这类工具现取
  • 项目库、资产库、蓝图库与材质库、笔记与知识库，各自都能独立使用

完整的变更清单见 CHANGELOG.md。

许可

应用主体 Apache-2.0，UnrealAgentLink 插件 MIT。

本项目与 Epic Games 无关联、未获其背书。Unreal、Unreal Engine 是 Epic Games, Inc. 的商标。

🐛 问题反馈：Issues · 🔒 安全漏洞请按 SECURITY.md 私下报告

Assets 5
Loading