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.
-
Install the CLI, or run it with
npx gemwrightinstead.Terminal window npm install --global gemwrightgemwright --help -
Create a shard project. The questionnaire asks for a name, emulator, expansion and client version;
--yesaccepts the defaults.Terminal window gemwright init my-shardcd my-shardThis writes
gemwright.jsonand 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. -
Deploy the server on this machine, pointing at your game files.
Terminal window gemwright shard deploy --target local --files ~/uoThe first start compiles scripts and can take several minutes. Native clients log in at
127.0.0.1:2593. -
Add the browser client beside it.
Terminal window gemwright shard deploy --client --files ~/uoOpen
http://localhost:3000.
Populate the world
Section titled “Populate the world”Log in with the owner account you chose during init:
- ServUO:
[createworldopens the world-generation menu. - RunUO:
[Decorateadds world decoration; spawning depends on your spawn scripts. - Sphere-X:
.add i_world_decoratorand.add i_world_spawner, then double-click each item. - Sphere: world generation depends on your script pack.
- Concepts: what a shard project contains and how components fit together.
- Put it online on Railway or your own VPS.
- Add AI residents.
