Difference between revisions of "Wizarding 101"

From DikuMUD Wiki
Jump to navigation Jump to search
(The god command ladder of November 2026 (commands.def, WIZARD_LEVELS.md) replaces the old chart; each command's level corrected; path is wpath now)
(checked against the current code (wiki review 2026-11-15))
 
Line 1: Line 1:
−
== Grabbing Power: ==
+
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 &lt;command&gt;</code>, and on this wiki under [[Manual:Wizhelp Files|Wizhelp Files]].
−
 
−
The Administrative immortal account is the one that is specified in etc/server.cfg:
 
  
−
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~
  
−
You should change this to the name you will register on the MUD to be the Wizard of Wizards, the God of Gods. Once you've saved that and re-run the MUD, you will need to create the character by logging into the MUD. Upon the second login, you'll have administrative power.  It is recommended that you NOT use the overall admin character, but instead create another character for day to day administrative duties.  With great power comes great responsibility, but with great power come grave mistakes. :)
+
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.
  
−
To set the wizarding level of other character, use the command: '''Advance admin <char> <level>'''
+
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:
−
The player you're promoting should be logged in (and you'll need to be able to see them.. use '''go <character>''' to get to the same room if needed)
+
  advance admin &lt;character&gt; &lt;level&gt;
  
−
For ultimate power, you may set the level to 255. You will want to set the Wizarding level lower on later logins to ensure you don't mistakenly fire off the nukes that you'll have with all of that power.
+
<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.
−
 
 
−
See Command Structure below for what each level can do.
 
  
 
=== 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>&lt;br/&gt;</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.
  
−
You'll want everyone to know who is in power - The 'wizlist' command draws from a configuration file in ../etc/strings/wizlist.  Now that Diku is web-based, you'll want newlines to be paragraphs or have HTML breaks, so include markup in the file.
+
== The god levels ==
−
 
 
−
== Command Structure ==
 
−
 
 
 
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.
 
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 <code>minlevel</code> of each command in <code>etc/commands.def</code> (built into <code>etc/commands.dat</code>); the level names are in <code>include/vme.h</code>. The repository's [https://github.com/Seifert69/DikuMUD3/blob/master/WIZARD_LEVELS.md WIZARD_LEVELS.md] has the details.
+
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"
 
