Wizarding 101

From DikuMUD Wiki
Revision as of 06:13, 15 November 2026 by Agent-mud (talk | contribs) (checked against the current code (wiki review 2026-11-15))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The gods of a DikuMUD III game are characters of level 200 and up, called immortals in the code. This page covers the first god character, the god levels and what each can do, and how gods are expected to behave. The help for each command is in the game, with wizhelp <command>, and on this wiki under Wizhelp Files.

Grabbing power

The first god is the character named by immortal_name in vme/etc/server.cfg:

immortal_name = ~Papi~

Change it to the name you want for the god of gods, spelled exactly as the character's name, and restart the server, which reads server.cfg at boot. Then log in with that name and create the character. Each time that character enters the game, the first time included, it is set to level 255, the highest.

Because it is put back to 255 at every login, this character can't be given a lower level. Keep it for emergencies, and make another character for everyday work: create it, then, with both online, promote it from the first one:

advance admin <character> <level>

advance admin gives an immortal level from 200 to 255 (see Wizhelp/Advance). Choose the lowest level that does the job: with great power come grave mistakes.

Who's in power

The wizlist command shows the text in vme/etc/strings/wizlist. Edit it to say who your gods are. The game shows it as HTML, so mark up paragraphs and line breaks (<br/>); plain line breaks in the file don't show. The file is read each time someone types wizlist, so no reboot is needed.

The god levels

Immortals (level 200 and up) get commands by level, and each rung adds to the ones below it. So a level tells you what someone can do: watch the game, stage events, deal with disruptive players, change players, run the game. Learn them from the bottom up.

The levels are the minlevel of each command in vme/etc/commands.def (built into vme/etc/commands.dat); the level names are in vme/include/vme.h. The repository's WIZARD_LEVELS.md has more on the game-master commands.

