>LORE

a Dojo based, Zork & MUD inspired, fully onchain interactive multiplayer fiction engine.

⚡ Setup

📦 Install the repo with Bun

Clone the repository, then install dependencies with Bun

bun install

💕 Quickstart installer:

Since Dojo 1.5 Katana and Torii have been seperated and this quickstart won't work, we'll be updating this soon.

Automated installer for installing scarb and dojo using asdf and homebrew.

🚸 Update your $PATH getting started with ASDF variables to make sure katana works.

## DONT DO THIS UNTIL WE'VE UPDATED IT!
bun run quickstart

---

🕹️ Development:

Development MODE (local):

bun run dev

🛖 Development MODE (local) runs a local instance of Katana, Torii and the client at https://localhost:5173 and https://localhost:5173/editor. It also uses Cartridge Controller for wallet management.

will create a local SSL certificate with mkcert and asks for sudo password

• First run - make sure password is passed to terminal in order to add root certificate to your OS keychain
• ssl keys are added to package/client/ssl

Trouble shooting Sometimes you have a valid cert, but it browser says connection is insecure:

• You may need to restart your browser in order to register new root ssl cert.

Slot MODE:

will create a local SSL certificate with mkcert and asks for sudo password

bun run dev:slot

🎲 Slot MODE watches + compiles local contracts and allows you to deploy to slot & configures the client to connect to Slot at https://localhost:5173 and https://localhost:5173/editor (use https)

---

🗺️ World deployment:

Initial deployments start with an empty world, use the editor at https://localhost:5173/editor to create and publish a world.

🔧 Manual dependency installation:

brew install asdf
asdf plugin add scarb
asdf plugin add dojo https://github.com/dojoengine/asdf-dojo

asdf install scarb <version>
asdf install dojo <version>

📦 Packages

This is a monorepo containing the following packages:

Package	Description
client	Game client
contracts	Dojo contracts