This repository contains a starter World Engine project that you can use as a scaffold for your project.
To begin your development journey with World Engine, you install World CLI a tool for creating, managing, and deploying World Engine projects.
Install the latest world-cli release by running:
curl https://install.world.dev/cli! | bashDocker is used to make it easy to run the World Engine stack and its dependencies. If you don't already have Docker installed, you can find instructions for your platform here:
Installation instructions for Docker Desktop
To use this template to start your own project, navigate to the directory where you want your project to live and run:
world createYou will be prompted for a game name. A copy of the starter-game-template will be created in the current directory.
World Engine dev mode provides a fast and easy way to run and iterate on your game shard.
To use it, navigate to your project directory and run
world cardinal devTo run the World Engine stack end-to-end (i.e. in production and game engine integration), run:
world cardinal startThis command will use the world.toml config specified in your root project directory to run both World Engine's
Cardinal game shard and Nakama relayer (for game engine integration).
Make sure to set CARDINAL_MODE="production" in world.toml to run the stack in production mode and obtain the best performance.
The Cardinal Editor is a web-based companion app that makes game development of Cardinal easier. It allows you to inspect the state of Cardinal in real-time without any additional code.
To access it, run world cardinal start or world cardinal dev
Then, open the Cardinal Editor in a web browser.
After you create some entities in your game, it will show up on the Cardinal Editor.
For more details on how to create the game of your dream, visit the World Engine documentation