User Tools

Site Tools


dm_commands

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
dm_commands [2022/07/20 01:20]
leaf [free] Sync with source code
dm_commands [2023/08/09 16:52] (current)
leaf [recollect] typo correction
Line 323: Line 323:
   The Dungeon Master has arrived!   The Dungeon Master has arrived!
  
 +==== insert_into ====
 +
 +Usage: insert_into <​item>​ <​item>​
 +
 +This will insert the 2nd item in the first. 2nd can't be a player.
 ==== invisible ==== ==== invisible ====
  
Line 368: Line 373:
 See Also: [[player_commands#​nodm|nodm]] See Also: [[player_commands#​nodm|nodm]]
 ==== learn_spell ==== ==== learn_spell ====
-syntax: learn_spell <spell name> 
  
-notesthis will allow you to permanently learn a spell. It is similiar to learn_special_prayer except that you will retain knowledge of this spell regardless of changing deities. See Also: learn_special_prayer+Usagelearn_spell <spell name>
  
 +This will allow you to permanently learn a spell. <spell name> may be a partial spell name.
 +
 +It is similar to learn_special_prayer except that you will retain the knowledge of this spell regardless of changing deities. ​
 +
 +See Also: learn_special_prayer
 +
 +==== mon_aggr ====
 +
 +Usage: mon_aggr
 +
 +This command requires the possess command to be active. But, possess command was disabled per the server ChangeLog in 801f6142b - (2004-06-06 17:15:12 +0000) Disable possess command - ryo_saeba
 +
 +Toggles the aggression of the monster you are currently possessing. Not recommended to be flipped on yourself as a player.
 +
 +See Also: possess
 +
 +==== nodm ====
 +
 +Usage: nodm
 +
 +This command will return the DM to normal player status.
 +
 +See Also: nowiz
 +
 +==== nowiz ====
 +
 +Usage: nowiz
 +
 +This command will return the DM to normal player status.
 +
 +See Also: nodm
 ==== overlay_save ==== ==== overlay_save ====
 syntax: overlay_save syntax: overlay_save
  
-notes: this will save everything on the current map that was not originally part of it as an overlay. The overlay will then be loaded anytime the map itself is loaded. Be careful with this as EVERYTHING on the map will be saved in an overlay, such as spawned monsters and dropped objects. +This will save everything on the current map that was not originally part of it as an overlay. The overlay will then be loaded anytime the map itself is loaded. Be careful with this as EVERYTHING on the map will be saved in an overlay, such as spawned monsters and dropped objects.
- +
-==== nodm and nowiz ==== +
-syntax: nodm+
  
-notes: both of these commands will return you to normal player status. 
  
 ==== patch ==== ==== patch ====
-syntax: patch <tag> <​variable>​ <​value>​ 
  
-notes: using the patch command, you can radically modify the properties of objects in the game. Simply specify the object to modify and the new values of its variables (or completely new variables). See Also: dump+Using the patch command, you can radically modify the properties of objects in the game. Simply specify the object ​number (obtained through the dump command) ​to modify and the new values of its variables (or completely new variables). 
 + 
 +Usage: patch <tag> <​variable>​ <​value>​ 
 + 
 +Examples: 
 + patch 19875 nrof 10 
 + 
 +This will change the quantity of items referenced by object number 19875 to 10 
 + 
 + patch 49635 dam 200 
 + 
 +This will change the damage of a weapon referenced by object number 49635 to 200 
 + 
 +See Also: dump
  
 ==== plugin ==== ==== plugin ====
-syntax: plugin <plugin name> 
  
-notesthis will load a new plugin into memory. Using this with no arguments, or invalid arguments will cause a server crash. ​Plugin ​name should be as it appears in your plugin directory. Double check the names before using plugins.+Usageplugin <plugin name> 
 + 
 +This will load a new plugin into memory. Using this with no arguments, or invalid arguments will cause a server crash. ​The plugin ​name should be as it appears in your plugin directory. Double-check the names before using plugins. 
 + 
 +See Also: pluglist 
 +See Also: plugout
  
 ==== pluglist ==== ==== pluglist ====
Line 398: Line 445:
  
 ==== plugout ==== ==== plugout ====
-syntax: plugout <plugin name> 
  
-notesthis will remove a loaded ​plugin ​from memory.+Usageplugout <plugin ​name>
  
 +This will remove a loaded plugin from memory.
 +
 +See Also: plugin
 +See Also: pluglist
 ==== possess ==== ==== possess ====
-syntax: possess <monster name> 
  
-notesthis allows a DM to inhabit ​a monster's body, and run around ​the game with it.+Usagepossess <object number>​ 
 + 
 +This feature was disabled per the server ChangeLog in 801f6142b - (2004-06-06 17:15:12 +0000) Disable possess command - ryo_saeba 
 + 
 +Take over the body of given monster and requires ​the object number of the monster which is found by using the dump command. 
 + 
 +Once the monster is possessed, ​it can now be controlled by the DM through their client interface and connection. 
 + 
 +It is not suggested you try to possess another player, as bad things will undoubtably happen. 
 + 
 +See Also: dump 
 +See Also: mon_aggr
  
 ==== printlos ==== ==== printlos ====
Line 411: Line 471:
  
 notes: this is used for line of sight debugging. notes: this is used for line of sight debugging.
 +
 +==== purge_quest_state ====
 +
 +Usage: purge_quest_state
 +
 +This command purges the quest state for the players from the server.
 +
 +It does not remove said state from the disk.
 +
 +It is useful to change, via .quest file editing, the status of a quest for a player.
 +
 +See Also: purge_quests
 +See Also: quest
 +
 +==== purge_quests ====
 +
 +Usage: purge_quests
 +
 +This command purges the quest definitions from the server memory.
 +
 +It does not remove anything from the disk.
 +
 +This is used to avoid restarting the server when a quest definition changes.
 +
 +See Also: purge_quest_state
 +See Also: quest
 +
 +=== quest ====
 +
 +Usage: quest (player name) list|info|set
 +
 +This command shows the quest status for a specified player or information on in-game quests or can change the status of a player'​s quest list.
 +
 +Examples:
 +  * (player name) list: displays quests the player is currently attempting, add '​all'​ to show completed quests also
 +  * (player name) info: displays information about the specified (by number) quest
 +  * (player name) set (quest number) (state): set the state of the specified quest
 +
 +Note: (player name) may be a partial name as long as it isn't ambiguous. The player must be online.
 +
 +See Also: purge_quest_state
 +See Also: purge_quests
 +
 +==== recollect ====
 +syntax: recollect
 +
 +NOTE: Experimental command - use with caution
 +
 +FIXME: the command is currently not documented as a help file in the game
 +
 +The recollect command will cause the server to run the archetype collection process again. An example for using this command is for testing new faces by comparing old faces with new ones without rebooting the server.
 +
 +Check the server logs for output related to this command since there currently is no output to the DM or through the game client in regard to running this command.
 +
 +Example server log output:
 +  Starting to collect assets from /​usr/​games/​crossfire/​share/​crossfire
 +  Finishing collecting assets from /​usr/​games/​crossfire/​share/​crossfire
  
 ==== remove ==== ==== remove ====
 syntax: remove <tag> syntax: remove <tag>
  
-notes: remove ​will, surprisingly enough, remove the object specified by the tag supplied. See Also: free+Remove ​will, surprisingly enough, remove the object specified by the tag supplied. ​ 
 + 
 +See Also: free
  
 ==== reset ==== ==== reset ====
Line 435: Line 554:
     * reset /​pup_land/​guilds/​purple_butterfly/​hallofjoining     * reset /​pup_land/​guilds/​purple_butterfly/​hallofjoining
   * Find the unique map.    In this example, the server is installed in /​usr/​games/​crossfire. ​ The unique map is a file named similarly to the in-game map path:   In this example, the server is installed in /​usr/​games/​crossfire.v00   * Find the unique map.    In this example, the server is installed in /​usr/​games/​crossfire. ​ The unique map is a file named similarly to the in-game map path:   In this example, the server is installed in /​usr/​games/​crossfire.v00
-    * Presumably there are cases where there might be multiple files with different numbered .vXX extension. ​ If there are more than one, make sure to identify the one to reset.+    * Presumablythere are cases where there might be multiple files with different numbered .vXX extension. If there is more than one, make sure to identify the one to reset.
     * For safety, make a backup of the unique map.     * For safety, make a backup of the unique map.
   * Delete the unique map.   * Delete the unique map.
     * rm -f /​usr/​games/​crossfire/​var/​crossfire/​unique-items/​pup_land\@guilds\@purple_butterfly\@hallofjoining.v00     * rm -f /​usr/​games/​crossfire/​var/​crossfire/​unique-items/​pup_land\@guilds\@purple_butterfly\@hallofjoining.v00
-  * One server admin suggests an additional reset of the map from within game, but, at least on one trunk server, this reports "No such map" after the server unique map file was deleted, and therefore, may not be needed.+  * One server admin suggests an additional reset of the map from within ​the game, but, at least on one trunk server, this reports "No such map" after the server'​s ​unique map file was deleted, and therefore, may not be needed.
  
  
 ==== server_speed ==== ==== server_speed ====
-syntax: server_speed <​newspeed>​ 
  
-notesthis command will set the tickrate ​of the server to <​newspeed>​ in microseconds. The default setting is currently 120,000 microseconds (120ms). Use this command with extreme caution as you can easily ​"break" ​the default ​behaviour ​of the server and cause all players to starve to death multiple times, or worse.+Usageserver_speed <​newspeed>​ 
 + 
 +This command will set the tick rate of the server to <​newspeed>​ in microseconds. The default setting is currently 120,000 microseconds (120ms). Use this command with extreme caution as you can easily ​break” the default ​behavior ​of the server and cause all players to starve to death multiple times, or worse
 + 
 +==== set_god ==== 
 + 
 +Usage: set_god <​player>​ <​deity>​ 
 + 
 +This will change a player'​s deity to the deity specified. 
 + 
 +Example: 
 +  set_god Carol Mostrai 
 + 
 +The player named Carol is now a follower of Mostrai. 
 + 
 +==== shutdown ==== 
 + 
 +Usage: shutdown <​now|time|idle|cancel>​ 
 + 
 +Shut down '​now',​ in '​time'​ minutes, when there are no active players ('​idle'​),​ or '​cancel'​ a pending shutdown. 
 + 
 +Active players do not include AFK players and bots. 
 + 
 +When using the time option in-game players will receive a notice or warning about the pending shutdown at the following time intervals (in minutes): 120, 90, 60, 45, 30, 15, 10, 5, 4, 3, 2, 1 
 + 
 +Players logging in during the shutdown time window will also receive a notice of the pending shutdown.
  
 ==== spellreset ==== ==== spellreset ====
Line 457: Line 600:
 notes: this will print out the current hash table to stderr. notes: this will print out the current hash table to stderr.
  
-==== set_god ​==== +==== stats ====
-syntax: set_god <​player>​ <​diety>​+
  
-notesthis will change a players diety to the diety specified.+Usagestats <​player>​
  
-==== shutdown ==== +This displays the named player'​s statistics. 
-syntaxshutdown <​now|time|cancel>​+(Str, Dex, Con, Int, Wis, Pow, Cha, current h.p., current s.p., AC, Damage, EXP, Grace, Food, Maximum health points, Maximum spell points, WC) 
 + 
 +Examplestats Darla 
 + 
 +The command would display all stats for the player Darla.
  
-notes: Shut down '​now',​ in '​time'​ minutes, or '​cancel'​ a pending shutdown. 
  
-When using the time option in-game players will receive a notice or warning about the pending shutdown at the following time intervals (in minutes): 120, 90, 60, 45, 30, 15, 10, 5, 4, 3, 2, 1 
  
-New players logging in during the shutdown time window will also receive a notice of the pending shutdown. 
  
 ==== style_info ==== ==== style_info ====
-syntax: style_info 
  
-notesthis will print out information regarding current styles in use.+Usagestyle_info 
 + 
 +This will print out information regarding current styles in use. The output includes Style maps load, Memory used not including objects, Style objects, and Memory for objects.
  
 ==== summon ==== ==== summon ====
-syntax: summon <​player>​ 
  
-notessummoning a player ​will bring them immediately to your location. See '​teleport'​ for the reverse. See Also: teleport+Usagesummon <player>
  
 +Summoning a player will bring them immediately to your location. See '​teleport'​ for the reverse.
 +
 +Example: summon Gabriel
 +
 +This will cause the player named Gabriel to appear in front of your character - even if it is a private map, such as a personal apartment.
 +
 +There is no '​reverse'​ summoning, except to go to a map yourself and summon the player again.
 +
 +See Also: goto
 +See Also: teleport
 ==== teleport ==== ==== teleport ====
-syntax: teleport <​player>​ 
  
-notesthe '​reverse'​ summoning of a player. See Also: summon+Usageteleport <player>
  
 +Teleport will bring you immediately next to the player'​s location. See '​summon'​ for the reverse.
 +
 +Example: teleport Gabriel
 +
 +This will cause you to appear next to the player named Gabriel - even if it is a private map, such as their personal apartment.
 +
 +See Also: summon
 ==== time ==== ==== time ====
-syntax: time 
  
-notesthis will give additional ​information ​about server performance ​when used as dm.+Usagetime 
 + 
 +The time command ​will display in-game time along with the month, day, and year. 
 + 
 +For DMs, it also displays ​additional ​time statistics ​about server performance ​such as min, avg, and max on ticks in milliseconds for the server session. 
 + 
 +The output also displays ticks longer than 120ms, and time (avg, max, min) on the last 100 ticks.
  
 ==== toggle_shout ==== ==== toggle_shout ====
-syntax: toggle_shout <​player>​ 
  
-Will toggle the no_shout bit for the named player. This will prevent or enable the player to use the shout command.+Usage: toggle_shout <player>
  
-==== wizpass ==== +The toggle_shout command will toggle the no_shout bit for the named player.
-syntax: wizpass+
  
-notes: this will toggle on and off your ability to walk thru walls as dm.+This will prevent or enable the player to use the shout channel for communication. 
 + 
 +Example: 
 + ​toggle_shout Jessica 
 + 
 +If the player named Jessica has access to the shout channel, the command will now disable her access. 
 + 
 +If Jessica had the shout channel disabled by this command, entering the command again will re-enable shout channel access.
  
 ==== who ==== ==== who ====
-syntax: who 
  
-noteswhen used as dmthis will also print out the object tag of players. ​+Usagewho 
 + 
 +The who command will display all players who are currently logged in to the game and show which ones are AFK (if activated by the player), DMs, and bot accounts. The map path of all logged-in players is also shown. 
 + 
 +When used as a DMall of the above information is displayed in addition to the object tag of players ​and their total level. 
 + 
 +==== wizcast ==== 
 + 
 + 
 +This will enable/​disable your ability to cast spells and prayers anywhere as DM.  
 + 
 +Without argument, it toggles between on and off. 
 + 
 +For instance, with the ability set to on - the DM can cast prayers on unholy ground and spells in no_magic areas (i.e., the middle of a shop.) 
 + 
 +==== wizhelp ==== 
 + 
 +The following commands are available to you: 
 +  dmhelp <command name> 
 +  abil <​player>​ <​attribute>​ <​value>​ 
 +  accountpasswd <​account>​ <​password>​ 
 +  addexp <​name>​ <​amount>​ <​skill>​ 
 +  banish <​player>​ 
 +  create [<​number>​] [<​bonus>​] <​archetype>​ [<​variable1>​ <​value1>​] [<​variable2>​ <​value2>​] ... [of <​artifact>​] 
 +  create [<​number>​] [<​archetype>​] of [<​archetype>​] [<​attribute>​] [<​attribute value>​] 
 +  debug or debug <0 - 3> 
 +  dumpabove 
 +  dumpallarchtypes 
 +  dumpallmaps 
 +  dumpallobjects 
 +  dumpbelow 
 +  dumpfriendlyobjects 
 +  follow <​playername>​ 
 +  free <​tag>​ 
 +  freeze [ticks] <​player>​ 
 +  goto <​map_path>​ 
 +  hide 
 +  insert_into <​item>​ <​item>​ 
 +  invisible 
 +  kick <​player>​ 
 +  learn_special_prayer <prayer name> 
 +  learn_spell <spell name> 
 +  mon_aggr 
 +  nodm 
 +  nowiz 
 +  overlay_save 
 +  patch <tag> <​variable>​ <​value>​ 
 +  plugin <plugin name> 
 +  pluglist 
 +  plugout <plugin name> 
 +  possess <object number>​ 
 +  printlos 
 +  purge_quest_state 
 +  purge_quests 
 +  quest (player name) list|info|set 
 +  remove <​tag>​ 
 +  reset <​mapname>​ 
 +  server_speed <​newspeed>​ 
 +  set_god <​player>​ <​deity>​ 
 +  shutdown <​now|time|idle|cancel>​ 
 +  spellreset 
 +  ssdumptable 
 +  stats <​player>​ 
 +  style_info 
 +  summon <​player>​ 
 +  teleport <​player>​ 
 +  time 
 +  toggle_shout <​player>​ 
 +  who 
 +  wizcast [<​on_off>​] 
 +  wizpass 
 + 
 +General notes for DMs: Case sensitivity is important in player and map names. 
 + 
 +==== wizpass ==== 
 + 
 +Usage: wizpass 
 + 
 +This will toggle on and off your ability to walk through walls as DM. 
 + 
 + 
dm_commands.1658298033.txt.gz · Last modified: 2022/07/20 01:20 by leaf