Difference between revisions of "Wizarding 101"
(Delete command) |
(checked against the current code (wiki review 2026-11-15)) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | 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 <code>wizhelp <command></code>, and on this wiki under [[Manual:Wizhelp Files|Wizhelp Files]]. | |
| − | |||
| − | The | ||
| − | immortal_name = ~Papi~ | + | == Grabbing power == |
| + | The first god is the character named by <code>immortal_name</code> in <code>vme/etc/server.cfg</code>: | ||
| + | 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 <code>server.cfg</code> 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> | |
| − | + | <code>advance admin</code> 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 === | === Who's in power === | ||
| + | The <code>wizlist</code> command shows the text in <code>vme/etc/strings/wizlist</code>. Edit it to say who your gods are. The game shows it as HTML, so mark up paragraphs and line breaks (<code><br/></code>); plain line breaks in the file don't show. The file is read each time someone types <code>wizlist</code>, 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 | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | The levels are the <code>minlevel</code> of each command in <code>vme/etc/commands.def</code> (built into <code>vme/etc/commands.dat</code>); the level names are in <code>vme/include/vme.h</code>. The repository's [https://github.com/Seifert69/DikuMUD3/blob/master/WIZARD_LEVELS.md WIZARD_LEVELS.md] has more on the game-master commands. | |
| − | + | {| class="wikitable" | |
| − | + | ! 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 <code>commands.def</code>, 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 <code>vme/src/modify.cpp</code>). | |
| − | + | * '''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 <code>vme/etc/zonelist</code>), 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 <code>minlevel</code> (and <code>loglevel</code>) in <code>vme/etc/commands.def</code> 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. | |
| − | |||
| − | ''' | + | {| class="wikitable" |
| + | ! Command !! Level !! What it does | ||
| + | |- | ||
| + | | [[Wizhelp/Where|where]] || 200 || Lists the players and where they are, or finds someone or something. | ||
| + | |- | ||
| + | | [[Wizhelp/Users|users]] || 200 || Lists everyone connected: level, name, state, and where they connect from. | ||
| + | |- | ||
| + | | [[Wizhelp/Wstat|wstat]] || 200 || Shows everything about a unit, a room, a zone or the world. | ||
| + | |- | ||
| + | | [[Wizhelp/Jstat|jstat]] || 200 || wstat as JSON, for tools (work in progress). | ||
| + | |- | ||
| + | | [[Wizhelp/Cstat|cstat]] || 200 || Lists the clans, their masters and how many members each has. | ||
| + | |- | ||
| + | | [[Wizhelp/Corpses|corpses]] || 200 || Lists every player's corpse and where it is. | ||
| + | |- | ||
| + | | [[Wizhelp/Wedit|wedit]] || 200 || Sends a unit's data to the web client (experimental). | ||
| + | |- | ||
| + | | [[Wizhelp/Wiz|wiz]] || 200 || The gods' channel. | ||
| + | |- | ||
| + | | [[Wizhelp/Wizhelp|wizhelp]] || 200 || Help on the gods' commands. | ||
| + | |- | ||
| + | | [[Wizhelp/Noshout|noshout]] || 200 || Stops a player from shouting, for 30 minutes or as long as you say. | ||
| + | |- | ||
| + | | [[Wizhelp/Wizsocials|wizsocials]] || 200 || Lists the god socials (flick, mash and rock, from level 220). | ||
| + | |- | ||
| + | | [[Wizhelp/Title|title]] || 210 || Sets a player's title. | ||
| + | |- | ||
| + | | [[Wizhelp/Competition|competition]] || 220 || Sets up a race for experience, shown on the competition board. | ||
| + | |- | ||
| + | | [[Wizhelp/Wizinvisible|wizinv]] || 230 || Makes you, or a unit, invisible to everyone below a level. | ||
| + | |- | ||
| + | | [[Wizhelp/Goto|goto]] || 230 || Takes you at once to a room, a zone, or someone or something. | ||
| + | |- | ||
| + | | [[Wizhelp/At|at]] || 230 || Does a command somewhere else, and brings you back. | ||
| + | |- | ||
| + | | [[Wizhelp/Echo|echo]] || 230 || Shows your text to everyone in the room, with no name added. | ||
| + | |- | ||
| + | | [[Wizhelp/Message|message]] || 230 || Like echo, for one person anywhere in the game. | ||
| + | |- | ||
| + | | [[Wizhelp/Restore|restore]] || 230 || Restores someone to full health, mana and endurance. | ||
| + | |- | ||
| + | | [[Wizhelp/Makemoney|makemoney]] || 230 || Creates coins in your purse. | ||
| + | |- | ||
| + | | [[Wizhelp/Load|load]] || 230 (a player: 245) || Loads an NPC or object from the zone files, or brings an offline player into the game. | ||
| + | |- | ||
| + | | [[Wizhelp/Purge|purge]] || 230 (a player: 245) || Cleans the room, or destroys one NPC, object or player in it. | ||
| + | |- | ||
| + | | [[Wizhelp/Set|set]] || 230 (a player: 245) || Changes a field of a unit. | ||
| + | |- | ||
| + | | [[Wizhelp/Force|force]] || 230 (a player: 245) || Makes someone carry out a command. | ||
| + | |- | ||
| + | | [[Wizhelp/Switch|switch]] || 230 || Takes over an NPC's body. | ||
| + | |- | ||
| + | | [[Wizhelp/Reset|reset]] || 230 || Resets a zone at once. | ||
| + | |- | ||
| + | | [[Wizhelp/Wpath|wpath]] || 230 || Finds the way to someone or something. | ||
| + | |- | ||
| + | | [[Wizhelp/Boards|boards]] || 230 || Lists the boards in the game. | ||
| + | |- | ||
| + | | [[Wizhelp/Gmmem|gmmem]], [[Wizhelp/Gmzap|gmzap]], [[Wizhelp/Gmyule|gmyule]], [[Wizhelp/Gmtrack|gmtrack]], [[Wizhelp/Gmlure|gmlure]], [[Wizhelp/Gmtreasure|gmtreasure]], [[Wizhelp/Gmquest|gmquest]], [[Wizhelp/Gmroom|gmroom]] || 230 || The game master's tools for running events. | ||
| + | |- | ||
| + | | [[Wizhelp/Noshout|nocomm, notell]] || 240 || Takes away a player's channels, or their tells. | ||
| + | |- | ||
| + | | [[Wizhelp/Petrify|petrify]] || 240 || Turns a player or NPC to stone. | ||
| + | |- | ||
| + | | [[Wizhelp/Freeze|freeze]] || 240 || Freezes or thaws a player. | ||
| + | |- | ||
| + | | [[Wizhelp/Ban|ban]] || 240 || Bans a site, from logging in or from making new characters. | ||
| + | |- | ||
| + | | [[Wizhelp/Broadcast|broadcast]] || 240 || Shows your text to every player in the game. | ||
| + | |- | ||
| + | | [[Wizhelp/Transfer|transfer]] || 245 || Brings someone to you, or sends them somewhere. | ||
| + | |- | ||
| + | | [[Wizhelp/Seize|seize]] || 245 || Takes an item from a player or NPC. | ||
| + | |- | ||
| + | | [[Wizhelp/Snoop|snoop]] || 245 || Shows you everything a player sees. | ||
| + | |- | ||
| + | | [[Wizhelp/Setskill|setskill]] || 245 || Sets someone's skill, spell or weapon. | ||
| + | |- | ||
| + | | [[Wizhelp/Copy|copy]], [[Wizhelp/Zap|zap]] || 245 || Adds a DIL program to a unit, or removes one. | ||
| + | |- | ||
| + | | [[Wizhelp/Cdelete|cdelete]] || 245 || Deletes a clan. | ||
| + | |- | ||
| + | | [[Wizhelp/Reboot|reboot]] || 250 || Reboots the game, now or after a countdown. | ||
| + | |- | ||
| + | | [[Wizhelp/Wizlock|wizlock]] || 250 || Closes the game to players below a level. | ||
| + | |- | ||
| + | | [[Wizhelp/Advance|advance]] || 250 || Sets a player's level. | ||
| + | |- | ||
| + | | [[Wizhelp/Nset|nset]] || 254 || The DIL version of set. | ||
| + | |- | ||
| + | | [[Wizhelp/Plog|plog]] || 255 || Logs every command around a player to a file. | ||
| + | |- | ||
| + | | [[Wizhelp/Wtimewarp|wtimewarp]] || 255 || Runs the game as fast as it can for some seconds of game time. | ||
| + | |- | ||
| + | | [[Wizhelp/Shutdown|shutdown]] || 255 || Stops the game at once. | ||
| + | |- | ||
| + | | [[Wizhelp/Crash|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 <code>execute</code> and <code>file</code> 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. | ||
Latest revision as of 06:13, 15 November 2026
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.