UOUndeathCodex

Hand-maintained page (not auto-generated). Edit it directly; the reference generator leaves it alone.

Game Master Guide

Everything a staff member needs to run the realm: what your privilege level grants, the built-in SphereServer commands you'll reach for daily, and the custom staff tools this shard adds. If you're rusty on SphereServer itself, start with the SphereServer Reference.

Commands are typed into the client's chat bar with a leading dot (.go britain). Most are gated by your privilege level — if nothing happens, you probably don't have the plevel for it. Anything that deletes or moves world objects (.remove, .nuke, .tweak) is immediate and unlogged to the victim — measure twice.

Privilege levels (plevels)

Every account has a privilege level from 0 to 7. It's the master switch for what you can see and do. On this shard the scripts treat anyone above plevel 1 as "staff" (e.g. IF (<src.account.plevel> > 1)), so plevel 2+ unlocks the custom staff branches.

Plevel Role What it means here
0 Guest Locked-down trial account
1 Player Normal players — the default for new accounts
2 Counselor Lowest staff tier; passes every plevel > 1 staff check
3 Seer World-building / event-running staff
4 Game Master Full moderation + world-editing toolkit
5 Developer GM plus script-facing power
6 Administrator Account & server administration
7 Owner Everything — the account you bootstrap with

Becoming staff

Plevel is set from the server console, not in-game. Attach to it and raise an account:

make server-console      # detach with Ctrl-P Ctrl-Q — never Ctrl-C

account create myname mypassword
account myname PLEVEL 7

(See docs/running.md; make server-account prints this reminder.) You can also change a plevel from the in-game Admin Panel (below).

The .gm switch

.gm toggles your character's GM mode: invulnerable, ignores line-of-sight and weight, sees hidden things, and walks through the world as staff. Treat it as your "on duty" flag — flip it off when you want to move around like a normal player. (This shard's scripts also use .invis to hide staff during events.)

The everyday toolkit

These are stock SphereServer verbs, grouped by what you're trying to do. Most take a target — you type the command, then click the thing.

Getting around

Command Does
.go <x> <y> [z] [map] Teleport to raw coordinates
.go <place> Teleport to a named point, e.g. .go britain
.gotarg Teleport to whatever you target
.where Print your current location
.allmove Toggle being able to pick up static/locked items

Inspecting & editing objects

Command Does
.tweak Target an item/char to open its full property editor (stats, flags, id, color, skills…) — the GUI you'll use most
.show <property> Target something and print one property, e.g. .show serial, .show name
.set <property> <value> Target something and set a property directly (the command form of .tweak)
.dupe [amount] Duplicate the targeted item
.dye Recolor a targeted item via the dye menu

Creating & removing

Command Does
.add Open the Add menu to spawn items/NPCs from a browsable list
.add <defname> [amount] Spawn directly, e.g. .add i_gold 1000, .add c_orc
.nudge Target an item and shift it by an offset in place
.remove Target a single item/char and delete it
.nuke Select an area and delete every item in it — dangerous, no undo

.nuke and .remove are permanent. There is no trash can and no confirmation on the target. Never .nuke near player houses or vendors.

Characters & players

Command Does
.gm Toggle your own GM mode (see above)
.invis Toggle invisibility
.invul Toggle invulnerability on a target
.kill / .resurrect (.res) Kill or raise a targeted character
.self <property> <value> Set a property on yourself, e.g. .self karma 10000

Moderation & accounts

Command Does
.admin Open the Admin Panel — the shard's account/player console (see below)
.kick Disconnect a targeted player
.ban / .block Ban or block an account (also in the Admin Panel)
.jail / .forgive Jail or release a targeted player — see the Jail System
.pardon Clear criminal / murderer flags on a target
.b <message> Broadcast a server-wide message

Server operations

Command Does
.resync Hot-reload changed .scp scripts without a restart (also RESYNC at the console)
.save Force an immediate world save
.restock Restock vendor inventories

The Admin Panel — .admin

.admin opens this shard's SphereServer Admin Panel (server/scripts/sphere_admin.scp): a paged list of every online client. From it you can tweak a player's stats, skills and flags; read/write staff notes on an account; and kick / ban them. It's the point-and-click alternative to the targeting commands above and the safest way to moderate live players.

Custom staff tools on this shard

Beyond the stock verbs, UOUndeath adds its own staff-gated commands.

.event — run the generic event

Defined in uoud_player_functions.scp and gated to plevel 2+. Type .event with no arguments to see live status and usage:

Subcommand Effect
.event SET Set the event's teleport location to where you're standing
.event RIDE ON / OFF Allow or forbid mounts inside the event
.event EQUIP ON / OFF Allow or forbid equipment inside the event
.event ON / OFF Open or close the event to players
.event DESC <text> Set the description players see
.event RESET Clear location, rides, equipment, and description back to defaults

Players join via the .event command too — for them it teleports into the currently-set event (or tells them none is running). Purpose-built events (Bomberman, Monster Bash, Tourney, …) are documented under Events.

Other staff hooks

  • Jail — .jail / .forgive drive the equipped-timer sentence system; the full mechanic (cell, release runes, indefinite sentences) is in the Jail System.
  • .security — opens the security dialog (Britain / map 0).
  • The leaderboard stones deliberately skip staff (plevel > 1) so your character never pollutes the "richest / most-skilled player" statistics.

See also