{| class="wikitable"
 
! Level !! Rung !! Adds
 
! 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, flick, mash, rock, noshout
+
| '''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)
 
| '''210''' || '''Cosmetics''' || title (another player's title)
 
|-
 
|-
−
| '''220''' GOD_LEVEL || '''Sport and competition''' || competition
+
| '''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, gmtrack, gmlure, gmtreasure, gmquest, gmroom, reset, wpath, boards
+
| '''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
 
| '''240''' MODERATOR_LEVEL || '''Disruptive players''' || nocomm, notell, petrify, freeze, ban (a site), broadcast
Line 41: Line 37:
 
| '''250''' || '''Running the game''' || reboot, wizlock, advance
 
| '''250''' || '''Running the game''' || reboot, wizlock, advance
 
|-
 
|-
−
| '''253-255''' || '''The server''' || nset, execute, delete (another player), plog, crash, wtimewarp, shutdown, and the set fields add-info, del-info, access, profession, lifespan, lights, exp
+
| '''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:
 
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.
+
* '''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.
 
* '''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.
 
* '''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, unless you're one of its creators.
+
* '''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.
 
'''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>etc/commands.def</code> and rebuild. A command whose DIL checks the level itself needs the same change there.
+
'''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.
  
−
Notice the destructive potential the closer you get to the highest level. Besides destroying someone's privacy (plog), crashing the world on purpose is serious business.
+
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 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 levels in Command Help below are the ones now.
+
== The commands ==
 +
One line for each; follow the link for the full help.
  
−
== Command Help ==
+
{| class="wikitable"
−
 
+
! Command !! Level !! What it does
−
'''Notell (240)'''
+
|-
−
 
+
| [[Wizhelp/Where|where]] || 200 || Lists the players and where they are, or finds someone or something.
−
Usage:
+
|-
−
  notell <player>
+
| [[Wizhelp/Users|users]] || 200 || Lists everyone connected: level, name, state, and where they connect from.
−
 
+
|-
−
Description: Prevents users from being able to use the "tell" command. Primarily used to discipline users who have been abusing the command.
+
| [[Wizhelp/Wstat|wstat]] || 200 || Shows everything about a unit, a room, a zone or the world.
−
A wizard successfully deploying this command will receive the message "NOTELLING set."
+
|-
−
A player targeted by this command will receive the message "Your telepathic ability fades away." Further attempts by player to use the "tell" command will result in the message "Your telepathic ability is lost!"
+
| [[Wizhelp/Jstat|jstat]] || 200 || wstat as JSON, for tools (work in progress).
−
Reverse this action by repeating the command. The player will receive the message "You regain your telepathic ability." Wizard will receive the message "NOTELLING removed."
+
|-
−
Command is unable to target wizards of equal or greater level.
+
| [[Wizhelp/Cstat|cstat]] || 200 || Lists the clans, their masters and how many members each has.
−
 
+
|-
−
'''Noshout (200)'''
+
| [[Wizhelp/Corpses|corpses]] || 200 || Lists every player's corpse and where it is.
−
 
+
|-
−
Usage:
+
| [[Wizhelp/Wedit|wedit]] || 200 || Sends a unit's data to the web client (experimental).
−
  noshout <player>
+
|-
−
 
+
| [[Wizhelp/Wiz|wiz]] || 200 || The gods' channel.
−
Description: Prevents users from being able to use the "shout" command.  
+
|-
−
A wizard successfully deploying this command will receive the message "Noshouting set on <playername>."
+
| [[Wizhelp/Wizhelp|wizhelp]] || 200 || Help on the gods' commands.
−
A player targeted by this command will receive the message "You suddenly get a sore throat!" Further attempts by player to use the "shout" command will result in the message "Your telepathic ability is lost!"
+
|-
−
Reverse this action by repeating the command. The player will receive the message "Your sore throat fades away." Wizard will receive the message "Noshouting removed from <player>."
+
| [[Wizhelp/Noshout|noshout]] || 200 || Stops a player from shouting, for 30 minutes or as long as you say.
−
Command is unable to target wizards of equal or greater level.
+
|-
−
 
+
| [[Wizhelp/Wizsocials|wizsocials]] || 200 || Lists the god socials (flick, mash and rock, from level 220).
−
'''Nocomm (240)'''
+
|-
−
 
+
| [[Wizhelp/Title|title]] || 210 || Sets a player's title.
−
Usage:
+
|-
−
  nocomm <player>
+
| [[Wizhelp/Competition|competition]] || 220 || Sets up a race for experience, shown on the competition board.
−
 
+
|-
−
Description: Prevents users from being able to use the communication channels.  
+
| [[Wizhelp/Wizinvisible|wizinv]] || 230 || Makes you, or a unit, invisible to everyone below a level.
−
A wizard successfully deploying this command will receive the message "Noscomm set on <playername>."
+
|-
−
A player targeted by this command will receive the message "You have lost the ability to use communication channels!" Further attempts by player to use the communication channels will result in the message "You have lost the privilege to use communication channels."
+
| [[Wizhelp/Goto|goto]] || 230 || Takes you at once to a room, a zone, or someone or something.
−
Reverse this action by repeating the command. The player will receive the message "You have regained the ability to use communication channels." Wizard will receive the message "Noscomm removed from <player>."
+
|-
−
Command is unable to target wizards of equal or greater level.
+
| [[Wizhelp/At|at]] || 230 || Does a command somewhere else, and brings you back.
−
 
+
|-
−
'''Where (200)'''
+
| [[Wizhelp/Echo|echo]] || 230 || Shows your text to everyone in the room, with no name added.
−
 
+
|-
−
Usage:
+
| [[Wizhelp/Message|message]] || 230 || Like echo, for one person anywhere in the game.
−
  where [unit]
+
|-
−
 
+
| [[Wizhelp/Restore|restore]] || 230 || Restores someone to full health, mana and endurance.
−
Description: Utilized without arguments, this will return a list of players as well as the title and unit-path of their location. With argument, returns title of target, as well as title and unit-path of target's location.
+
|-
−
 
+
| [[Wizhelp/Makemoney|makemoney]] || 230 || Creates coins in your purse.
−
'''Wizsocials (200)'''
+
|-
−
 
+
| [[Wizhelp/Load|load]] || 230 (a player: 245) || Loads an NPC or object from the zone files, or brings an offline player into the game.
−
Usage:
+
|-
−
  wizsocials
+
| [[Wizhelp/Purge|purge]] || 230 (a player: 245) || Cleans the room, or destroys one NPC, object or player in it.
−
 
+
|-
−
Description: Returns a list of socials available to wizards. Wizsocials are actually individual wizard commands, and as such can be level restricted.
+
| [[Wizhelp/Set|set]] || 230 (a player: 245) || Changes a field of a unit.
−
 
+
|-
−
'''Wizhelp (200)'''
+
| [[Wizhelp/Force|force]] || 230 (a player: 245) || Makes someone carry out a command.
−
 
+
|-
−
Usage:
+
| [[Wizhelp/Switch|switch]] || 230 || Takes over an NPC's body.
−
  wizhelp [topic]
+
|-
−
 
+
| [[Wizhelp/Reset|reset]] || 230 || Resets a zone at once.
−
Description: Utilized without arguments, the command will return a list of available wizard commands. Only commands available at the invoking wizard's level will be displayed. Used with argument, will return a help file for available commands. Wizhelp contributed to, but is distinct from this help file, as additional context and color is added here.
+
|-
−
 
+
| [[Wizhelp/Wpath|wpath]] || 230 || Finds the way to someone or something.
−
'''Eat (200; 230 for NPCs and objects, 245 for players)'''
+
|-
−
 
+
| [[Wizhelp/Boards|boards]] || 230 || Lists the boards in the game.
−
Usage:
+
|-
−
  eat <unit>
+
| [[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.
−
 
+
|-
−
Description: Target will be removed from the game. Targeting a player will result in that player being disconnected. Targeting an object or npc will remove that instance.
+
| [[Wizhelp/Noshout|nocomm, notell]] || 240 || Takes away a player's channels, or their tells.
−
 
+
|-
−
'''Users (200)'''
+
| [[Wizhelp/Petrify|petrify]] || 240 || Turns a player or NPC to stone.
−
 
+
|-
−
Usage:
+
| [[Wizhelp/Freeze|freeze]] || 240 || Freezes or thaws a player.
−
  users
+
|-
−
 
+
| [[Wizhelp/Ban|ban]] || 240 || Bans a site, from logging in or from making new characters.
−
Description: Returns a list of users connected to the server, their level, and if available their port and IP address. The command will not return information on wizards who have applied wizinvis at a level higher than that of the wizard invoking the command.
+
|-
−
 
+
| [[Wizhelp/Broadcast|broadcast]] || 240 || Shows your text to every player in the game.
−
'''Petrify (240)'''
+
|-
−
 
+
| [[Wizhelp/Transfer|transfer]] || 245 || Brings someone to you, or sends them somewhere.
−
Usage:
+
|-
−
  petrify <player/npc>
+
| [[Wizhelp/Seize|seize]] || 245 || Takes an item from a player or NPC.
−
 
+
|-
−
Description: Turns target to stone. For players, they are unable to take any actions at all while petrified. For NPC's, they will now become an object in the room that cannot be picked up. Players may be returned to their original fleshy state by repeating the command. Petrifying a NPC is not reversible, though resetting their zone will reload the NPC per default logic.
+
| [[Wizhelp/Snoop|snoop]] || 245 || Shows you everything a player sees.
−
 
+
|-
−
See also:
+
| [[Wizhelp/Setskill|setskill]] || 245 || Sets someone's skill, spell or weapon.
−
  wizhelp freeze
+
|-
−
 
+
| [[Wizhelp/Copy|copy]], [[Wizhelp/Zap|zap]] || 245 || Adds a DIL program to a unit, or removes one.
−
'''Title (210)'''
+
|-
−
 
+
| [[Wizhelp/Cdelete|cdelete]] || 245 || Deletes a clan.
−
Usage:
+
|-
−
  title <player> <title>
+
| [[Wizhelp/Reboot|reboot]] || 250 || Reboots the game, now or after a countdown.
−
 
+
|-
−
Description: Allows a wizard to set player titles. As of current writing, DIKU II colors are supported in the command, but with the transition to DIKU3 and HTML, this will need to be addressed.
+
| [[Wizhelp/Wizlock|wizlock]] || 250 || Closes the game to players below a level.
−
 
+
|-
−
Note:
+
| [[Wizhelp/Advance|advance]] || 250 || Sets a player's level.
−
No other tags should be inserted into titles. The only exception is the automatically assigned tags such as * Guide * etc. No special characters should be allowed in titles, including !@#$%^&*(). Titles should not exceed one line in length, as displayed by the 'who' command or when looking in a room. Vulgar, offensive, or otherwise objectionable titles should not be used.
+
|-
−
 
+
| [[Wizhelp/Nset|nset]] || 254 || The DIL version of set.
−
'''Wiz (200)'''
+
|-
−
 
+
| [[Wizhelp/Plog|plog]] || 255 || Logs every command around a player to a file.
−
Usage:
+
|-
−
  wiz <text> (standard wiz-line, addresses the wizard-only comm channel)
+
| [[Wizhelp/Wtimewarp|wtimewarp]] || 255 || Runs the game as fast as it can for some seconds of game time.
−
  wiz #<level> <text> (as above, but only to wiz's of level+)
+
|-
−
  wiz @<emotetext> (emote on the wizline)
+
| [[Wizhelp/Shutdown|shutdown]] || 255 || Stops the game at once.
−
  wiz @<level> <emotetext>; (as above, but only to wiz's of level+)
+
|-
−
  wiz ? (what wizards are on- and offline)
+
| [[Wizhelp/Crash|crash]] || 255 || Crashes the game on purpose, with a core dump.
−
  wiz - (show as offline)
+
|}
−
  wiz + (show as online)
 
−
 
 
−
Description: Command will address the wizards-only communication channel. See usage for details.
 
−
 
 
−
'''Echo (230)'''
 
−
 
 
−
Usage:
 
−
  echo <string>
 
−
 
 
−
Description: The contents of <string> will simply appear as a message in the room a wizard is in. Fun for socializing, roleplaying, and executing special interactions.
 
−
 
 
−
See also
 
−
  wizhelp message
 
−
  wizhelp broadcast
 
−
 
 
−
'''Wstat (200)'''
 
−
 
 
−
Usage:
 
−
  wstat <unit> [group]
 
−
  wstat room [group]
 
−
  wstat zone [zone name] [mobiles|objects|rooms|reset|error|info]
 
−
  wstat world [zones]
 
−
 
 
−
Where [group] is:
 
−
no argumnet    : The basis unit data
 
−
data          : The specific data for the type of unit
 
−
contents      : list of unit contents
 
−
affect        : list of affect-structures for unit
 
−
descriptor    : descriptor data for player
 
−
func          : special function for unit
 
−
spell          : spells learned by char
 
−
skill          : skills learned by char
 
−
weapon        : weapons mastered by char
 
−
extra          : extra descriptions
 
−
quest          : Quest information (PC's only)
 
−
 
 
−
Examples:
 
−
  wstat world
 
−
  wstat world zones
 
−
  wstat zone
 
−
  wstat zone rooms
 
−
  wstat fido
 
−
  wstat fido dat
 
−
  wstat fido func
 
−
  wstat room aff
 
−
 
 
−
Description: Displays everything about a unit. Because this is a significant amount of information, it can optionally be split up. The optional [group] parameter determines which information will be displayed.
 
−
 
 
−
See also:
 
−
  wizhelp set
 
−
  wizhelp setskill
 
−
 
 
−
'''Corpses (200)'''
 
−
 
 
−
Usage: (Note - 9/2020 this command appears broken. will investigate)
 
−
  corpses
 
−
 
 
−
Description: Will display a list of player corpses in the game world. (Note: 9/2020 - command appears broken.)
 
−
 
 
−
'''Goto (230)'''
 
−
 
 
−
Usage:
 
−
  goto <unit>
 
−
 
 
−
Examples:
 
−
  goto papi
 
−
  goto guard
 
−
  goto water_cup@midgaard
 
−
  goto temple@udgaard
 
−
 
 
−
Description: Allows wizards to travel about the world. Target a player, npc, or object, and instantly travel to it. Targeting a room name will work only when within the zone, unless utilizing the full unit-path.
 
−
 
 
−
'''Mash (200)'''
 
−
 
 
−
Usage:
 
−
  mash [player]
 
−
 
 
−
Description: Uses the wizsocial mash. Optionally target a player.
 
−
 
 
−
'''Flick (200)'''
 
−
 
 
−
Usage:
 
−
  flick [player]
 
−
 
 
−
Description: Uses the wizsocial flick. Optionally target a player.
 
−
 
 
−
'''Rock (200)'''
 
−
 
 
−
Usage:
 
−
  rock [player]
 
−
 
 
−
Description: Uses the wizsocial rock. Optionally target a player.
 
−
 
 
−
'''Message (230)'''
 
−
 
 
−
Usage:
 
−
  message <player> <string>
 
−
 
 
−
Description: Deliver a custom message to a single player. Similar to the echo command, however it is only delivered to the targeted player rather than the entire room.
 
−
 
 
−
See also:
 
−
  wizhelp echo
 
−
  wizhelp broadcast
 
−
 
 
−
'''At (230)'''
 
−
 
 
−
Usage:
 
−
  at <room name/unit path> <command>
 
−
 
 
−
Description: Allows a wizard to execute commands as if they were in another location. Provide the unit-path to where the command should be executed, and the command itself, and it will be so.
 
−
 
 
−
See also:
 
−
  wizhelp goto
 
−
 
 
−
'''Boards (230)'''
 
−
 
 
−
Usage:
 
−
  boards
 
−
 
 
−
Description: Displays name and room title for each board in the game.
 
−
 
 
−
'''Load (230; 245 for a player)'''
 
−
 
 
−
Usage:
 
−
  load <player>
 
−
  load <unit-path>
 
−
 
 
−
Description: Loads players, NPC's, and objects into the game. A player (yes player!) loaded will behave as if link-dead, and if that player were to log in they would connect to the active session. Loading a NPC will instantiate that NPC into the wizards room. Loading an object will instantiate that object into the wizards inventory.
 
−
 
 
−
See also:
 
−
  wizhelp purge
 
−
  wizhelp eat
 
−
 
 
−
'''Wpath (230)'''
 
−
 
 
−
Usage: (Note - 9/2020 this command appears broken. will investigate)
 
−
  wpath [unit-path]
 
−
 
 
−
Description: Shows the shortest path-matrix for the game. With no argument, it gives debug info on compression rates. If you provide a unit-path, it will return which direction is the shortest path to walk to the unit. (Note - 9/2020 this command appears broken. will investigate)
 
−
 
 
−
'''Purge (230; 245 for a player)'''
 
−
 
 
−
Usage:
 
−
  purge [player/object]
 
−
 
 
−
Description: Purges a player or object(s) from the game. With no options defined will simply purge NPC's and movable items from the room. With argument can remove non-movable items and players. Rather violently removes players by terminating their session, even if in the menu system.
 
−
 
 
−
See also:
 
−
  wizhelp load
 
−
  wizhelp at
 
−
  wizhelp eat
 
−
 
 
−
'''Set (230; 245 on a player)'''
 
−
 
 
−
Usage:
 
−
  set <unit> <field> <arguments>
 
−
 
 
−
Description: This is the command you use, if you want to fiddle with individual fields in a unit. There are a LOT of fields to set. The command will list them, if you just give a unit name. However it is essential that you understand the argument types.
 
−
 
 
−
<value>    : a value. beware not to enter a number out of range.<br>
 
−
<type>      : a type. to list possible types give it an 'X' as type<br>
 
−
<string>    : a single string.(enter description): this gives you the multi-line editor. End with a '@' on a single line.<br>
 
−
<unitpath>  : a 'path' to the unit, specifying its itemname and zonename.<br>
 
−
<keyword>  : a single keyword.<br>
 
−
<direction> : direction can be any of the six: n s e w u d<br>
 
−
<bitlist>  : a list of bitnames. nothing indicates no set bits. Separate bitnames with a single '|'.<br>
 
−
 
 
−
Combinations of the above occur.
 
−
 
 
−
See also:
 
−
  wizhelp setskill
 
−
  wizhelp wstat
 
−
 
 
−
'''Reset (230)'''
 
−
 
 
−
Usage:
 
−
  reset
 
−
 
 
−
Description: Resets a zone, loading all objects, dils, and npc's.
 
−
 
 
−
 
 
−
'''Wizinv (230)'''
 
−
 
 
−
Usage:
 
−
  wizinv [level]
 
−
 
 
−
Description: Makes you invisible to all players (and wizards) below a level. With no arguments command will default to level 219. Argument will allow that level to be raised up to the invoking wizard's level.
 
−
 
 
−
 
 
−
'''Wizlock (250)'''
 
−
 
 
−
Usage:
 
−
  wizlock [level]
 
−
 
 
−
Description:  Locks the game to the specified level. With no arguments, the game will be locked by default to players below level 220. Repeating the command will undo the wizlock. Arguments may be added to specify a specific level with which to restrict access. Players below the wizlock level will be booted from the game immediately, and prevented from re-authenticating.
 
−
 
 
−
See also:
 
−
  wizhelp ban
 
−
 
 
−
'''Transfer (245)'''
 
−
 
 
−
Usage:
 
−
  transfer <player/npc>
 
−
 
 
−
Description:  Transfers a player or NPC to the invoking wizard. Passing "all" will transfer all players to the invoking wizard.
 
−
 
 
−
'''Force (230 for NPCs; 245 for players)'''
 
−
 
 
−
Usage:
 
−
  force <player> <command>
 
−
 
 
−
Description: Forces a player to execute a command. Passing "all" will apply the force function to all connected players.
 
−
 
 
−
'''Makemoney (230)'''
 
−
 
 
−
Usage:
 
−
  makemoney <quantity> <type>
 
−
 
 
−
Description: Instantiates into the invoking wizards inventory money of the quantity and type defined by the command. Available types are platinum, gold, silver, copper, and iron.
 
−
 
 
−
'''Snoop (245)'''
 
−
 
 
−
Usage:
 
−
  snoop <player>
 
−
 
 
−
Description: Enables snooping on an active player session. All messages displayed to the target will be displayed to the invoking wizard marked by a '%' in front of each line. Simply type "snoop" without argument to stop snooping.
 
−
 
 
−
'''Setskill (245)'''
 
−
 
 
−
Usage:
 
−
  setskill <player/npc> <skill/spell/weapon> <field> <value>
 
−
 
 
−
Description: Sets the skill of a player or NPC to specified value. Remember that NPC's have only the categories, or spheres, rather than specific spells and skills. Players have a full tree of options. Utilize the underbar character to represent spaces when necessary to identify a field.
 
−
 
 
−
Examples:
 
−
  setskill issa spell heal 100
 
−
  setskill hel weapon category_axe_hammer 140
 
−
 
 
−
'''Restore (230)'''
 
−
 
 
−
Usage:
 
−
  restore <player/npc>
 
−
 
 
−
Description: Restores a player or NPC to full health, mana, and endurance. Also fills hunger and thirst values. When the value 'self' is passed, it will also set all stats for the invoking wizard to 200.
 
−
 
 
−
'''Switch (230)'''
 
−
 
 
−
Usage:
 
−
  switch <npc>
 
−
 
 
−
Description: Gives the invoking wizard the ability to control a NPC. All messages displayed and actions taken until will now be through the eyes of the target. Execute the switch command with no arguments to return to your body.
 
−
 
 
−
'''Ban (240)'''
 
−
 
 
−
Usage:
 
−
  ban <t/n> <site_name> [period]
 
−
  ban d <sitename
 
−
  ban
 
−
 
 
−
Description: With this wiz-command you can exclude a given site or group of sites from accessing the mud. The site_name may contain the wild cards * and ?, allowing sites like b?zier.daimi.*.dk to be banned. The letters t or n indicates whether the ban is a total one (no chars from the site can connect (VERY harsh punishment!)) or a ban for the creation of any new characters from the site. An optional period can be given to allow for temporary bans, and it must consist of a string of the form "2d 3h 4m" indicating 2days 3hours and 4mins ban. Any of these are optional of course. A temporary ban will lift itself when the time is up. Using the d option means you delete a site, if it's present in the list. No options/arguments to the command gives a list of the banned sites.
 
−
 
 
−
'''Broadcast (240)'''
 
−
 
 
−
Usage:
 
−
  broadcast <string>
 
−
 
 
−
Description: Displays a string for all connected characters. Similar to the echo command, but with a reach that spans the entire game rather than just a specific room.
 
−
 
 
−
See also
 
−
  wizhelp echo
 
−
  wizhelp message
 
−
 
 
−
'''Reboot (250)'''
 
−
 
 
−
Usage:
 
−
  reboot
 
−
  reboot now
 
−
  reboot cancel
 
−
  reboot <value> (number of minutes)
 
−
 
 
−
Description: Reboots the server. With no parameters, a reboot is set for one minute, and countdown begins. As indicated, the 'now' parameter will immediately reboot the mud, and the 'cancel' parameter will cancel a pending reboot. Players will not receive any messages if the wait time is greater than 20 minutes.
 
−
 
 
−
See also:
 
−
  wizhelp shutdown
 
−
  wizhelp crash
 
−
 
 
−
'''Freeze (240)'''
 
−
 
 
−
Usage:
 
−
  freeze <player>
 
−
 
 
−
Description: Freezes a player, preventing most actions and communications. Less restrictive than the 'petrify' command, players still have some very limited actions available to them.
 
−
 
 
−
See also:
 
−
  wizhelp petrify
 
−
 
 
−
'''Advance (250)'''
 
−
 
 
−
Usage:
 
−
  advance <admin/ply> <player> <level>
 
−
 
 
−
Description: Advances a player to a specific level. Primarily used to advance wizards through the immortal ranks.
 
−
 
 
−
'''Copy (245)'''
 
−
 
 
−
Usage:
 
−
  copy <unit> <string>
 
−
 
 
−
Description: copies a DIL function to unit. String is symname of dil program (dil_name@zoneidx).
 
−
 
 
−
'''Zap (245)'''
 
−
 
 
−
Usage:
 
−
  zap <unit> <string>
 
−
 
 
−
Description: Removes a running DIL function. String is symname of dil program (dil_name@zoneidx).
 
−
 
 
−
'''Nset (254)'''
 
−
 
 
−
Usage:
 
−
  nset <unit> <field> <arguments>
 
−
 
 
−
Description: Sets name values for units.
 
−
 
 
−
'''Execute (254)'''
 
−
 
 
−
Usage:
 
−
  execute <string>
 
−
 
 
−
Description: Executes a DIL function
 
−
 
 
−
'''Delete (254)'''
 
−
 
 
−
Usage:
 
−
  delete <player>
 
−
 
 
−
Description: Delete a player from the playerfiles.
 
−
 
 
−
'''Crash (255)'''
 
−
 
 
−
Usage:
 
−
  crash the entire game...
 
−
 
 
−
Description: Crashes the mud engine. This is immediate, and ugly. Aborts the VME and generates a core dump.
 
−
 
 
−
See also:
 
−
  wizhelp shutdown
 
−
  wizhelp reboot
 
−
 
 
−
'''Shutdown (255)'''
 
−
 
 
−
Usage:
 
−
  shutdown
 
−
 
 
−
Description: Gracefully, but immediately, shuts down the Mud engine.  
 
−
 
 
−
See also:
 
−
  wizhelp reboot
 
−
  wizhelp crash
 
−
 
 
−
'''Plog (255)'''
 
  
−
Usage:
+
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]]).
−
  plog <player>
 
  
−
Description: Adds a log function to a given player. Useful for debugging, tracking problem players, or catching suspected cheating.
+
== 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.