build-world
Build interactive 3D worlds with high-quality assets from Thrixel and your AI agent of choice.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/thrixel/build-world with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/thrixel/build-world'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/thrixel--build-world)HTML
<a href="/listings/thrixel--build-world"><img src="/api/listings/thrixel--build-world/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Steps 1 and 2 are once per machine. After that, a new game is just step 3.
> Using [Codex](https://thrixel.com/docs/build-world#codex) or > [Gemini CLI](https://thrixel.com/docs/build-world#gemini-cli) instead? Each one > installs Thrixel its own way - the > [installation page](https://thrixel.com/docs/build-world) has the steps for both.
1. Install Claude Code and uv
claude --version uv --version
**Both print a version? Skip to step 2.**
<details> <summary><b>Not installed? Install commands here</b></summary>
**macOS, Linux, WSL**
curl -fsSL https://claude.ai/install.sh | bash # the agent that writes your game curl -LsSf https://astral.sh/uv/install.sh | sh # runs the Thrixel connector
**Windows PowerShell**
irm https://claude.ai/install.ps1 | iex irm https://astral.sh/uv/install.ps1 | iex
⚠️ **NOW OPEN A NEW TERMINAL**, then re-run the check above. Skipping this is the number one cause of `command not found`.
</details>
2. Connect Thrixel with [Claude Code Plugins](https://code.claude.com/docs/en/plugins)
Same on every platform:
# 1. Sign up and log in. Opens a page with a code, click Approve. The only manual step here. uvx thrixel-mcp@latest login # 2. One plugin carries both the skill and the Thrixel connector, for every project. claude plugin marketplace add thrixel/build-world claude plugin install thrixel@thrixel
Confirm both pieces landed:
claude plugin list # thrixel@thrixel -> enabled claude mcp list # plugin:thrixel:thrixel -> Connected
**Both lines look right? You are done. Go to step 3.**
**Turn on updates (once).** Updates are off by default. In Claude Code:
1. Type `/plugin` 2. **Marketplaces** > **thrixel** 3. **Enable auto-update**
(Or update manually anytime: `/plugin update thrixel@thrixel`. Skipped this? No problem, the agent tells you when a newer version is out.)
<details> <summary><b>Installed manually before? Remove the old copies</b></summary>
The plugin includes both pieces, so your old install is now a duplicate. Remove it once.
<details open> <summary><b>macOS, Linux, WSL</b></summary>
claude mcp remove thrixel rm -rf ~/.claude/skills/build-world ~/.claude/skills/goal-to-game ~/.claude/skills/thrixel
</details>
<details> <summary><b>Windows PowerShell</b></summary>
claude mcp remove thrixel Remove-Item -Recurse -Force "$HOME\.claude\skills\build-world","$HOME\.claude\skills\goal-to-game","$HOME\.claude\skills\thrixel"
</details>
</details>
3. Ask for a game
# Run this wherever you keep projects. Claude makes the project folder itself. claude --permission-mode auto
**Into Claude Code** (not the terminal), start the line with **`/thrixel:build-world`**, then describe the game and name the engine (three.js, Roblox, Unity, or Unreal):
/thrixel:build-world build a submarine exploration game in three.js set in a bright, vibrant tropical sea with coral and fish
> [!TIP] > Type `/thr` and Claude completes **`/thrixel:build-world`** for you, so you never type it in > full. If the completion does not appear, the skill is not installed - go back to step 2.
> We recommend setting /model to Opus 5 or a more capable model, with effort set to high or above.
Claude checks your Thrixel account and starts building. Keep talking to it in plain English to change things.
<details> <summary><b>No plugin? Install the <a href="https://code.claude.com/docs/en/skills">skill</a> and the <a href="https://modelcontextprotocol.io">MCP connector</a> separately</b></summary>
Replaces steps 2 and 3 above. Same start command either way: `/thrixel:build-world`.
**2. Connect Thrixel**
<details open> <summary><b>macOS, Linux, WSL</b></summary>
# 1. Sign up and log in. Opens a page with a code, click Approve. The only manual step here. uvx thrixel-mcp@latest login
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 16 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "thrixel",
- "description": "Official Thrixel plugin: AI-generated 3D game assets for your coding agent.",
- "owner": {
- "name": "Thrixel",
- "email": "support@thrixel.com",
- "url": "https://thrixel.com"
- },
- "plugins": [
- {
- "name": "thrixel",
- "source": "./",
- "description": "Build playable 3D games with AI-generated assets. Bundles the build-world skill and the Thrixel connector: generate, refine and texture game-ready .glb models, then build the game around them in Three.js, Unity, Unreal or Roblox."
- }
- ]
- }
README.md · README · 253 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Build World
- Build interactive 3D worlds with high-quality assets from [Thrixel](https://thrixel.com/) and your AI agent of choice.
- Claude Code (or your preferred agent) handles the logic, interactions, and scene setup. Thrixel generates, organizes, and manages the 3D assets. Save your coding agent tokens and time by using Thrixel to generate 3D assets faster and at higher quality than Claude Code.
- Build World currently supports **Three.js**, **Roblox**, **Unity**, and **Unreal Engine**. This page covers **Claude Code**, but the workflow works with other coding agents as well.
- > Build World was previously called Goal to Game. The name changed because the skill goes beyond games: it can build interactive experiences, simulations, educational experiences, virtual tourism and historical recreations, AR/VR experiences, and more.
- ## Thrixel inside the Gauntlet Loop
- Build World uses a [gauntlet loop](https://thrixel.com/learn/gauntlet-loop)-like iterative workflow for creating interactive 3D worlds. The agent calls Thrixel to generate and refine 3D assets inside the loop. The agent continuously builds, evaluates, and improves the world itself, including its gameplay, interactions, and assets. With Build World, you can [vibe out a game](https://thrixel.com/learn/vibe-gaming) or other interactive 3D experience from a single prompt, then keep refining it with follow-up prompts.
- <p align="center">
- <img src="https://raw.githubusercontent.com/ThatCharlieK/READMEAssets/main/Thrixel-1prompt-to-game-readme.gif" width="600"/>
- </p>
- ## Quick start
- Steps 1 and 2 are once per machine. After that, a new game is just step 3.
- > Using [Codex](https://thrixel.com/docs/build-world#codex) or
- > [Gemini CLI](https://thrixel.com/docs/build-world#gemini-cli) instead? Each one
- > installs Thrixel its own way - the
- > [installation page](https://thrixel.com/docs/build-world) has the steps for both.
- ### 1. Install Claude Code and uv
- ```bash
- claude --version
- uv --version
- ```
- **Both print a version? Skip to step 2.**
- <details>
- <summary><b>Not installed? Install commands here</b></summary>
- **macOS, Linux, WSL**
- ```bash
- curl -fsSL https://claude.ai/install.sh | bash # the agent that writes your game
- curl -LsSf https://astral.sh/uv/install.sh | sh # runs the Thrixel connector
- ```
- **Windows PowerShell**
- ```powershell
- irm https://claude.ai/install.ps1 | iex
- irm https://astral.sh/uv/install.ps1 | iex
- ```
- ⚠️ **NOW OPEN A NEW TERMINAL**, then re-run the check above. Skipping this is the number one cause
- of `command not found`.
- </details>
- ### 2. Connect Thrixel with [Claude Code Plugins](https://code.claude.com/docs/en/plugins)
- Same on every platform:
- ```bash
- # 1. Sign up and log in. Opens a page with a code, click Approve. The only manual step here.
- uvx thrixel-mcp@latest login
- # 2. One plugin carries both the skill and the Thrixel connector, for every project.
- claude plugin marketplace add thrixel/build-world
- claude plugin install thrixel@thrixel
- ```
- Confirm both pieces landed:
- ```bash
- claude plugin list # thrixel@thrixel -> enabled
- claude mcp list # plugin:thrixel:thrixel -> Connected
- ```
- **Both lines look right? You are done. Go to step 3.**
- **Turn on updates (once).** Updates are off by default. In Claude Code:
- 1. Type `/plugin`
- 2. **Marketplaces** > **thrixel**
- 3. **Enable auto-update**
- (Or update manually anytime: `/plugin update thrixel@thrixel`. Skipped this? No problem, the
- agent tells you when a newer version is out.)
- <details>
- <summary><b>Installed manually before? Remove the old copies</b></summary>
- The plugin includes both pieces, so your old install is now a duplicate. Remove it once.
- <details open>
- <summary><b>macOS, Linux, WSL</b></summary>
- ```bash
- claude mcp remove thrixel
- rm -rf ~/.claude/skills/build-world ~/.claude/skills/goal-to-game ~/.claude/skills/thrixel
- ```
- </details>
- <details>
- <summary><b>Windows PowerShell</b></summary>
- ```powershell
- claude mcp remove thrixel
- Remove-Item -Recurse -Force "$HOME\.claude\skills\build-world","$HOME\.claude\skills\goal-to-game","$HOME\.claude\skills\thrixel"
- ```
- </details>
- </details>
- ### 3. Ask for a game
- ```bash
- # Run this wherever you keep projects. Claude makes the project folder itself.
- claude --permission-mode auto
- ```
- **Into Claude Code** (not the terminal), start the line with **`/thrixel:build-world`**, then
- describe the game and name the engine (three.js, Roblox, Unity, or Unreal):
- ```text
- /thrixel:build-world build a submarine exploration game in three.js set in a bright, vibrant tropical sea with coral and fish
- ```
- > [!TIP]
- > Type `/thr` and Claude completes **`/thrixel:build-world`** for you, so you never type it in
- > full. If the completion does not appear, the skill is not installed - go back to step 2.
- > We recommend setting /model to Opus 5 or a more capable model, with effort set to high or above.
- Claude checks your Thrixel account and starts building. Keep talking to it in plain English to
- change things.
- <details>
- <summary><b>No plugin? Install the <a href="https://code.claude.com/docs/en/skills">skill</a> and the <a href="https://modelcontextprotocol.io">MCP connector</a> separately</b></summary>
- Replaces steps 2 and 3 above. Same start command either way: `/thrixel:build-world`.
- **2. Connect Thrixel**
- <details open>
- <summary><b>macOS, Linux, WSL</b></summary>
- ```bash
- # 1. Sign up and log in. Opens a page with a code, click Approve. The only manual step here.
- uvx thrixel-mcp@latest login
- # 2. Install the Thrixel connector. --scope user covers EVERY project, not just this folder.
- claude mcp add --scope user thrixel -- uvx thrixel-mcp@latest
- # 3. Install the skill. Clone, not download, so it can update itself later.
- git clone https://github.com/thrixel/build-world ~/.claude/skills/thrixel
- ```
- </details>
- <details>
- <summary><b>Windows PowerShell</b></summary>
- Same three commands. Only the path differs: `~` is not reliably expanded when PowerShell passes it
- to git, and a skill that lands anywhere else is invisible to Claude.
- ```powershell
- uvx thrixel-mcp@latest login
- claude mcp add --scope user thrixel -- uvx thrixel-mcp@latest
- git clone https://github.com/thrixel/build-world "$HOME\.claude\skills\thrixel"
- ```
- </details>
- Confirm both landed:
- ```bash
- claude mcp list # thrixel -> Connected
- ls ~/.claude/skills/ # thrixel listed
- ```
- If either is missing, Claude will build the game without Thrixel and never mention it.
- **Cloned before the rename?** `github.com/thrixel/goal-to-game` still redirects here, so an older
- clone keeps working and keeps updating itself. All it leaves behind is the old name, in your folder
- and in `git remote -v`. Point it at the current URL once:
- ```bash
- git -C ~/.claude/skills/thrixel remote set-url origin https://github.com/thrixel/build-world
- ```
- **3. Ask for a game**
- Identical to step 3 above, same command and all:
- ```text
- /thrixel:build-world build a submarine exploration game in three.js set in a bright, vibrant tropical sea with coral and fish
- ```
- </details>
- <details>
- <summary>Something went wrong</summary>
- **"command not found"** - **open a new terminal.** Fixes it almost every time. If a fresh terminal
- still fails, run `export PATH="$HOME/.local/bin:$PATH"` (PowerShell:
- `$env:Path = "$HOME\.local\bin;$env:Path"`).
- **Claude has no Thrixel tools** - check `claude mcp list` for `thrixel`. If missing, re-run the
- `claude mcp add` line, then restart Claude.
- **Claude says you need to sign in** - re-run `uvx thrixel-mcp@latest login` and click Approve. No
- restart needed, just tell Claude to continue.
- **"Out of cubes"** - cubes are Thrixel's generation credits. Claude shows you what is built, marks
- missing assets as labelled blocks, and asks how you want to continue.
- </details>
- ### 4. Publish and share
- When your world is ready, ask your coding agent to publish it. Build World handles the deployment and gives you a live, shareable link, with no separate hosting setup required.
- ```text
- Publish this world and give me a link I can share.
- ```
- You can continue refining the project after publishing and deploy the updated version whenever you are ready. You may also ask your agent to record an mp4 preview to share online. E.g.,
- ```text
- Create a recording of this in .mp4 format to help demonstrate the capabilities to others
- ```
- ## Working with Thrixel API
- Every asset generated through the Thrixel API is saved to your Thrixel workspace.
- **Manage and Edit**: Visit [Thrixel Web App](https://thrixel.com/create) to view, manage, and edit your assets. If you make changes in the web app, ask your coding agent to pull the updated versions back into your game.
- **Engine Agnostic**: Because your assets are managed in Thrixel rather than tied to one codebase, you can also reuse them across projects and engines. For example, you can prototype in Three.js and later ask your agent to rebuild the game in Unity or Roblox using the same asset library.
- **Parallel Processing**: Thrixel can manage and process jobs in parallel. Your coding agent can farm out parallel jobs to Thrixel while building out the logic of the game. Each [plan](https://thrixel.com/create/#upgrade) has a different concurrency limit.
- ## Usage and credits
- You can test this workflow using the free Thrixel Cubes included with your Starter account. However, building a full-scale game generally requires a wider variety of assets and rapid iteration that usually exceeds Starter limits. Upgrading to a [Paid Plan](https://thrixel.com/create/#upgrade) unlocks higher parallel job processing capacity and higher generation limits, allowing you to bring your most ambitious ideas to life. You can keep track of your remaining Cubes anytime in [Account Settings](https://thrixel.com/create/#settings/billing).
- ## About Thrixel
- Learn more about Thrixel at [thrixel.com](https://thrixel.com/).
skills/build-world/engines/threejs/lib/selftest.js · Bundled script · 100 lines · 1 finding marked
- /**
- * A 40-line assert harness for subsystem self-tests. No dependencies, runs in
- * node and in the browser.
- *
- * WHY IT EXISTS: a screenshot cannot show that a capsule tunnelled through a
- * wall, that a ragdoll is gaining energy, that a nav path is unreachable, that a
- * synthesised sound is silent or clipping, or that a generated mesh has NaN
- * vertices. Those are exactly the failures that a visual critic will report as
- * something else ("the enemy looks wrong") and send you hunting in the wrong
- * subsystem.
- *
- * The pattern that paid off in the reference project: every non-visual subsystem
- * ships a `selftest` that prints a TABLE of measured-vs-expected, runnable as
- * `node src/<system>/selftest.mjs`. Measured numbers, not assertions that pass
- Note: Usual in code (tag names in paths and patterns): Contains a <system> block, a common wrapper for instructions hidden in a tool description
- Line 14 on GitHub
- * silently — the table is the artifact you paste into a report, and a reviewer
- * can see a value drifting before it crosses a threshold.
- *
- * const t = suite('physics');
- * t.ok(hit !== null, 'ray hits the wall');
- * t.near(speed, 4.57, 0.12, 'walk top speed', 'm/s');
- * t.range(slide, 0.75, 0.95, 'slide duration', 's');
- * process.exit(t.report());
- */
- export function suite(name) {
- const rows = [];
- let failures = 0;
- const push = (pass, label, measured, expected, unit) => {
- rows.push({ pass, label, measured, expected, unit: unit ?? '' });
- if (!pass) failures++;
- return pass;
- };
- return {
- name,
- section(title) {
- rows.push({ section: title });
- },
- ok(cond, label, detail = '') {
- return push(!!cond, label, cond ? 'yes' : 'NO', detail || 'yes');
- },
- eq(got, want, label, unit) {
- return push(got === want, label, got, want, unit);
- },
- near(got, want, tol, label, unit) {
- return push(Number.isFinite(got) && Math.abs(got - want) <= tol, label, fmt(got), `${want} ±${tol}`, unit);
- },
- range(got, lo, hi, label, unit) {
- return push(Number.isFinite(got) && got >= lo && got <= hi, label, fmt(got), `${lo}..${hi}`, unit);
- },
- finite(arr, label) {
- let bad = 0;
- for (let i = 0; i < arr.length; i++) if (!Number.isFinite(arr[i])) bad++;
- return push(bad === 0, label, `${bad} non-finite`, '0 non-finite');
- },
- /** Report as a table. Returns the exit code: 0 = all pass. */
- report({ log = console.log } = {}) {
- const w = (s, n) => String(s).padEnd(n);
- log(`\n${name} — ${rows.filter((r) => r.pass === true).length}/${rows.filter((r) => 'pass' in r).length} pass`);
- log(w('TEST', 34) + w('MEASURED', 16) + w('EXPECTED', 18) + 'RESULT');
- for (const r of rows) {
- if (r.section) {
- log(`\n${r.section}`);
- continue;
- }
- log(w(r.label, 34) + w(r.measured + r.unit, 16) + w(r.expected + r.unit, 18) + (r.pass ? 'PASS' : 'FAIL'));
- }
- if (failures) log(`\n${failures} FAILURE${failures > 1 ? 'S' : ''}`);
- return failures ? 1 : 0;
- },
- get failures() {
- return failures;
- },
- rows,
- };
- }
- const fmt = (v) =>
- typeof v === 'number' ? (Math.abs(v) < 100 ? v.toFixed(3) : v.toFixed(1)) : String(v);
- /**
- * Statistics for measuring feel and cost. `p(0.99)` is the number that matters
- * for frame time; a mean or median hides exactly the stalls players notice.
- */
- export function stats(values) {
- const a = Float64Array.from(values).sort();
- const n = a.length;
- if (!n) return { n: 0 };
- let sum = 0;
- for (const v of a) sum += v;
- const p = (q) => a[Math.min(n - 1, Math.max(0, Math.floor(n * q)))];
- return {
- n,
- min: a[0],
- max: a[n - 1],
- mean: sum / n,
- p1: p(0.01), p50: p(0.5), p90: p(0.9), p95: p(0.95), p99: p(0.99),
- p: (q) => p(q),
- };
- }
skills/build-world/engines/threejs/templates/subsystem.js · Bundled script · 105 lines · 1 finding marked
- import * as THREE from 'three';
- import { scratch, Owned, disposeTree, compileMeshes, Pool } from '../lib/index.js';
- /** Module-scope scratch. Allocated once. Never inside a per-frame function. */
- const S = scratch();
- /**
- * <SYSTEM> — <one line: what it owns>.
- Note: Usual in code (tag names in paths and patterns): Contains a <system> block, a common wrapper for instructions hidden in a tool description
- Line 8 on GitHub
- *
- * Copy this file, delete what you do not need, and keep the parts that are
- * commented as contract. Every hook here exists because a tool depends on it.
- */
- export class TemplateSystem {
- /** Unique id. Others reach you with ctx.get('<id>') — never by import. */
- static id = 'template';
- /** Systems that must init() before you. Topo-sorted; order of add() is irrelevant. */
- static deps = ['render'];
- async init(ctx) {
- this.ctx = ctx;
- /** Everything disposable you create goes through this. */
- this.own = new Owned();
- /** Your OWN random stream, so your output does not depend on what another
- * subsystem consumed from the shared one. */
- this.rng = ctx.rng.fork();
- this.root = new THREE.Group();
- this.root.name = TemplateSystem.id;
- ctx.scene.add(this.root);
- const q = ctx.config.q;
- // Fixed-capacity pool sized from the budget. Never grows; counts rejections.
- this.things = new Pool(
- q.particleBudget,
- () => ({ alive: false, position: new THREE.Vector3() }),
- (t) => {
- t.alive = false;
- }
- );
- // Listen; never reach into another subsystem to ask what happened.
- ctx.events.on('example:event', (e) => this.onExample(e));
- }
- onExample(e) {
- const t = this.things.acquire();
- if (!t) return; // at budget — dropping is correct, growing is not
- t.alive = true;
- t.position.copy(e.position);
- }
- /** Deterministic simulation. 0..N times per frame. Do NOT read input edges here. */
- fixedUpdate(h, ctx) {}
- /** Once per frame. Animation, decisions, anything reading input edges. */
- update(dt, ctx) {
- // Animate off the engine clock. NEVER performance.now(). See PITFALLS A3.
- const t = ctx.time.elapsed;
- S.v0.set(Math.sin(t), 0, Math.cos(t)); // scratch, no allocation
- }
- /** After every update(), before render: anything that must see final transforms
- * (attachments, light-count stabilisation, instance buffer flushes). */
- lateUpdate(dt, ctx) {}
- resize(w, h, ctx) {}
- /**
- * CONTRACT: compile every material this subsystem can produce, WITHOUT spawning
- * gameplay objects, drawing a gameplay frame, or touching the clock or the RNG.
- * compileMeshes() binds a 1x1 render target first, which is what puts the right
- * colour space and tone mapping in the program cache key. See PITFALLS B3/B4.
- */
- async prewarmMaterials(ctx) {
- const meshes = [];
- this.root.traverse((o) => {
- if (o.isMesh) meshes.push(o);
- });
- return { ok: true, compiled: compileMeshes(ctx.get('render').renderer, meshes, ctx.scene, ctx.camera) };
- }
- /**
- * Debug hook for the shot list and the profiler. `kind === 'none'` must FULLY
- * clear — a looping effect that survives into the next shot produces phantom
- * regressions in the next review round (PITFALLS A6).
- *
- * `opts.grabFrame` is how many frames the harness pumps before the shutter; use
- * it to land a transient's peak on the captured frame. Re-seed the RNG so the
- * staged effect is identical regardless of what ran before it.
- */
- debugStage(kind, opts = {}) {
- this.rng.seed(0x51a6ed);
- if (kind === 'none' || !kind) {
- /* clear everything you staged */
- return { cleared: true };
- }
- return { staged: kind, peakAt: Math.max(4, Number(opts.grabFrame ?? 60) - 6) };
- }
- dispose() {
- disposeTree(this.root);
- this.root.parent?.remove(this.root);
- this.own.disposeAll();
- }
- }
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.