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.

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.

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 leaned 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

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

<in progress>