Skip to content

Getting started

You need Node.js 24 or newer, Docker (Docker Desktop on macOS, or Docker Engine with the Compose plugin) and your own Ultima Online game files.

  1. Install the CLI, or run it with npx gemwright instead.

    Terminal window
    npm install --global gemwright
    gemwright --help
  2. Create a shard project. The questionnaire asks for a name, emulator, expansion and client version; --yes accepts the defaults.

    Terminal window
    gemwright init my-shard
    cd my-shard

    This writes gemwright.json and the files the emulator needs. A blank owner password is generated and shown once; save it. If you give it your game files directory, deploys can omit --files.

  3. Deploy the server on this machine, pointing at your game files.

    Terminal window
    gemwright shard deploy --target local --files ~/uo

    The first start compiles scripts and can take several minutes. Native clients log in at 127.0.0.1:2593.

  4. Add the browser client beside it.

    Terminal window
    gemwright shard deploy --client --files ~/uo

    Open http://localhost:3000.

Log in with the owner account you chose during init:

  • ServUO: [createworld opens the world-generation menu.
  • RunUO: [Decorate adds world decoration; spawning depends on your spawn scripts.
  • Sphere-X: .add i_world_decorator and .add i_world_spawner, then double-click each item.
  • Sphere: world generation depends on your script pack.