Deliantra-Client/pod/dmcommand_help.pod

=encoding utf-8

=head1 Deliantra 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 dm

   dm

Try to become dungeon master.

=head2 dmhide

   dmhide

Same as becoming dm and hiding at the same time. See B<hide>.

=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

Sets the hidden status on the player. Currently, this has very little
effect apart from hiding the player in some informational output, such as
the who listing.

=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 60 seconds.

=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

This 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 back 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 password

   password <playername> [<new password>]

Will set a new password for the player. If no new password
is given a random password will be generated (and printed).

=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 Deliantra server to shut down entirely by first
kicking out all players, saving all maps and finally exiting. Deliantra
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 [<on_off>]

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