resources/pod/dmcommand_help.pod

=head1 Crossfire+ Dungeon Master Commands

The following commands are only available to you if you are dungeon
master, that is, a kind of server administrator with special privileges.

=head2 abil

   abil <player> <attribute> <value> 

abil will permanently change the ability scores of players. Attribute is
one of str, dex, con, int, wis, pow, cha. Value may not exceed 30.

=head2 addexp

   addexp <player> <how much> 

The player must have a skill readied. All experience added in this manner
will go directly to the skill readied.

=head2 banish

   banish <player> 

I<Kicks> the named player and adds their current IP address to the banish
file.  This will prevent the named player from logging into the server
(from their current IP). This is an in-game version of the ban function
meant for short term relief of persistant goons and for DMs who do not
have shell access. It is probably a good idea to clear out the banish file
(usually at F</var/crossfire/banish_file>) on a regular basis and delete
or move any entries to the ban_file if desired.

=head2 create

   create <number> <bonus> <archtype> <variable1> <value1> <variable2> <value2> ...  

Creating items is rather dangerous and tends to crash the server when
creating some items.

The number and bonus attributes may be left off, or the bonus itself may
be left off any time.  If a bonus is desired, number must be specified as
well.  Archtype must be specified in all cases. Variable and values may be
left off at any time, but specifiying a variable requires a value also be
specified.

Multipart values such as for an item name must be quoted.

Example:

   create 5 +1 sword name "Spiffy Sword" face chicken.171

This would create 5 +1 longswords named 'Spiffy Sword' that look like
chickens. See also: patch, dump

=head2 debug

   debug <level> 

Without arguments, debug will simply print the current level of
debugging. Valid debugging levels are 0-3 where: llevError = 0, llevInfo =
1, llevDebug = 2, llevMonster = 3

=head2 dump

   dump <tag> 

Using dump, you can see the attributes of any item in the game.  To find
the object number of an item you wish to view, click on it. If this item
is in your inventory, or you are standing over, click on yourself and the
item tags will be displayed. see also: patch

=head2 dumpallarchtypes

   dumpallarchtypes 
 
This prints out a list of all archtypes to stderr.

=head2 dumpallmaps

   dumpallmaps 

This prints out map information for all active maps to stderr.

=head2 dumpallobjects

   dumpallobjects 

This prints out a list of all active objects to stderr.

=head2 dumpbelow

   dumpbelow 

Will dump the attributes of the top item you are standing over. see also:
dump

=head2 dumpfriendlyobjects

   dumpfriendlyobjects

This prints out a list of all active friendly objects to stderr.

=head2 forget_spell

   forget_spell <spell name>

This will cause you to permanently lose knowledge of a spell.

=head2 free

   free <tag> 

C<free> should ONLY be used after remove.  Freeing an object that has
not been removed will cause the game to crash. For most objects, simply
removing them is sufficient and they will eventually be freed.  See Also:
remove

=head2 goto

   goto <mapname> 

Using this command will instantly move you to the start point of the map
specified.

=head2 hide

   hide

This hides the DM from being seen by other players.  This is done by
making the player perpetually invisible.  It also results in the player
not showing up in the who command, maps comamnd, or being reported as a
player on the metaserver.

Note that the DM can still do things that makes his presence known, eg,
shout, other DM actions, etc.

=head2 insert_into

   insert_into <item> <item>

This will insert the 2nd item in the first.  2nd can't be a player.

=head2 invisible

   invisible 

Makes you invisible for a short time.

=head2 kick

   kick <player> 

This command will kick a player off the server. If used without an
argument, it will kick all players off the server with the exception of
you.

=head2 learn_special_prayer

   learn_special_prayer <prayer name>

this will allow you to permanently learn a spell as a special prayer of
your god. see also: learn_spell

=head2 learn_spell

   learn_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
knowledge of this spell regardless of changing dieties. see also:
learn_special_prayer

=head2 mon_aggr

   mon_aggr

Toggles the aggression of the monster you are currently possessing. Not
reccomended to be flipped on yourself as a player.

=head2 nodm

   nodm or nowiz 

Both of these commands will return you to normal player status.

=head2 nowiz

   nodm or nowiz 

Both of these commands will return you to normal player status.

=head2 overlay_save

   overlay_save 

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.

=head2 patch

   patch <tag> <variable> <value> 

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

