Deliantra-Client/pod/dmcommand_help.pod

=head1 Crossfire TRT 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> 

B<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 arrest

   arrest <player>

Puts the named player into the nearest cell (corresonding to the region he is in).

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

Removes (if necessary) and destroys the given object.

=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 observe

   observe <playername>

Observes the given object (currently players only). This means that the
map and stats of the observed object will be displayed instead of ones
own map and stats. Using observe without argument will switch bakc to
displaying your own map and stats.

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

Temporarily moves off all characters from the current map, then resets it.
It works exactly as if the map reached its reset time prematurely.

=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 TRT server 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 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 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 wizlook

   wizlook

This will temporarily increase your area of sight to the maximum. It will
return to normal when lighting conditions change or when you move.

=head2 wizpass

   wizpass 

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