1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
The crawl arena is a special mode during which the player is absent and
monsters fight each other, useful for both testing/debugging and for
entertainment. It can be invoked on the command line like this:
crawl -arena "kobold v goblin"
Which will cause one kobold to fight one goblin, with crawl shutting down once
one of them has won. To be considered valid, a monster's name has to fully
match its definition, e.g. "Blork the orc" rather than simply "Blork".
To make them fight for three rounds you can do:
crawl -arena "t:3 kobold v goblin"
You can make monsters fight for at most 99 rounds. You can stop the
arena simulation early by pressing Escape, 'q' or Control-G (though if
the arena has lots of monsters it might take a few second before it
stops).
You can also give each side more than one monster. For example:
crawl -arena "rat, giant cockroach v kobold, goblin"
will give team A a rat and a cockroach and team B a kobold and a goblin; a
victory is declared when all of one team is dead and at lest one member of the
other team is still alive.
Some monsters have a band (that is, a group of monsters) that will be
generated with them during normal play. You can use the suffix "band" to
make a monster appear with its band (if one exists). For example:
crawl -arena "Margery band v Saint Roka band"
You can also make multiple of a single type of monster (note that the singular
form of the names are still used):
crawl -arena "2 kobold v 3 goblin:
crawl -arena "2 rat, 3 giant cockroach v 4 kobold, 5 goblin"
You can even have multiple instances of uniques:
crawl -arena "10 Murray v 11 Boris"
Additionally, you can specify the monsters by a place in the dungeon, in
which case a random monster appropriate for that place will be chosen.
For example:
crawl -arena "2 place:Lair:7 v 3 place:Vaults:4"
will choose two random monsters from the 7th level of the Lair and pit them
against three random monsters from the 4th level of the Vaults.
The branches need to use the official abbreviations also used e.g. in the
overmap (Ctrl-O): D, Temple, Orc, Elf, Lair, Swamp, Shoals, Slime, Snake,
Vaults, Depths, Crypt, Tomb, Hell, Dis, Geh, Coc, Tar, Zot.
To let the game pick monsters completely at random, use "random" as a
monster name. If you use the tag random_uniques all monsters thus chosen
will be uniques. For example:
crawl -arena "random_uniques random v random"
If you want endless hordes of monsters to kill each other forever you can
use the test spawner, an unkillable monster which does nothing but sit there
and summon monsters with the Shadow Creatures spell:
crawl -arena "test spawner v test spawner"
If you want a *specific* set of monsters to fight each other endlessly,
you can use the "respawn" tag, which will cause the initially placed
monsters to be replaced when they die. For example,
crawl -arena "respawn rat v rat"
will make it so that when one rat dies another takes it's place,
resulting in an endless fight between two rats.
Commands
------------------------------------------------------------------------------
There are a very limited number of command you can issue to the arena:
* You can stop the arena simulation early by pressing Escape, 'q' or
Control-G.
* You can look at the message history like in a normal game (Control-P).
* You can look around the arena like in a normal game ('x').
* You can suspend the arena like in a normal game (Control-Z).
If the arena has lots of monsters it might take a few seconds before it
responds.
Options and parameters
------------------------------------------------------------------------------
There are four arena parameters that you can set in your crawl options file:
* arena_delay: The delay in milliseconds between turns within the arena.
Can be set to 0 to make the simulation zip along. Defaults to 600.
* arena_dump_msgs: If set to true causes messages to be dumped to the file
arena.result. Defaults to false.
* arena_dump_msgs_all: If both this and arena_dump_msgs are set to true
then diagnostic messages will be dumped as well as other messages.
Defaults to false.
* arena_list_eq: Dump to the file arena.result the equipment of the
monsters placed at the beginning of each round.
The are also a number a parameters you can use by putting them in the
string which specifies the monsters:
crawl -arena "parameter1 parameter2 parameter3 goblin v kobold"
The parameters include:
* "arena:name" lets you pick the name of the arena to place the monsters
in (defaults to "arena:default"). See source/dat/des/builder/arena.des
for a list.
* names: Causes all non-unique monsters to be given random names.
* no_animate: Prevents corpses from being animated into zombies.
* no_summons: Prevents monsters from summoning more monsters.
* no_chain_summons: Allows the original monsters to summon more monsters,
but the *summoned* monsters can't themselves summon any more.
* no_immobile: Prevents immobile monsters from being randomly generated.
* allow_zero_xp: Allows zero xp monsters like plants to be randomly generated,
which are forbidden from the arena by default.
* "arena_place:place" sets the place used when determining which monsters the
spell Shadow Creatures uses. So "arena:Lair:5" would make it
summon the types of monsters you'd find on the 5th lair of the Lair.
It also controls what type of monster "random" places, assuming
that "random_uniques" isn't used.
(This defaults to the 1st level of the Depths).
* real_summons: Summoned monsters are made real as soon as they're placed in
the arena, so they can drop corpses and equipment (no_chain_summons
still prevents them from summoning more monsters, though).
* move_summons: Moves summoned monsters to a new, random location as soon
as they're placed, so they don't end up clustered around the
summoner.
* "summon_throttle:N" prevents summoned monsters from being placed if the
summoner has N or more allies present.
* cycle_random: If any monster summons monsters with the spell Shadow
Creatures spell (including test spawners) then arena cycles through
the list of valid monsters, rather than taking rarity into account.
* random_uniques: If the team is made up of random monsters
(e.g. "random v random") the chosen monsters will be uniques. Also,
any monster using Shadow Creatures will summon uniques.
* "ban_glyphs:ABC" prevents monsters with the listed ASCII glyphs from
being placed in the arena. For instance, "ban_glyphs:&C" prevents
demon lords and giants/cyclopses/titans/etc from being placed.
* "delay:N" allows the delay between turns to be specified on the command
line instead of in the options file.
* miscasts: Every turn each monster (besides test spawners) will have a
random miscast happen to it.
* respawn: When one of the originally replaced monsters is killed it will
be replaced by the same type of monster. This allows for an endless
fight between exactly specified factions, rather than the random
kind you get by pitting two test spawners against each other.
* move_respawns: Moves respawned monsters to a new, random location as
soon as they're placed, to avoid monsters clumping up in a massive
brawl at the center of the arena.
|