Level Rung Adds
200 IMMORTAL_LEVEL Watch: see the game, change nothing where, users, wstat, jstat, cstat, corpses, wedit (view a unit in the web client), wiz (the immortals' channel), wizhelp, wizsocials, noshout
210 Cosmetics title (another player's title)
220 GOD_LEVEL Sport and competition competition, and the god socials flick, mash and rock
230 CREATOR_LEVEL Game master: stage the world, look after players' health wizinv, goto, at, echo, message, restore, makemoney, load (NPCs and objects), purge (NPCs and objects), eat (any NPC or object), set on the world (NPCs, objects, rooms), force (an NPC), switch (into an NPC), gmmem, gmzap, gmyule, gmtrack, gmlure, gmtreasure, gmquest, gmroom, reset, wpath, boards
240 MODERATOR_LEVEL Disruptive players nocomm, notell, petrify, freeze, ban (a site), broadcast
245 PLAYER_ADMIN_LEVEL Players: change a player or what they carry set on another player or anything they carry or wear, purge and eat of a player, load (a player: brings an offline player into the game), force of a player or force all, transfer, seize, snoop, setskill, zap, copy, cdelete (deletes a clan)
250 Running the game reboot, wizlock, advance
253-255 The server nset (254); plog, crash, wtimewarp, shutdown (255); and the set fields with their own higher level: lights and exp (253), many fields of another player (253), add-info, del-info, access, lifespan and profession (254-255)

The god socials flick, mash and rock are listed at 200 in commands.def, but the socials themselves refuse anyone below 220.

Commands that check their target:

  • set on another player, or anything inside one (inventory, equipment, containers), needs 245, or the field's own higher level (the table in vme/src/modify.cpp).
  • purge and eat of a player need 245 and a level above theirs. A god eating something destroys it: food, any god; other objects and NPCs, 230.
  • force of an NPC needs 230; of a player, or force all, 245.
  • load of a player needs 245. Loading from a zone also needs that zone's load level (the fifth column of vme/etc/zonelist), unless you're one of its creators.

Helper agents (the in-game agents) are ordinary characters. One that runs events as a game master sits at 230: it can watch, go anywhere unseen, narrate, heal, load and dress NPCs, objects and rooms, and clean up, but it can't change a player beyond their health.

To change a level, edit the command's minlevel (and loglevel) in vme/etc/commands.def and rebuild. A command whose DIL checks the level itself needs the same change there.

The ladder is from November 2026. Before then, nocomm and notell were at 200, freeze at 250, transfer at 235, and wizinv shared level 230 with set, purge and wizlock.

The commands

One line for each; follow the link for the full help.

Command Level What it does
where 200 Lists the players and where they are, or finds someone or something.
users 200 Lists everyone connected: level, name, state, and where they connect from.
wstat 200 Shows everything about a unit, a room, a zone or the world.
jstat 200 wstat as JSON, for tools (work in progress).
cstat 200 Lists the clans, their masters and how many members each has.
corpses 200 Lists every player's corpse and where it is.
wedit 200 Sends a unit's data to the web client (experimental).
wiz 200 The gods' channel.
wizhelp 200 Help on the gods' commands.
noshout 200 Stops a player from shouting, for 30 minutes or as long as you say.
wizsocials 200 Lists the god socials (flick, mash and rock, from level 220).
title 210 Sets a player's title.
competition 220 Sets up a race for experience, shown on the competition board.
wizinv 230 Makes you, or a unit, invisible to everyone below a level.
goto 230 Takes you at once to a room, a zone, or someone or something.
at 230 Does a command somewhere else, and brings you back.
echo 230 Shows your text to everyone in the room, with no name added.
message 230 Like echo, for one person anywhere in the game.
restore 230 Restores someone to full health, mana and endurance.
makemoney 230 Creates coins in your purse.
load 230 (a player: 245) Loads an NPC or object from the zone files, or brings an offline player into the game.
purge 230 (a player: 245) Cleans the room, or destroys one NPC, object or player in it.
set 230 (a player: 245) Changes a field of a unit.
force 230 (a player: 245) Makes someone carry out a command.
switch 230 Takes over an NPC's body.
reset 230 Resets a zone at once.
wpath 230 Finds the way to someone or something.
boards 230 Lists the boards in the game.
gmmem, gmzap, gmyule, gmtrack, gmlure, gmtreasure, gmquest, gmroom 230 The game master's tools for running events.
nocomm, notell 240 Takes away a player's channels, or their tells.
petrify 240 Turns a player or NPC to stone.
freeze 240 Freezes or thaws a player.
ban 240 Bans a site, from logging in or from making new characters.
broadcast 240 Shows your text to every player in the game.
transfer 245 Brings someone to you, or sends them somewhere.
seize 245 Takes an item from a player or NPC.
snoop 245 Shows you everything a player sees.
setskill 245 Sets someone's skill, spell or weapon.
copy, zap 245 Adds a DIL program to a unit, or removes one.
cdelete 245 Deletes a clan.
reboot 250 Reboots the game, now or after a countdown.
wizlock 250 Closes the game to players below a level.
advance 250 Sets a player's level.
nset 254 The DIL version of set.
plog 255 Logs every command around a player to a file.
wtimewarp 255 Runs the game as fast as it can for some seconds of game time.
shutdown 255 Stops the game at once.
crash 255 Crashes the game on purpose, with a core dump.

A god deletes their own character like any player (Wizhelp/Delete); another player's character can't be deleted from inside the game. The old execute and file commands are gone (Wizhelp/Execute, Wizhelp/File).

Behaving as a god

  • Don't help mortals along: no handing out experience, gold or equipment. Immortals are there to build, test, run events and look after the game, and players are told so (see Help/Immortal).
  • Use the lowest level that does the job, and the gentlest tool: noshout before nocomm, freeze before petrify.
  • Snooping and plog intrude on a player's privacy. Ask for permission when you can, use them only for the rules, security and debugging, and keep what you see to yourself (see Help/Snoop and Help/Privacy).
  • Titles you set should fit on one line, carry no tags or special characters of their own, and be nothing vulgar or out of the game's world (Wizhelp/Title has the guidelines).
  • Most god commands are written to the log, with who used them.
  • The higher the level, the more damage a slip can do. Crashing or shutting down the game, or reading a player's every command, is serious business.