How-to guides
Task-sized recipes. Each page solves one goal with real, verified APIs and a way to check it worked. These assume you’ve done the Your first game tutorial (for game tasks) or Extending the engine (for engine tasks) — they don’t re-teach the basics, they link to them.
Looking for the “why” behind a recipe? Follow the links into Concepts. Looking for the exact signature? See the API reference.
Building a game
| I want to… | Recipe |
|---|---|
| Spawn entities and move them | Spawn and transform entities |
| Give surfaces materials and light a scene | Materials and lighting |
| Load a mesh, texture, or sound | Load assets |
| Play positional 3D audio | Play 3D audio |
| Lay out a UI | Build a UI |
| Save and restore the world | Save and load scenes |
| Bind input to actions | Map input |
Extending the engine
| I want to… | Recipe |
|---|---|
| Define and register an ECS component | Add a component |
| Add a hot-path strategy to an agent | Add a lane |
| Add a new strategist subsystem | Add an agent |
Add a .wgsl shader and a pipeline | Add a shader |
| Decode a new asset format | Add an asset decoder |
| Project the World into a View for lanes | Add a flow |
| Pin or bound an agent’s adaptation | Control GORNA adaptation |
Operating and tuning
| I want to… | Recipe |
|---|---|
| Find and fix a problem | Troubleshoot |
| Measure and tune performance | Profile performance |
| Investigate one frame or a GORNA decision | Debug a frame |
New here? Start with a tutorial instead — how-to guides assume you already know the ropes.