# R3

> Create 3D models with AI. Make them do anything with physics, sound and code, in the browser.

R3 is a browser platform for building interactive web applications from composable components: 3D scenes (THREE.js), physics (Rapier), audio and music (Tone.js), on an Entity-Component-System architecture. A project is real JavaScript you edit live in the editor, by hand or with an AI agent through the R3 MCP server, and publish to a public URL. Blender models import directly. R3 Builder makes a Blender model from a description in plain words, ready to edit in your scene. Nothing to install.

## Pages

- [R3 — Create 3D models with AI. Make them do anything.](https://r3js.org/): Describe a model and R3 Builder builds it in Blender, ready to edit. Then bring it to life with physics, sound and code, by hand or with AI.
- [R3 Tutorials — build 3D, physics and music projects step by step](https://r3js.org/tutorials): Guided tutorials that build real R3 projects one step at a time, driving the editor as you read. Nothing to install — it all runs in the browser.
- [R3 Documentation — components, entities and systems](https://r3js.org/documentation): Guides to the R3 platform: how components hold state, how entities bundle them, and how systems turn them into rendering, physics, audio and music.
- [R3 API Reference — every component, system and event](https://r3js.org/api-documentation): The complete R3 API, generated from the component and system definitions themselves: every property, every reference, every event you can hook.
- [R3 Roadmap — what is being built next](https://r3js.org/roadmap): What is being built in R3, what is planned, and what other people have voted for. Public, and open to your own suggestions and votes.

## Agents (MCP)

- [R3 MCP server — connect claude.ai or Claude Code, no key needed](https://r3js.org/documentation/mcp): Sign in with R3 from claude.ai or Claude Code, no key needed: starter prompts and how-tos help an agent edit 3D projects live, run them, publish releases you can roll back. Keys for headless use. The server offers starter prompts (MCP prompts), from a first 3D scene to a car you can drive, and step-by-step how-to guides Claude reads with r3_docs_read (one is choosing when a script runs: every frame, or once per key press, click, swipe, beat or collision, HOWTO_CODE_EVENTS.md); the same tasks as videos: [How-to videos](https://r3js.org/videos/how-to). Find R3 under Connectors in claude.ai: [Claude Connectors Directory](https://claude.ai/directory/connectors/r3).

## Tutorials

- [Accounts & Privacy](https://r3js.org/tutorials/accounts-and-privacy): Why R3 asks you to have a real account, how "Continue with Google" works without a Google script or a single cookie, and what each way of signing in means for the work you publish.
- [Create your first project](https://r3js.org/tutorials/create-your-first-project): Five minutes from sign-up to an empty R3 project ready to build in. Just the click path — no concepts, just the buttons.
- [Where will your project run?](https://r3js.org/tutorials/where-will-your-project-run): Before you add content, decide what shape your project lives in — fullscreen page, embedded iframe, fixed aspect for portrait or landscape. This decision shapes your camera and renderer setup, and it's far cheaper to get right at the start than to retrofit later.
- [Add your first components](https://r3js.org/tutorials/add-entity-component): From an empty scene to your first visible shape. The build-from-the-ground-up approach you'll use most of the time — pick components from the Create overlay, tweak their properties live right here in the tutorial.
- [Save, reload, share](https://r3js.org/tutorials/save-reload-share): See that every change is kept automatically, pick the picture people see when you share, prove it survives a page reload, and send a preview link to a friend. The core keep-and-share loop.
- [Understanding ECS](https://r3js.org/tutorials/understanding-ecs): Entities, components, and systems — the architecture that lets R3 compose behavior without inheritance trees.
- [Event-Driven Architecture](https://r3js.org/tutorials/event-driven-architecture): How R3 systems coordinate without knowing about each other — the event bus that glues the whole framework together.
- [Real-Time Semantics](https://r3js.org/tutorials/real-time-semantics): Why edits apply live without restarting your scene — and what that unlocks for interactive content.
- [Code Components — make it do something](https://r3js.org/tutorials/code-components): A code component is just another component — its data is the JavaScript you write and the event it runs on. Attach one, paste a few lines, and watch your cube spin, bob, and shift colour. Your first interactive behaviour, in minutes.
- [Claude in your terminal](https://r3js.org/tutorials/claude-in-your-terminal): Open R3's in-browser terminal and Claude Code starts in your own private sandbox, already connected to your R3 account. What the sandbox holds, signing in to Claude, how Claude works on your projects through R3's tools, and what works well.
- [Audio & Music](https://r3js.org/tutorials/audio-and-music): Two audio subsystems — Audio components for one-shot sounds, and the Music system for procedural drum patterns + melodies with Tone.js.
- [Physics](https://r3js.org/tutorials/physics): Drop something. Push it. Catch it when it lands. R3 wraps the Rapier physics engine in components so you can simulate motion, collision, and contact without leaving the inspector.
- [Blender import](https://r3js.org/tutorials/blender): Upload a .blend file, get back R3 meshes, materials, and textures. The fastest way to bring real geometry into your scene.
- [Texture mapping in depth](https://r3js.org/tutorials/texture-mapping): The full PBR texture surface beyond the single `map` slot — normal, roughness, metalness, AO, emissive, environment. UV controls, sourcing maps, gotchas, and what's not supported yet.
- [Working with the Inspector](https://r3js.org/tutorials/working-with-the-inspector): The three zones of the R3 editor — what you can add, what you already have, and how to tweak it. Plus the input types, search, and the things you can do today vs the things on the roadmap.
- [Building reusable entities](https://r3js.org/tutorials/building-reusable-entities): Save a working set of components as an entity template, then instantiate it anywhere. The reuse pattern for when you've built something good and want it everywhere — plus the one rule that keeps entities portable.
- [Why R3 isn't completely free](https://r3js.org/tutorials/why-r3-isnt-completely-free): What R3 is built for, what's free, what isn't, and what your support pays for. A short note on the values behind the platform.
- [Support & Roadmap](https://r3js.org/tutorials/support-and-roadmap): How to file a support ticket, what the roadmap is for, and how the two connect — the channels R3 uses to evolve with the people building on it.
- [Building a bouncing ball entity](https://r3js.org/tutorials/bouncing-ball-entity): A worked example that ties together Physics, Code Components, and Entities. Start from the Physics Sphere preset, add click-to-launch behavior with a code component, save the whole bundle as a reusable entity, and instantiate it into a fresh project.
- [Edit mode — move things in 3D](https://r3js.org/tutorials/edit-mode): Press Tab and the flat editor becomes a 3D workspace — grid, orbit camera, and transform gizmos. Select a mesh, drag it, rotate it, scale it, snap it to a grid. The hands-on way to compose a scene by eye.
- [Publishing & Going Live](https://r3js.org/tutorials/publishing-and-going-live): Take your work from "it runs in my editor" to "anyone with a link can play it". Preview, Publish, releases, the portal, portal settings, how many projects can be live.
- [Systems — bring your scene to life](https://r3js.org/tutorials/systems): Components hold state; systems make them DO something. Meet the four you switch on and off — Physics, Code, Audio, Music — and the one rule that explains most "why isn't this working?" moments.
- [Build a music-reactive torus knot with Claude](https://r3js.org/tutorials/music-reactive-torus-knot): A worked example that ties together the Music system, Code Components, and the AI sandbox. A torus knot that pulses, spins, and colour-shifts in sync with a procedural drum track — built with Claude writing the reactive code for you.
- [Driving Blender with Claude](https://r3js.org/tutorials/blender-mcp): Let Claude read and edit your Blender scene directly — install the MCP bridge, and the three non-obvious things that stop it working.
- [Blender MCP on Blender 4.x](https://r3js.org/tutorials/blender-mcp-4x): The community MCP bridge — works on Blender 4.2 and up, installs itself, and can pull assets from Poly Haven and Sketchfab.
- [When a Blender import looks wrong](https://r3js.org/tutorials/blender-import-troubleshooting): Symptom-first troubleshooting for imported models — why Flip Y is the wrong knob, how to spot a mirrored texture, and what R3 doesn't import yet.
- [Build with Claude: a Blender model while you watch](https://r3js.org/tutorials/build-with-claude-blender): Claude builds a Blender model on R3 while you watch the drafts in 3D: start a model, add reference pictures, steer in plain words, save it to My models and add it to a project.
- [How to connect Claude to R3 in under a minute](https://r3js.org/tutorials/how-to-connect-claude): Add R3's server address to Claude, sign in with your R3 account, press Allow, and ask Claude which account it is connected as.
- [How to build your first 3D scene with Claude](https://r3js.org/tutorials/how-to-build-your-first-scene): Pick R3's starter prompt in Claude and watch it make a project, a ground, four coloured shapes, the camera and a preview link.
- [How to make an object spin with code in R3](https://r3js.org/tutorials/how-to-make-an-object-spin): Add a Cube and a Code component, add one line to the script's update, Save, then Start Code.
- [How to move an object with the keyboard in R3](https://r3js.org/tutorials/how-to-move-with-the-keyboard): Add a Cube, a Code component with two lines for the arrow keys, and a Help component for the controls, then Start Code and hold an arrow key.
- [How to make balls bounce in R3](https://r3js.org/tutorials/how-to-make-balls-bounce): Add a Physics Plane and Physics Spheres, set restitution to 0.9 on every collider (the ground too), then start physics.
- [Make something happen on a key press or click](https://r3js.org/tutorials/key-press-or-click): A Code component runs on the event you choose. Make a ball jump when you press Space and change colour when you click it: pick Key Down or Mouse Click in the Inspector, write three lines, press Start.
- [How to randomize a terrain in R3](https://r3js.org/tutorials/how-to-randomize-a-terrain): Give a terrain a real size, press Randomize terrain for new hills, then set the seed, the hill height and the hill width.
- [How to change a material's colour in R3](https://r3js.org/tutorials/how-to-change-a-material-colour): Find a mesh's material from its Material row, drag red, green and blue to pick a colour, then turn Metalness up and Roughness down for shiny metal.
- [How to change a light in R3](https://r3js.org/tutorials/how-to-change-a-light): Open a point light in the Inspector, change its colour, set Intensity for how bright and Distance for how far it reaches, then move it.
- [How to share a Blender model as a link in R3](https://r3js.org/tutorials/how-to-share-a-blender-model): Import a Blender model from Models, frame it with the camera, add Orbit Controls so anyone can turn it, then Create Preview for a private link.
- [How to make a preview link in R3](https://r3js.org/tutorials/how-to-make-a-preview-link): Open Deploy, set how the page starts, which controls show and its title, then press Create Preview for a private link to copy or open.
- [How to make a moving platform](https://r3js.org/tutorials/how-to-make-a-moving-platform): A lift that carries what stands on it: give a box a RigidBody Kinematic (Position) and a Collider Cuboid, move it from a Code component, then start Physics and Code.

## Videos

- [Videos](https://r3js.org/videos): Short videos of R3 in real use, each with chapters and the full transcript.
- [How-to videos](https://r3js.org/videos/how-to): One task each, in the R3 editor or with Claude, in well under a minute. Each with captions, chapters and the full transcript.
- [How to share a Blender model as a link in R3](https://r3js.org/videos/how-to-share-a-blender-model): Share a Blender model as a link in R3: import it from Models, frame it with the camera, add Orbit Controls, then Create Preview. 53 seconds, with captions and transcript.
- [How to make an object spin with code in R3](https://r3js.org/videos/how-to-make-an-object-spin): Make an object spin with code in R3: add a Cube and a Code component, add one line to update, press Save, then Start Code. 44 seconds, with captions and transcript.
- [How to make a preview link in R3](https://r3js.org/videos/how-to-make-a-preview-link): Make a preview link in R3: open Deploy, set how the page starts and its title, then press Create Preview for a private link to share. 58 seconds, with captions and transcript.
- [How to move an object with the keyboard in R3](https://r3js.org/videos/how-to-move-with-the-keyboard): Move an object with the arrow keys in R3: a Cube, a Code component with two lines, a Help for the controls, then Start Code. 45 seconds, with captions and transcript.
- [How to randomize a terrain in R3](https://r3js.org/videos/how-to-randomize-a-terrain): Randomize a terrain in the R3 Inspector: give it a size, press Randomize terrain, then set the seed, the hill height and the hill width. 40 seconds, with captions and transcript.
- [How to change a material's colour in R3](https://r3js.org/videos/how-to-change-a-material-colour): Change a material's colour in the R3 Inspector: find the mesh's material, drag red, green and blue, then metalness and roughness. 34 seconds, with captions and transcript.
- [How to change a light in R3](https://r3js.org/videos/how-to-change-a-light): Change a light in the R3 Inspector: its colour, its intensity, how far it reaches and where it stands. 31 seconds, with captions and transcript.
- [How to assign a texture to a mesh in R3](https://r3js.org/videos/how-to-assign-a-texture): Put a texture on a mesh in the R3 Inspector: set the material's Diffuse Map for the colour and its Normal Map for relief. 29 seconds, with captions and transcript.
- [How to attach physics to a mesh in R3](https://r3js.org/videos/how-to-attach-physics): Attach physics to a mesh in R3: add a rigid body and a collider, set their Mesh, press play on Physics. 32 seconds, with captions and transcript.
- [How to connect Claude to R3 in under a minute](https://r3js.org/videos/how-to-connect-claude): Connect Claude to R3: add R3's server address as a connector, sign in, press Allow, and ask Claude which account it is connected as. 43 seconds, with captions and transcript.
- [How to build your first 3D scene with Claude](https://r3js.org/videos/how-to-build-your-first-scene): Build your first 3D scene with Claude: pick R3's starter prompt, and Claude makes a project, a ground, four shapes, the camera and a preview link. 35 seconds, with captions and transcript.
- [How to make balls bounce in R3](https://r3js.org/videos/how-to-make-balls-bounce): Make balls bounce in R3: a Physics Plane, Physics Spheres, restitution 0.9 on every collider (the ground too), then start physics. 35 seconds, with captions and transcript.
- [Build a monster truck in R3, and let Claude make it drivable](https://r3js.org/videos/monster-demo): A monster truck built in R3 with Claude: terrain, gravel and a Blender truck, then physics, a drive script, three cameras and engine sound. With chapters and transcript.
- [Claude adds physics to a 3D truck and makes it drivable](https://r3js.org/videos/mcp-demo): Claude, connected to R3, makes a monster truck imported from Blender drivable: a rigid body, a collider, four wheels and a drive script, live in the editor. With chapters and transcript.
- [Drop a .blend file and see it in 3D in your browser](https://r3js.org/videos/drop-a-blend): A .blend file dropped on blender.r3js.org opens in 3D, right in the browser: no Blender install and no account to view it. With chapters and the full transcript.

## Showcase

- [Showcase](https://r3js.org/showcase): Games, physics scenes, music and 3D models built with R3 and published live. Every project runs in the browser — open one to explore it, no install needed.
- [Bike Stand - Marthinus](https://r3js.org/showcase/tj/bike-stand-marthinus-)
- [Chess](https://r3js.org/showcase/tj/chess)
- [Guitar](https://r3js.org/showcase/tj/guitar)
- [Maserati 3](https://r3js.org/showcase/tj/maserati-3)
- [Max Roof](https://r3js.org/showcase/tj/max-roof)
- [Monster](https://r3js.org/showcase/tj/monster)
- [Monster Truck](https://r3js.org/showcase/tj/monster-truck)
- [Pool 2](https://r3js.org/showcase/tj/pool-2)
- [R3 Logo](https://r3js.org/showcase/tj/r3-logo)
- [Rocket Monster – Thruster-Powered Monster Truck](https://r3js.org/showcase/tj/rocket-monster)
- [Rocket Roadster](https://r3js.org/showcase/tj/rocket-roadster)
- [roof-stack-order](https://r3js.org/showcase/tj/roof-stack-order)
- [Shed Roof 5](https://r3js.org/showcase/tj/shed-roof-5)
- [Space Invader](https://r3js.org/showcase/tj/space-invader)
- [support](https://r3js.org/showcase/tj/support)
- [Wood 3](https://r3js.org/showcase/tj/wood-3)