From 1874a427b733b9d38fb8f0ecd18bf847c3721cc9 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:55:51 +0000 Subject: [PATCH 1/7] fix(root): terminology, cross-references, and autonomous worlds section - Spell out Entity-Component-System (ECS) on first mention in overview.mdx - Add Autonomous Worlds section with link to /theory/autonomous-worlds in overview.mdx - Add cross-reference between overview.mdx AI skills and installation.mdx - Add overview link from brand.mdx Core Dojo Brand section Co-authored-by: Daniel Kronovet --- docs/pages/brand.mdx | 1 + docs/pages/installation.mdx | 1 + docs/pages/overview.mdx | 11 ++++++++++- 3 files changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/pages/brand.mdx b/docs/pages/brand.mdx index 3ae8765e..bae2de14 100644 --- a/docs/pages/brand.mdx +++ b/docs/pages/brand.mdx @@ -11,6 +11,7 @@ Right-click any image and select "Save Image As" to download. ## Core Dojo Brand The Dojo logo represents the complete framework and toolchain for building provable games and applications. +For an overview of how the tools work together, see the [Dojo Overview](/overview).
diff --git a/docs/pages/installation.mdx b/docs/pages/installation.mdx index 563031af..85adb1a7 100644 --- a/docs/pages/installation.mdx +++ b/docs/pages/installation.mdx @@ -261,6 +261,7 @@ sozo build ## Claude Code Skills Dojo provides official [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) skills that give Claude relevant context for working with models, systems, testing, deployment, and more. +For an overview of available skills, see the [Dojo Overview](/overview#ai-assisted-development). To install the skills, run the following in your terminal: diff --git a/docs/pages/overview.mdx b/docs/pages/overview.mdx index 29ec4e40..68c16231 100644 --- a/docs/pages/overview.mdx +++ b/docs/pages/overview.mdx @@ -9,7 +9,7 @@ import Dojo from "../public/dojo-logo.svg?react";

