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 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> [<x> <y>]

Using this command will instantly move you to the start point of the map
and position specified. If the position is omitted, the map entry point
will be used instead.

=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 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 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, but it will freeze the swerver for multiple seconds.

=head2 possess

   possess <tag>

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.10
Committed:	Thu Jun 21 22:41:25 2007 UTC (17 years ago) by root
Branch:	MAIN
Changes since 1.9:	+6 -32 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.8	=head1 Crossfire TRT Dungeon Master Commands
2	root	1.1
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	root	1.9	B<abil> will permanently change the ability scores of players. Attribute is
11	root	1.1	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	root	1.4	=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	root	1.1	=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 dumpbelow
78
79			dumpbelow
80
81			Will dump the attributes of the top item you are standing over. see also:
82			dump
83
84			=head2 dumpfriendlyobjects
85
86			dumpfriendlyobjects
87
88			This prints out a list of all active friendly objects to stderr.
89
90			=head2 forget_spell
91
92			forget_spell <spell name>
93
94			This will cause you to permanently lose knowledge of a spell.
95
96			=head2 free
97
98			free <tag>
99
100	root	1.9	Removes (if necessary) and destroys the given object.
101	root	1.1
102			=head2 goto
103
104	root	1.10	goto <mapname> [<x> <y>]
105	root	1.1
106			Using this command will instantly move you to the start point of the map
107	root	1.10	and position specified. If the position is omitted, the map entry point
108			will be used instead.
109	root	1.1
110			=head2 hide
111
112			hide
113
114			This hides the DM from being seen by other players. This is done by
115			making the player perpetually invisible. It also results in the player
116			not showing up in the who command, maps comamnd, or being reported as a
117			player on the metaserver.
118
119			Note that the DM can still do things that makes his presence known, eg,
120			shout, other DM actions, etc.
121
122			=head2 insert_into
123
124			insert_into <item> <item>
125
126			This will insert the 2nd item in the first. 2nd can't be a player.
127
128			=head2 invisible
129
130			invisible
131
132			Makes you invisible for a short time.
133
134			=head2 kick
135
136			kick <player>
137
138			This command will kick a player off the server. If used without an
139			argument, it will kick all players off the server with the exception of
140			you.
141
142			=head2 learn_special_prayer
143
144			learn_special_prayer <prayer name>
145
146			this will allow you to permanently learn a spell as a special prayer of
147			your god. see also: learn_spell
148
149			=head2 learn_spell
150
151			learn_spell <spell name>
152
153			This will allow you to permanently learn a spell. <spell name> may be a
154			partial spell name.
155
156			It is similar to learn_special_prayer except that you will retain
157			knowledge of this spell regardless of changing dieties. see also:
158			learn_special_prayer
159
160			=head2 mon_aggr
161
162			mon_aggr
163
164			Toggles the aggression of the monster you are currently possessing. Not
165			reccomended to be flipped on yourself as a player.
166
167			=head2 nodm
168
169			nodm or nowiz
170
171			Both of these commands will return you to normal player status.
172
173			=head2 nowiz
174
175			nodm or nowiz
176
177			Both of these commands will return you to normal player status.
178
179	root	1.7	=head2 observe
180
181			observe <playername>
182
183			Observes the given object (currently players only). This means that the
184			map and stats of the observed object will be displayed instead of ones
185			own map and stats. Using observe without argument will switch bakc to
186			displaying your own map and stats.
187
188	root	1.1	=head2 patch
189
190			patch <tag> <variable> <value>
191
192			Using the patch command, you can radically modify the properties of
193			objects in the game. Simply specify the object to modify and the new
194			values of its variables (or completely new variables). See Also: dump
195
196	root	1.10	=head2 reload
197	root	1.1
198			Will first unload all loaded perl extensions and modules loaded from the
199			extension directory, followed by loading the perl part of the plugin and
200			all extensions found.
201
202			This is done in an as atomic way as possible so it is safe to do at
203	root	1.10	anytime, but it will freeze the swerver for multiple seconds.
204	root	1.1
205			=head2 possess
206
207	root	1.10	possess <tag>
208	root	1.1
209			Take over the body of a given monster. It is not suggested you try to
210			possess another player, as bad things will undoubtably happen. Allows DM
211			to control the monster directly with his client.
212
213			=head2 printlos
214
215			printlos
216
217			This is used for line of sight debugging.
218
219			=head2 remove
220
221			remove <tag>
222
223			C<remove> will, suprisingly enough, remove the object specified by the tag
224			supplied. see also: free
225
226			=head2 reset
227
228	root	1.6	reset
229	root	1.1
230	root	1.6	Temporarily moves off all characters from the current map, then resets it.
231	root	1.9	It works exactly as if the map reached its reset time prematurely.
232	root	1.1
233			=head2 set_god
234
235			set_god <player> <diety>
236
237			This will change a players diety to the diety specified.
238
239			=head2 shutdown
240
241			shutdown
242
243	root	1.9	This will cause a Crossfire TRT server to shut down entirely by first
244			kicking out all players, saving all maps and finally exiting. Crossfire
245			servers will kick out players and might or might not save some players or
246			maps.
247	root	1.1
248			=head2 stats
249
250			stats <player>
251
252			This displays the named players statistics.
253
254			=head2 style_info
255
256			style_info
257
258			This will print out information regarding current styles in use.
259
260			=head2 summon
261
262			summon <player>
263
264	root	1.9	Summoning a player will bring them immediately to your location. There
265	root	1.1	is no 'reverse' summoning, except to go to a map yourself and summon the
266			player again.
267
268			=head2 teleport
269
270			teleport <player>
271
272			C<teleport> will bring you immediately next to the player's location.
273
274			=head2 wizcast
275
276			wizcast [<on_off>]
277
278			This will enable/disable your ability to cast spells and prayers anywhere
279			as dm. Without argument it toggles between on and off.
280
281	root	1.3	=head2 wizlook
282
283			wizlook
284
285			This will temporarily increase your area of sight to the maximum. It will
286			return to normal when lighting conditions change or when you move.
287
288	root	1.1	=head2 wizpass
289
290			wizpass
291
292			This will toggle on and off your ability to walk thru walls as dm.