Wizarding 101

Grabbing Power:

The Administrative immortal account is the one that is specified in etc/server.cfg:

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. :)

To set the wizarding level of other character, use the command: Advance admin <char> <level> 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)

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.

(Update command/level chart here later?)

Who's in power

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.

Command Structure

The MUD as distributed has the following commands at the minimum levels below. This can be changed in commands.dat at ../etc/commands.dat. 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. It is recommended that you learn these commands from the bottom up to ease your way into world management....or just crash the MUD once to get it out of your system.

Level 255

• Crash
• Plog
• Shutdown

Level 254

• Execute
• Nset

Level 253

• Advance
• Copy
• Zap

Level 250

• Freeze

Level 240

• Ban
• Broadcast
• Reboot

Level 239

• Force
• Makemoney
• Snoop
• Setskill
• Restore
• Switch

Level 235

• Transfer

Level 230

• Boards
• Load
• Path
• Purge
• Set
• Reset
• Wizinv
• Wizlock

Level 220

• Mash
• Rock
• Flick
• Message
• At

Level 219

• Corpses
• Goto

Level 215

• Wstat

Level 213

• Echo

Level 210

• Wiz

Level 204

• Petrify
• Title

Level 202

• Users

Level 200

• Notell
• Noshout
• Where
• Wizsocials
• Wizhelp
• Eat

Command Help

Notell (200)

Usage:

 notell <player>

Description: Prevents users from being able to use the "tell" command. Primarily used to discipline users who have been abusing the command. 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!" 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.

Noshout (200)

Usage:

 noshout <player>

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>." 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>." Command is unable to target wizards of equal or greater level.

Where (200)

Usage:

 where [unit]

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.

Wizsocials (200)

Usage:

 wizsocials

Description: Returns a list of socials available to wizards. Wizsocials are actually individual wizard commands, and as such can be level restricted.

Wizhelp (200)

Usage:

 wizhelp [topic]

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.

Eat (200)

Usage:

 eat <unit>

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.

Users (202)

Usage:

 users

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.

Petrify (204)

Usage:

 petrify <player/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.

See also:

 wizhelp freeze

Title (204)

Usage:

 title <player> <title>

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.

Note: 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.

Wiz (210)

Usage:

 wiz <text> (standard wiz-line, addresses the wizard-only comm channel)
 wiz #<level> <text> (as above, but only to wiz's of level+)
 wiz @<emotetext> (emote on the wizline)
 wiz @<level> <emotetext>; (as above, but only to wiz's of level+)
 wiz ? (what wizards are on- and offline)
 wiz - (show as offline)
 wiz + (show as online)

Description: Command will address the wizards-only communication channel. See usage for details.

Echo (213)

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 (215)

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 (219)

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 (219)

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 (220)

Usage:

 mash [player]

Description: Uses the wizsocial mash. Optionally target a player.

Flick (220)

Usage:

 flick [player]

Description: Uses the wizsocial flick. Optionally target a player.

Rock (220)

Usage:

 rock [player]

Description: Uses the wizsocial rock. Optionally target a player.

Message (220)

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 (220)

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)

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

Path (230)

Usage: (Note - 9/2020 this command appears broken. will investigate)

 path [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)

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)

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.
<type> : a type. to list possible types give it an 'X' as type
<string> : a single string.(enter description): this gives you the multi-line editor. End with a '@' on a single line.
<unitpath> : a 'path' to the unit, specifying its itemname and zonename.
<keyword> : a single keyword.
<direction> : direction can be any of the six: n s e w u d
<bitlist> : a list of bitnames. nothing indicates no set bits. Separate bitnames with a single '|'.

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 (230)

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 (235)

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 (239)

Usage:

 force <player> <command>

Description: Forces a player to execute a command. Passing "all" will apply the force function to all connected players.

Makemoney (239)

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 (239)

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 (239)

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 (239)

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 (239)

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 (240)

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 (250)

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 (253)

Usage:

 advance <admin/ply> <player> <level>

Description: Advances a player to a specific level. Primarily used to advance wizards through the immortal ranks.

Copy (253)

Usage:

 copy <unit> <string>

Description: copies a DIL function to unit. String is symname of dil program (dil_name@zoneidx).

Zap (253)

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

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:

 plog <player>

Description: Adds a log function to a given player. Useful for debugging, tracking problem players, or catching suspected cheating.