- Dojo is a cutting-edge ECS framework and toolchain for building provable + Dojo is a cutting-edge Entity-Component-System (ECS) framework and toolchain for building provable applications in Cairo, versatile enough to support everything from simple NFT services to the most complex onchain games.
@@ -61,6 +61,13 @@ Cartridge offers Slot, a managed-service execution layer that lets you easily de [Read more about Slot](https://github.com/cartridge-gg/slot) +## Autonomous Worlds + +Dojo is purpose-built for Autonomous Worlds — persistent, permissionless onchain environments governed entirely by their own rules. +Every model, system, and event lives on the blockchain, enabling players and builders to interact with a world that no single party controls. + +[Learn more about Autonomous Worlds](/theory/autonomous-worlds) + ## AI-Assisted Development Dojo provides AI skills for use with AI coding assistants. @@ -75,6 +82,8 @@ Available skills: `dojo-model`, `dojo-system`, `dojo-test`, `dojo-client`, `dojo [Browse all skills](https://github.com/dojoengine/book/tree/main/skills) +For detailed installation instructions, see the [Installation Guide](/installation#claude-code-skills). +

Date: Wed, 22 Apr 2026 19:56:33 +0000 Subject: [PATCH 2/7] fix(client): terminology and cross-references - Standardize 'World Manager' to 'WorldManager' in unity.md to match technical implementation - Rename '## Example Game' to '## Example Project' in bevy.md for consistency - Add dojo.c foundation cross-reference to unrealengine.md Co-authored-by: Daniel Kronovet --- docs/pages/client/sdk/bevy.md | 2 +- docs/pages/client/sdk/unity.md | 10 +++++----- docs/pages/client/sdk/unrealengine.md | 1 + 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/pages/client/sdk/bevy.md b/docs/pages/client/sdk/bevy.md index 264379a4..75049187 100644 --- a/docs/pages/client/sdk/bevy.md +++ b/docs/pages/client/sdk/bevy.md @@ -243,7 +243,7 @@ fn handle_player_actions( } ``` -## Example Game +## Example Project Here's a pedagogical example showing the key concepts for a 3D game where players can spawn and move cubes: diff --git a/docs/pages/client/sdk/unity.md b/docs/pages/client/sdk/unity.md index 378deb4d..ec11cc1e 100644 --- a/docs/pages/client/sdk/unity.md +++ b/docs/pages/client/sdk/unity.md @@ -15,19 +15,19 @@ Whether you're creating a tactical RPG, a real-time strategy game, or an immersi Before diving into the exciting world of onchain games and worlds with Unity, let's explore some essential concepts: -### World Manager +### WorldManager -The **World Manager** is the central hub for organizing and controlling entities within your Dojo world in Unity. +The **WorldManager** is the central hub for organizing and controlling entities within your Dojo world in Unity. ![world-manager](/client/unity/world-manager.webp) -During initialization, the World Manager receives `WorldManagerData`, which defines essential settings like your Torii URL, RPC URL, and world address. +During initialization, the WorldManager receives `WorldManagerData`, which defines essential settings like your Torii URL, RPC URL, and world address. While these settings are initially provided, you have the flexibility to adjust them by creating different scriptable objects. ![world-manager-data](/client/unity/world-manager-data.webp) In Unity, entities are represented by `GameObject` instances. -The World Manager simplifies their management by offering methods to both add/remove entitites and access them collectively or by individual identifiers. +The WorldManager simplifies their management by offering methods to both add/remove entitites and access them collectively or by individual identifiers. ### Synchronization Master @@ -121,7 +121,7 @@ In your Unity project, navigate to the scene where you want to integrate the SDK **Default Configuration** -The World Manager operates with a default configuration called `WorldManagerDataLocalConfig`, residing in `Dojo/Runtime/Config`. +The WorldManager operates with a default configuration called `WorldManagerDataLocalConfig`, residing in `Dojo/Runtime/Config`. ![world-manager-data](/client/unity/world-manager-data.webp) diff --git a/docs/pages/client/sdk/unrealengine.md b/docs/pages/client/sdk/unrealengine.md index 0a8ffc88..edac451a 100644 --- a/docs/pages/client/sdk/unrealengine.md +++ b/docs/pages/client/sdk/unrealengine.md @@ -209,6 +209,7 @@ The format for each function is `` with a ## Updating the Plugin +The dojo.unreal plugin is built on [dojo.c](/client/sdk/c), the foundational C library that powers all Dojo SDKs. To update the plugin to a new version: 1. Build the `dojo.c` library for your platform From a45bfad86758dc7ffeb448553c807967c7864e17 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:57:01 +0000 Subject: [PATCH 3/7] fix(framework): add cross-references for entities and permissions - Add /framework/models/entities link to systems/index.md Next Steps - Add /framework/world/permissions cross-reference to systems/architecture.md Co-authored-by: Daniel Kronovet --- docs/pages/framework/systems/architecture.md | 2 ++ docs/pages/framework/systems/index.md | 1 + 2 files changed, 3 insertions(+) diff --git a/docs/pages/framework/systems/architecture.md b/docs/pages/framework/systems/architecture.md index 0c12b51a..a8f6bbc9 100644 --- a/docs/pages/framework/systems/architecture.md +++ b/docs/pages/framework/systems/architecture.md @@ -225,6 +225,8 @@ mod game_coordinator { ## Permission Architecture +For comprehensive information about managing permissions, see the [Permissions](/framework/world/permissions) guide. + ### Granular Permissions Assign permissions at the finest grain possible while maintaining operational efficiency. diff --git a/docs/pages/framework/systems/index.md b/docs/pages/framework/systems/index.md index b9ba51fe..76474202 100644 --- a/docs/pages/framework/systems/index.md +++ b/docs/pages/framework/systems/index.md @@ -259,6 +259,7 @@ Systems should be designed for testability: Understanding system design philosophy is crucial for building robust Dojo applications. Explore the deeper aspects of system implementation: +- **[Entities](/framework/models/entities)** - How entities work in Dojo's ECS model - **[System Architecture](/framework/systems/architecture)** - Structural patterns and organization - **[System Coordination](/framework/systems/coordination)** - How systems interact and coordinate From a4b44b95523aa20d877d330c45dfbd61c6dc467e Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:57:58 +0000 Subject: [PATCH 4/7] fix(getting-started): terminology and cross-references - Standardize 'World contract' to 'World' and 'local blockchain' to 'sequencer' - Add next-steps.mdx cross-reference to your-first-dojo-app.mdx - Add understanding-the-toolchain cross-reference to development-workflow.mdx Co-authored-by: Daniel Kronovet --- docs/pages/getting-started/development-workflow.mdx | 1 + .../getting-started/understanding-the-toolchain.mdx | 6 +++--- docs/pages/getting-started/your-first-dojo-app.mdx | 13 +++++++------ 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/pages/getting-started/development-workflow.mdx b/docs/pages/getting-started/development-workflow.mdx index c9611a54..7b463813 100644 --- a/docs/pages/getting-started/development-workflow.mdx +++ b/docs/pages/getting-started/development-workflow.mdx @@ -605,5 +605,6 @@ pkill katana && pkill torii ## Next Steps You now have a solid understanding of the Dojo development workflow! +For detailed information about each tool and its configuration options, see [Understanding the Toolchain](./understanding-the-toolchain). Ready to explore what comes next in your journey? Continue to [Next Steps](./next-steps) to discover advanced topics, deployment strategies, and community resources. diff --git a/docs/pages/getting-started/understanding-the-toolchain.mdx b/docs/pages/getting-started/understanding-the-toolchain.mdx index da7278ee..67c6775d 100644 --- a/docs/pages/getting-started/understanding-the-toolchain.mdx +++ b/docs/pages/getting-started/understanding-the-toolchain.mdx @@ -13,7 +13,7 @@ The code examples are run in the context of the `dojo-intro` repo. **What it does**: -- Provides a local blockchain environment +- Provides a local sequencer environment - Mines blocks instantly for fast development - Comes with pre-funded accounts for testing - Supports gRPC for faster network communication @@ -320,8 +320,8 @@ For more information about Saya, [see the docs](/toolchain/saya). Here's the typical development flow: 1. **Sozo** compiles your Cairo code into deployable contracts -2. **Katana** provides a local blockchain to deploy and test on -3. **Sozo** deploys your World contract to Katana +2. **Katana** provides a local sequencer to deploy and test on +3. **Sozo** deploys your World to Katana 4. **Torii** automatically indexes your World's data 5. **Saya** (optionally) generates proofs for settlement diff --git a/docs/pages/getting-started/your-first-dojo-app.mdx b/docs/pages/getting-started/your-first-dojo-app.mdx index 2dd691fb..62a0e3b7 100644 --- a/docs/pages/getting-started/your-first-dojo-app.mdx +++ b/docs/pages/getting-started/your-first-dojo-app.mdx @@ -13,7 +13,7 @@ By the end, you'll have a working game where you can spawn and move a character - The structure of a Dojo project - Basic Entity Component System (ECS) concepts - How to start the development environment -- Deploying your first world contract +- Deploying your first World - Interacting with your deployed game ## Step 1: Create Your Project @@ -204,7 +204,7 @@ ACCOUNTS SEED 2025-07-10T15:46:43.496406Z INFO rpc: RPC server started. addr=127.0.0.1:5050 ``` -Keep this running - it's your local blockchain. +Keep this running - it's your local sequencer environment. :::tip By default, Katana runs on port 5050 @@ -218,7 +218,7 @@ In a new terminal, run the following command using [Sozo](/toolchain/sozo), Dojo cd contracts && sozo build && sozo migrate ``` -_This compiles your Cairo contracts and deploys them to your local blockchain_ +_This compiles your Cairo contracts and deploys them to the local sequencer_ **Expected output:** @@ -339,9 +339,9 @@ Let's break down what you just accomplished: 1. **Defined Components**: `Position` and `Moves` store data about each player 2. **Implemented Systems**: The `spawn` and `move` functions modify component data -3. **Created a world**: Your world contract acts as the central registry for all game data, logic, and access control +3. **Created a World**: Your World acts as the central registry for all game data, logic, and access control 4. **Used the Toolchain**: - - Katana provided a local blockchain + - Katana provided a local sequencer - Sozo managed compilation and deployment - Torii indexed data and sent it to the client @@ -355,7 +355,7 @@ Let's break down what you just accomplished: ### Dojo World -Your world contract coordinates everything: +Your World coordinates everything: - Registers all models and systems - Handles permissions and authorization @@ -377,3 +377,4 @@ You've successfully: Ready to dive deeper? Continue to [Understanding the Toolchain](./understanding-the-toolchain) to learn more about the tools that make Dojo development possible. +When you're ready to explore the broader Dojo ecosystem, see [Next Steps](./next-steps) for advanced topics and deployment strategies. From 6a13614319b85b9ee79eb3f468d92fc8072f09ce Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:58:08 +0000 Subject: [PATCH 5/7] fix(libraries): standardize terminology to 'Dojo framework' - Replace 'Dojo engine' with 'Dojo framework' in origami/index.mdx - Replace 'Dojo's game development framework' with 'the Dojo framework' in alexandria/index.mdx Co-authored-by: Daniel Kronovet --- docs/pages/libraries/alexandria/index.mdx | 4 ++-- docs/pages/libraries/origami/index.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/pages/libraries/alexandria/index.mdx b/docs/pages/libraries/alexandria/index.mdx index 8235d4b2..643a2817 100644 --- a/docs/pages/libraries/alexandria/index.mdx +++ b/docs/pages/libraries/alexandria/index.mdx @@ -17,7 +17,7 @@ _- George Bernard Shaw_ [Alexandria](https://github.com/keep-starknet-strange/alexandria) is a community maintained standard library for Cairo 1.0. It is a collection of useful algorithms and data structures implemented in Cairo. -Alexandria provides essential building blocks for Cairo and Starknet development, covering mathematics, data structures, algorithms, and utilities that complement Dojo's game development framework. +Alexandria provides essential building blocks for Cairo and Starknet development, covering mathematics, data structures, algorithms, and utilities that complement the Dojo framework. :::warning This library is built outside of the Dojo stack development. @@ -278,7 +278,7 @@ Bitcoin protocol implementations and utilities ## Integration with Dojo -Alexandria complements Dojo's game development framework by providing: +Alexandria complements the Dojo framework by providing: 1. **Mathematical Foundations**: Use `alexandria_math` for game mechanics requiring number theory, cryptography, or advanced calculations 2. **Data Management**: Leverage `alexandria_data_structures` for efficient in-memory data handling in systems diff --git a/docs/pages/libraries/origami/index.mdx b/docs/pages/libraries/origami/index.mdx index 385471ae..23927eac 100644 --- a/docs/pages/libraries/origami/index.mdx +++ b/docs/pages/libraries/origami/index.mdx @@ -11,7 +11,7 @@ _The magic of origami is in seeing a single piece of Cairo evolve into a masterp ## Origami -[Origami](https://github.com/dojoengine/origami) is a collection of essential primitives designed to facilitate the development of onchain games using the Dojo engine. +[Origami](https://github.com/dojoengine/origami) is a collection of essential primitives designed to facilitate the development of onchain games using the Dojo framework. It provides a set of powerful tools and libraries that enable game developers to create complex, engaging, and secure blockchain-based games. Each crate focuses on a specific aspect of game development, from mathematical operations and procedural generation to economic mechanisms and security primitives. From 382d186971c7c691b6d7b80108bd9980b922a828 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:58:18 +0000 Subject: [PATCH 6/7] fix(toolchain): rename 'Mining Modes' to 'Block Production Modes' in katana/development.md Katana is a sequencer, not a miner; 'block production' is the accurate term. Co-authored-by: Daniel Kronovet --- docs/pages/toolchain/katana/development.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/pages/toolchain/katana/development.md b/docs/pages/toolchain/katana/development.md index fa293ef9..ee04196d 100644 --- a/docs/pages/toolchain/katana/development.md +++ b/docs/pages/toolchain/katana/development.md @@ -1,15 +1,15 @@ --- title: Katana Development Features -description: Guide to Katana's development features including mining modes, storage options, network forking, and RPC interfaces for local blockchain development. +description: Guide to Katana's development features including block production modes, storage options, network forking, and RPC interfaces for local development. --- # Development Features -Katana provides essential development features designed to streamline local blockchain development and testing workflows. +Katana provides essential development features designed to streamline local development and testing workflows. -## Mining Modes +## Block Production Modes -Katana offers flexible block production through different mining modes. +Katana offers flexible block production through different block production modes. :::info By default, blocks are mined instantly when transactions are received. From cdbf20ffe6a4006d7fccd9cfd39eb3c859aa70c7 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:58:34 +0000 Subject: [PATCH 7/7] fix(tutorials): cross-references and terminology - Add dojo-starter tutorial link to advanced.mdx prerequisites - Capitalize 'Katana' in react.mdx prose - Add dojo-starter LinkCard to react.mdx Next Steps section Co-authored-by: Daniel Kronovet --- docs/pages/tutorials/advanced.mdx | 2 +- docs/pages/tutorials/react.mdx | 7 ++++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/pages/tutorials/advanced.mdx b/docs/pages/tutorials/advanced.mdx index c6eddb50..078c7f40 100644 --- a/docs/pages/tutorials/advanced.mdx +++ b/docs/pages/tutorials/advanced.mdx @@ -5,7 +5,7 @@ Each tutorial builds upon the foundational concepts. ## Prerequisites -Before starting these tutorials, you should have completed the basic tutorials. +Before starting these tutorials, you should have completed the [Dojo Starter tutorial](/tutorials/dojo-starter), which covers the foundational concepts. You'll also need a good understanding of the core concepts. ## Tutorial List diff --git a/docs/pages/tutorials/react.mdx b/docs/pages/tutorials/react.mdx index 7b08ee1f..e48fbdf3 100644 --- a/docs/pages/tutorials/react.mdx +++ b/docs/pages/tutorials/react.mdx @@ -22,7 +22,7 @@ Prerequisites: npx @dojoengine/create-dojo start -t example-vite-react-sdk ``` -2. Run development network with `katana` +2. Run development network with Katana ```bash # In new terminal @@ -85,6 +85,11 @@ This should have given you a good starting point to build your first application Here are some next steps to take:
+