=head2 perl-reload

Will first unload all loaded perl extensions and modules loaded from the
extension directory, followed by loading the perl part of the plugin and
all extensions found.

This is done in an as atomic way as possible so it is safe to do at
anytime.

=head2 plugin

   plugin <plugin name>

This 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.

=head2 pluglist

   pluglist 

This shows currently loaded plugins.

=head2 plugout

   plugout <plugin name>

This will remove a loaded plugin from memory.

=head2 possess

   possess (nr)

Take over the body of a given monster. It is not suggested you try to
possess another player, as bad things will undoubtably happen. Allows DM
to control the monster directly with his client.

=head2 printlos

   printlos 

This is used for line of sight debugging.

=head2 remove

   remove <tag> 

C<remove> will, suprisingly enough, remove the object specified by the tag
supplied. see also: free

=head2 reset

   reset <mapname> 

All other characters must be off of the map at the time of reset. This
will NOT reset any unique items, such as players apartments, in the case
of unique items being on a map, it will cause them to be saved before the
map is reset.

Using C<reset .> will reset the map that the player is currently on.

=head2 server_speed

   server_speed [newspeed] 

Without arguments, this prints current server speed. If given an argument,
it will set server speed to the new speed.

=head2 set_god

   set_god <player> <diety>

This will change a players diety to the diety specified.

=head2 shutdown

   shutdown 

This will cause a Crossfire+ to shut down entirely by first kicking out
all players, saving all maps and finally exiting. Crossfire servers will
kick out players and might or might not save some players or maps.

=head2 spellreset

   spellreset 

This causes the spell table to be reinitialized.

=head2 ssdumptable

   ssdumptable 

This will print out the current hash table to stderr.

=head2 stats

   stats <player>

This displays the named players statistics.

=head2 style_info

   style_info 

This will print out information regarding current styles in use.

=head2 summon

   summon <player> 

Summoning a player will bring them immediately to your location.  There
is no 'reverse' summoning, except to go to a map yourself and summon the
player again.

=head2 teleport

   teleport <player> 

C<teleport> will bring you immediately next to the player's location.

=head2 toggle_shout

   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.

=head2 wizcast

   wizcast [<on_off>]

This will enable/disable your ability to cast spells and prayers anywhere
as dm. Without argument it toggles between on and off.

=head2 wizpass

   wizpass 

