10AD(6) User Commands 0AD(6)
2
6 0ad - manual page for 0ad 0.0.26 Zhuangzi
7
9 0ad [options]
10
12 0 A.D. (pronounced "zero ey-dee") is a free, open-source, cross-plat‐
13 form real-time strategy (RTS) game of ancient warfare. In short, it is
14 a historically-based war/economy game that allows players to relive or
15 rewrite the history of Western civilizations, focusing on the years be‐
16 tween 500 B.C. and 500 A.D. The project is highly ambitious, involving
17 state-of-the-art 3D graphics, detailed artwork, sound, and a flexible
18 and powerful custom-built game engine.
19 The game has been in development by Wildfire Games (WFG), a group of
21 volunteer, hobbyist game developers, since 2001.
22 Basic gameplay:
24 -autostart=...
26 load a map instead of showing main menu (see below)
27 -editor
29 launch the Atlas scenario editor
30 -mod=NAME
32 start the game using NAME mod
33 -quickstart
35 load faster (disables audio and some system info logging)
36 Autostart:
39 -autostart="TYPEDIR/MAPNAME"
41 enables autostart and sets MAPNAME; TYPEDIR is skirmishes, sce‐
42 narios, or random
43 -autostart-seed=SEED:AI
45 sets randomozation seed value (default 0, use -1 for random)
46 -autostart-ai=PLAYER:AI
48 sets the AI for PLAYER (e.g. 2:petra)
49 -autostart-aidiff=PLAYER:DIFF
51 sets the DIFFiculty of PLAYER's AI (0: sandbox, 5: very hard)
52 -autostart-aiseed=AISEED
54 sets the seed used for the AI random generator (default 0, use
55 -1 for random)
56 -autostart-civ=PLAYER:CIV
58 sets PLAYER's civilisation to CIV (skirmish and random maps
59 only)
60 -autostart-team=PLAYER:TEAM
62 sets the team for PLAYER (e.g. 2:2).
63 -autostart-ceasefire=NUM
65 sets a ceasefire duration NUM (default 0 minutes)
66 -autostart-nonvisual
68 disable any graphics and sounds
69 -autostart-victory=SCRIPTNAME
71 sets the victory conditions with SCRIPTNAME located in simula‐
72 tion/data/settings/victory_conditions/ (default conquest). When
73 the first given SCRIPTNAME is "endless", no victory conditions
74 will apply.
75 -autostart-wonderduration=NUM
77 sets the victory duration NUM for wonder victory condition (de‐
78 fault 10 minutes)
79 -autostart-relicduration=NUM
82 sets the victory duration NUM for relic victory condition (de‐
83 fault 10 minutes)
84 -autostart-reliccount=NUM
86 sets the number of relics for relic victory condition (default 2
87 relics)
88 -autostart-disable-replay
90 disable saving of replays
91 Multiplayer:
94 -autostart-playername=NAME
96 sets local player NAME (default 'anonymous')
97 -autostart-host
99 sets multiplayer host mode
100 -autostart-host-players=NUMBER
102 sets NUMBER of human players for multiplayer games (default 2)
103 -autostart-client=IP
105 sets multiplayer client to join host host at given IP address
106 Random maps only:
109 -autostart-size=TILES
111 sets random map size in TILES (default 192)
112 -autostart-players=NUMBER
114 sets NUMBER of players on random map (default 2)
115 RL client:
118 -rl-interface
120 Run the RL interface (see source/tools/rlclient)
121 Configuration:
124 -conf=KEY:VALUE
126 set a config value
127 -nosound
129 disable audio
130 -noUserMod
132 disable loading of the user mod
133 -shadows
135 enable shadows
136 -vsync enable VSync, i.e. lock FPS to monitor refresh rate
138 -xres=N
140 set screen X resolution to 'N'
141 -yres=N
143 set screen Y resolution to 'N'
144 Installing modes: PATHS install mods located at PATHS. For instance:
147 "./pyrogenesis mod1.pyromod mod2.zip"
148 Advanced / diagnostic:
151 -version
153 print the version of the engine and exit
154 -dumpSchema
156 creates a file entity.rng in the working directory, containing
157 complete entity XML schema, used by various analysis tools
158 -entgraph
160 (disabled)
161 -listfiles
163 (disabled)
164 -profile=NAME
166 (disabled)
167 -replay=PATH
169 non-visual replay of a previous game, used for analysis purposes
170 PATH is system path to commands.txt containing simulation log
171 -replay-visual=PATH
174 visual replay of a previous game, used for analysis purposes
175 PATH is system path to commands.txt containing simulation log
176 -writableRoot
178 store runtime game data in root data directory (only use if you
179 have write permissions on that directory)
180 -ooslog
182 dumps simulation state in binary and ASCII representations each
183 turn, files created in sim_log within the game's log folder.
184 NOTE: game will run much slower with this option!
185 -serializationtest
187 checks simulation state each turn for serialization errors; on
188 test failure, error is displayed and logs created in oos_log
189 within the game's log folder. NOTE: game will run much slower
190 with this option!
191 -rejointest=N
193 simulates a rejoin and checks simulation state each turn for se‐
194 rialization errors; this is similar to a serialization test but
195 much faster and less complete. It should be enough for debugging
196 most rejoin OOSes.
197 -unique-logs
199 adds unix timestamp and process id to the filename of main‐
200 log.html, interestinglog.html and oos_dump.txt to prevent these
201 files from becoming overwritten by another pyrogenesis process.
202 -hashtest-full=X
204 whether to enable computation of full hashes in replaymode (de‐
205 fault true). Can be disabled to improve performance.
206 -hashtest-quick=X
208 whether to enable computation of quick hashes in replaymode (de‐
209 fault false). Can be enabled for debugging purposes.
210 Archive builder:
213 -archivebuild=PATH
215 system PATH of the base directory containing mod data to be
216 archived/precached specify all mods it depends on with -mod=NAME
217 -archivebuild-output=PATH
219 system PATH to output of the resulting .zip archive (use with
220 archivebuild)
221 -archivebuild-compress
223 enable deflate compression in the .zip (no zip compression by
224 default since it hurts compression of release packages)
225
228 1) "Bob" will host a 2 player game on the Arcadia map:
229 -autostart="scenarios/Arcadia 02" -autostart-host -autostart-host-players=2 -autostart-playername="Bob"
230 "Alice" joins the match as player 2:
231 -autostart="scenarios/Arcadia" -autostart-client=127.0.0.1 -autostart-playername="Alice"
232 The players use the developer overlay to control players.
233 2) Load Alpine Lakes random map with random seed, 2 players (Athens
235 and Britons), and player 2 is PetraBot:
236 -autostart="random/alpine_lakes" -autostart-seed=-1 -autostart-players=2 -autostart-civ=1:athen -autostart-civ=2:brit -autostart-ai=2:petra
237 3) Observe the PetraBot on a triggerscript map:
239 -autostart="random/jebel_barkal" -autostart-seed=-1 -autostart-players=2 -autostart-civ=1:athen -autostart-civ=2:brit -autostart-ai=1:petra -autostart-ai=2:petra -autostart-player=-1
240
243 Bugs should be reported on Trac. For information on reporting problems
244 and finding logs, see http://trac.wildfiregames.com/wiki/ReportingEr‐
245 rors
246
249 0 A.D. is released as open source: you can freely use, copy, modify and
250 distribute the game's source code and data files, as long as you in‐
251 clude attribution to Wildfire Games and let anyone freely modify and
252 distribute any of your own modifications to the game's files.
2530ad 0.0.26 Zhuangzi Sep 24 2022 0AD(6)