server/pod/dmcommand_help.pod

=begin comment

***
*** WARNING: THIS IS A GENERATED FILE - CHANGES WILL BE LOST
*** The source for this file is in CFPlus/pod/dmcommand_help.pod
*** Make any changes there and then run ./copy_doc
***

=end comment

=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 [--unique]

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

If C<--unique> is given, then additionally all unique items are cleared,
completely reseting the map to "factory defaults". Do not do this unless
you understand the implications!

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