2.2.14 • Published 8 months ago

@latticexyz/explorer v2.2.14

Weekly downloads
-
License
-
Repository
-
Last release
8 months ago

World Explorer

World Explorer is a GUI tool designed for visually exploring and manipulating the state of worlds. For the full information about it, see the official docs.

Getting started

Prerequisites

World Explorer is not intended to be used alone, and includes the following prerequisites:

Install and run

pnpm add @latticexyz/explorer
pnpm explorer

Or, can be executed with a package bin directly:

npx @latticexyz/explorer

Note: worlds.json is the default file used to configure the world. If you're using a different file or if the file is located in a different path than where you're running the command, you can specify it with the --worldsFile flag, or use --worldAddress to point to the world address directly. Accordingly, indexer.db is the default database file used to index the world state. If you're using a different database file or if the file is located in a different path than where you're running the command, you can specify it with the --indexerDatabase flag.

Example setup

For a full working setup, check out the local-explorer example.

You may also want to check out the MUD Quickstart guide to set up a new MUD template project that already comes with the World Explorer included, along with all the prerequisites.

CLI arguments

The World Explorer accepts the following CLI arguments:

ArgumentDescriptionDefault value
worldAddressThe address of the world to exploreNone
worldsFilePath to a worlds configuration file (used to resolve world address)"worlds.json"
indexerDatabasePath to your SQLite indexer database"indexer.db"
chainIdThe chain ID of the network31337
portThe port on which to run the World Explorer13690
hostnameThe host on which to run the World Explorer0.0.0.0
devRun the World Explorer in development modefalse

Contributing

To contribute to World Explorer, first get familiar with the MUD contribution guidelines. Then, set up the development environment for World Explorer:

  1. Clone MUD

    git clone git@github.com:latticexyz/mud.git
    cd mud
    pnpm install
    pnpm build
  2. Setup

    Navigate to the examples/local-explorer and install dependencies.

    cd examples/local-explorer
    pnpm install
  3. Run

    pnpm dev

    Files can now be edited in the packages/explorer directory, and changes will be reflected in the running World Explorer instance.

Links

2.2.14

9 months ago

2.2.13

9 months ago

2.2.12

9 months ago

2.2.11

9 months ago

2.2.10

10 months ago

2.2.9

10 months ago

2.2.8

10 months ago

2.2.5

10 months ago

2.2.4

10 months ago

2.2.7

10 months ago

2.2.6

10 months ago

2.2.3

10 months ago

2.2.2

10 months ago

2.2.1

10 months ago

2.2.0

10 months ago