This will toggle on and off your ability to walk thru walls as dm.
Revision:	1.3
Committed:	Sun Aug 13 02:43:23 2006 UTC (17 years, 11 months ago) by root
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.2:	+0 -0 lines
State:	*FILE REMOVED*
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.1	=head1 Crossfire+ Dungeon Master Commands
2
3			The following commands are only available to you if you are dungeon
4			master, that is, a kind of server administrator with special privileges.
5
6			=head2 abil
7
8	root	1.2	abil <player> <attribute> <value>
9	root	1.1
10			abil will permanently change the ability scores of players. Attribute is
11			one of str, dex, con, int, wis, pow, cha. Value may not exceed 30.
12
13			=head2 addexp
14
15	root	1.2	addexp <player> <how much>
16	root	1.1
17			The player must have a skill readied. All experience added in this manner
18			will go directly to the skill readied.
19
20			=head2 banish
21
22	root	1.2	banish <player>
23	root	1.1
24			I<Kicks> the named player and adds their current IP address to the banish
25			file. This will prevent the named player from logging into the server
26			(from their current IP). This is an in-game version of the ban function
27			meant for short term relief of persistant goons and for DMs who do not
28			have shell access. It is probably a good idea to clear out the banish file
29	root	1.2	(usually at F</var/crossfire/banish_file>) on a regular basis and delete
30			or move any entries to the ban_file if desired.
31	root	1.1
32			=head2 create
33
34	root	1.2	create <number> <bonus> <archtype> <variable1> <value1> <variable2> <value2> ...
35	root	1.1
36			Creating items is rather dangerous and tends to crash the server when
37			creating some items.
38
39			The number and bonus attributes may be left off, or the bonus itself may
40			be left off any time. If a bonus is desired, number must be specified as
41			well. Archtype must be specified in all cases. Variable and values may be
42			left off at any time, but specifiying a variable requires a value also be
43			specified.
44
45			Multipart values such as for an item name must be quoted.
46
47			Example:
48
49	root	1.2	create 5 +1 sword name "Spiffy Sword" face chicken.171
50	root	1.1
51			This would create 5 +1 longswords named 'Spiffy Sword' that look like
52			chickens. See also: patch, dump
53
54			=head2 debug
55
56	root	1.2	debug <level>
57	root	1.1
58			Without arguments, debug will simply print the current level of
59			debugging. Valid debugging levels are 0-3 where: llevError = 0, llevInfo =
60			1, llevDebug = 2, llevMonster = 3
61
62			=head2 dump
63
64	root	1.2	dump <tag>
65	root	1.1
66			Using dump, you can see the attributes of any item in the game. To find
67			the object number of an item you wish to view, click on it. If this item
68			is in your inventory, or you are standing over, click on yourself and the
69			item tags will be displayed. see also: patch
70
71			=head2 dumpallarchtypes
72
73	root	1.2	dumpallarchtypes
74	root	1.1
75			This prints out a list of all archtypes to stderr.
76
77			=head2 dumpallmaps
78
79	root	1.2	dumpallmaps
80	root	1.1
81			This prints out map information for all active maps to stderr.
82
83			=head2 dumpallobjects
84
85	root	1.2	dumpallobjects
86	root	1.1
87			This prints out a list of all active objects to stderr.
88
89			=head2 dumpbelow
90
91	root	1.2	dumpbelow
92	root	1.1
93			Will dump the attributes of the top item you are standing over. see also:
94			dump
95
96			=head2 dumpfriendlyobjects
97
98	root	1.2	dumpfriendlyobjects
99	root	1.1
100			This prints out a list of all active friendly objects to stderr.
101
102			=head2 forget_spell
103
104	root	1.2	forget_spell <spell name>
105	root	1.1
106			This will cause you to permanently lose knowledge of a spell.
107
108			=head2 free
109
110	root	1.2	free <tag>
111	root	1.1
112			C<free> should ONLY be used after remove. Freeing an object that has
113			not been removed will cause the game to crash. For most objects, simply
114			removing them is sufficient and they will eventually be freed. See Also:
115			remove
116
117			=head2 goto
118
119	root	1.2	goto <mapname>
120	root	1.1
121			Using this command will instantly move you to the start point of the map
122			specified.
123
124			=head2 hide
125
126	root	1.2	hide
127	root	1.1
128			This hides the DM from being seen by other players. This is done by
129			making the player perpetually invisible. It also results in the player
130			not showing up in the who command, maps comamnd, or being reported as a
131			player on the metaserver.
132
133			Note that the DM can still do things that makes his presence known, eg,
134			shout, other DM actions, etc.
135
136			=head2 insert_into
137
138	root	1.2	insert_into <item> <item>
139	root	1.1
140			This will insert the 2nd item in the first. 2nd can't be a player.
141
142			=head2 invisible
143
144	root	1.2	invisible
145	root	1.1
146			Makes you invisible for a short time.
147
148			=head2 kick
149
150	root	1.2	kick <player>
151	root	1.1
152			This command will kick a player off the server. If used without an
153			argument, it will kick all players off the server with the exception of
154			you.
155
156			=head2 learn_special_prayer
157
158	root	1.2	learn_special_prayer <prayer name>
159	root	1.1
160			this will allow you to permanently learn a spell as a special prayer of
161			your god. see also: learn_spell
162
163			=head2 learn_spell
164
165	root	1.2	learn_spell <spell name>
166	root	1.1
167			This will allow you to permanently learn a spell. <spell name> may be a
168			partial spell name.
169
170			It is similar to learn_special_prayer except that you will retain
171			knowledge of this spell regardless of changing dieties. see also:
172			learn_special_prayer
173
174			=head2 mon_aggr
175
176	root	1.2	mon_aggr
177	root	1.1
178			Toggles the aggression of the monster you are currently possessing. Not
179			reccomended to be flipped on yourself as a player.
180
181			=head2 nodm
182
183	root	1.2	nodm or nowiz
184	root	1.1
185			Both of these commands will return you to normal player status.
186
187			=head2 nowiz
188
189	root	1.2	nodm or nowiz
190	root	1.1
191			Both of these commands will return you to normal player status.
192
193			=head2 overlay_save
194
195	root	1.2	overlay_save
196	root	1.1
197			This will save everything on the current map that was not originally part
198			of it as an overlay. The overlay will then be loaded anytime the map
199			itself is loaded. Be careful with this as EVERYTHING on the map will be
200			saved in an overlay, such as spawned monsters and dropped objects.
201
202			=head2 patch
203
204	root	1.2	patch <tag> <variable> <value>
205	root	1.1
206			Using the patch command, you can radically modify the properties of
207			objects in the game. Simply specify the object to modify and the new
208			values of its variables (or completely new variables). See Also: dump
209
210	root	1.2	=head2 perl-reload
211
212			Will first unload all loaded perl extensions and modules loaded from the
213			extension directory, followed by loading the perl part of the plugin and
214			all extensions found.
215
216			This is done in an as atomic way as possible so it is safe to do at
217			anytime.
218
219	root	1.1	=head2 plugin
220
221	root	1.2	plugin <plugin name>
222	root	1.1
223			This will load a new plugin into memory. Using this with no arguments,
224			or invalid arguments will cause a server crash. Plugin name should be as
225			it appears in your plugin directory. Double check the names before using
226			plugins.
227
228			=head2 pluglist
229
230	root	1.2	pluglist
231	root	1.1
232			This shows currently loaded plugins.
233
234			=head2 plugout
235
236	root	1.2	plugout <plugin name>
237	root	1.1
238			This will remove a loaded plugin from memory.
239
240			=head2 possess
241
242	root	1.2	possess (nr)
243	root	1.1
244			Take over the body of a given monster. It is not suggested you try to
245			possess another player, as bad things will undoubtably happen. Allows DM
246			to control the monster directly with his client.
247
248			=head2 printlos
249
250	root	1.2	printlos
251	root	1.1
252			This is used for line of sight debugging.
253
254			=head2 remove
255
256	root	1.2	remove <tag>
257	root	1.1
258			C<remove> will, suprisingly enough, remove the object specified by the tag
259			supplied. see also: free
260
261			=head2 reset
262
263	root	1.2	reset <mapname>
264	root	1.1
265			All other characters must be off of the map at the time of reset. This
266			will NOT reset any unique items, such as players apartments, in the case
267			of unique items being on a map, it will cause them to be saved before the
268			map is reset.
269
270			Using C<reset .> will reset the map that the player is currently on.
271
272			=head2 server_speed
273
274	root	1.2	server_speed [newspeed]
275	root	1.1
276			Without arguments, this prints current server speed. If given an argument,
277			it will set server speed to the new speed.
278
279			=head2 set_god
280
281	root	1.2	set_god <player> <diety>
282	root	1.1
283			This will change a players diety to the diety specified.
284
285			=head2 shutdown
286
287	root	1.2	shutdown
288	root	1.1
289	root	1.2	This will cause a Crossfire+ to shut down entirely by first kicking out
290			all players, saving all maps and finally exiting. Crossfire servers will
291			kick out players and might or might not save some players or maps.
292	root	1.1
293			=head2 spellreset
294
295	root	1.2	spellreset
296	root	1.1
297			This causes the spell table to be reinitialized.
298
299			=head2 ssdumptable
300
301	root	1.2	ssdumptable
302	root	1.1
303			This will print out the current hash table to stderr.
304
305			=head2 stats
306
307	root	1.2	stats <player>
308	root	1.1
309			This displays the named players statistics.
310
311			=head2 style_info
312
313	root	1.2	style_info
314	root	1.1
315			This will print out information regarding current styles in use.
316
317			=head2 summon
318
319	root	1.2	summon <player>
320	root	1.1
321			Summoning a player will bring them immediately to your location. There
322			is no 'reverse' summoning, except to go to a map yourself and summon the
323			player again.
324
325			=head2 teleport
326
327	root	1.2	teleport <player>
328	root	1.1
329			C<teleport> will bring you immediately next to the player's location.
330
331			=head2 toggle_shout
332
333	root	1.2	toggle_shout <player>
334	root	1.1
335			Will toggle the no_shout bit for the named player. This will prevent or
336			enable the player to use the shout command.
337
338			=head2 wizcast
339
340	root	1.2	wizcast [<on_off>]
341	root	1.1
342			This will enable/disable your ability to cast spells and prayers anywhere
343			as dm. Without argument it toggles between on and off.
344
345			=head2 wizpass
346
347	root	1.2	wizpass
348	root	1.1
349			This will toggle on and off your ability to walk thru walls as dm.