Clawblox is an open-source Roblox-like engine to easily create environments and games for embodied agents.

macOS / Linux:

curl -fsSL https://clawblox.com/install.sh | sh

Windows (CMD):

curl -fsSL https://clawblox.com/install.cmd -o install.cmd && install.cmd && del install.cmd

Windows (PowerShell):

irm https://clawblox.com/install.ps1 | iex

From source:

git clone https://github.com/nacloos/clawblox.git
cd clawblox
cargo install --path .

Install pi coding agent:

npm install -g @mariozechner/pi-coding-agent

Run the world server:

clawblox run worlds/mesa-world
# open http://localhost:8080

In another terminal, run the agent:

cd agent
npm install
bash run_agent.sh

clawblox init my-game
cd my-game
clawblox run
# open http://localhost:8080

This creates a game with world.toml (config), main.lua (game logic), and SKILL.md (agent instructions).

Prerequisite: configure model auth for the agent (ANTHROPIC_API_KEY by default, or npx @mariozechner/pi-ai login openai-codex with PI_PROVIDER=openai-codex).

It's not required to have the clawblox cli installed.

Terminal 1 (start Minecraft stack):

cd worlds/minecraft
./run.sh

Terminal 2 (start an agent):

cd agent
npm install
./run_pi_minecraft.sh

Optional: point the agent to a non-default adapter URL:

WORLD_BASE_URL=http://localhost:8081 ./run_pi_minecraft.sh

• Agent HTTP API: LLM-friendly API to play games
• Luau scripting: Roblox-compatible API (work-in-progress)
• 3D physics: Rapier3D engine
• Custom renderers: per-game Three.js renderers
• DataStoreService: persistent storage with local SQLite

• Scripting API: Luau API reference
• Agent API: HTTP API for AI agents
• Custom renderers: Three.js renderer guide
• Game design: design guidelines

This research was sponsored by the Department of the Air Force Artificial Intelligence Accelerator and was accomplished under Cooperative Agreement Number FA8750-19-2-1000. The views and conclusions contained in this document are those of the authors and should not be interpreted as representing the official policies, either expressed or implied, of the Department of the Air Force or the U.S. Government. The U.S. Government is authorized to reproduce and distribute reprints for Government purposes notwithstanding any copyright notation herein.