10AD(6)                           User Commands                          0AD(6)
2
3
4

NAME

6       0ad - manual page for 0ad 0.0.26 Zhuangzi
7

SYNOPSIS

9       0ad [options]
10

DESCRIPTION

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
20       The  game  has  been in development by Wildfire Games (WFG), a group of
21       volunteer, hobbyist game developers, since 2001.
22
23       Basic gameplay:
24
25       -autostart=...
26              load a map instead of showing main menu (see below)
27
28       -editor
29              launch the Atlas scenario editor
30
31       -mod=NAME
32              start the game using NAME mod
33
34       -quickstart
35              load faster (disables audio and some system info logging)
36
37
38       Autostart:
39
40       -autostart="TYPEDIR/MAPNAME"
41              enables autostart and sets MAPNAME; TYPEDIR is skirmishes,  sce‐
42              narios, or random
43
44       -autostart-seed=SEED:AI
45              sets randomozation seed value (default 0, use -1 for random)
46
47       -autostart-ai=PLAYER:AI
48              sets the AI for PLAYER (e.g. 2:petra)
49
50       -autostart-aidiff=PLAYER:DIFF
51              sets the DIFFiculty of PLAYER's AI (0: sandbox, 5: very hard)
52
53       -autostart-aiseed=AISEED
54              sets  the  seed used for the AI random generator (default 0, use
55              -1 for random)
56
57       -autostart-civ=PLAYER:CIV
58              sets PLAYER's civilisation to  CIV  (skirmish  and  random  maps
59              only)
60
61       -autostart-team=PLAYER:TEAM
62              sets the team for PLAYER (e.g. 2:2).
63
64       -autostart-ceasefire=NUM
65              sets a ceasefire duration NUM (default 0 minutes)
66
67       -autostart-nonvisual
68              disable any graphics and sounds
69
70       -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
76       -autostart-wonderduration=NUM
77              sets the victory duration NUM for wonder victory condition  (de‐
78              fault 10 minutes)
79
80
81       -autostart-relicduration=NUM
82              sets  the  victory duration NUM for relic victory condition (de‐
83              fault 10 minutes)
84
85       -autostart-reliccount=NUM
86              sets the number of relics for relic victory condition (default 2
87              relics)
88
89       -autostart-disable-replay
90              disable saving of replays
91
92
93       Multiplayer:
94
95       -autostart-playername=NAME
96              sets local player NAME (default 'anonymous')
97
98       -autostart-host
99              sets multiplayer host mode
100
101       -autostart-host-players=NUMBER
102              sets NUMBER of human players for multiplayer games (default 2)
103
104       -autostart-client=IP
105              sets multiplayer client to join host host at given IP address
106
107
108       Random maps only:
109
110       -autostart-size=TILES
111              sets random map size in TILES (default 192)
112
113       -autostart-players=NUMBER
114              sets NUMBER of players on random map (default 2)
115
116
117       RL client:
118
119       -rl-interface
120              Run the RL interface (see source/tools/rlclient)
121
122
123       Configuration:
124
125       -conf=KEY:VALUE
126              set a config value
127
128       -nosound
129              disable audio
130
131       -noUserMod
132              disable loading of the user mod
133
134       -shadows
135              enable shadows
136
137       -vsync enable VSync, i.e. lock FPS to monitor refresh rate
138
139       -xres=N
140              set screen X resolution to 'N'
141
142       -yres=N
143              set screen Y resolution to 'N'
144
145
146       Installing  modes:  PATHS  install mods located at PATHS. For instance:
147       "./pyrogenesis mod1.pyromod mod2.zip"
148
149
150       Advanced / diagnostic:
151
152       -version
153              print the version of the engine and exit
154
155       -dumpSchema
156              creates a file entity.rng in the working  directory,  containing
157              complete entity XML schema, used by various analysis tools
158
159       -entgraph
160              (disabled)
161
162       -listfiles
163              (disabled)
164
165       -profile=NAME
166              (disabled)
167
168       -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
172
173       -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
177       -writableRoot
178              store  runtime game data in root data directory (only use if you
179              have write permissions on that directory)
180
181       -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
186       -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
192       -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
198       -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
203       -hashtest-full=X
204              whether to enable computation of full hashes in replaymode  (de‐
205              fault true).  Can be disabled to improve performance.
206
207       -hashtest-quick=X
208              whether to enable computation of quick hashes in replaymode (de‐
209              fault false).  Can be enabled for debugging purposes.
210
211
212       Archive builder:
213
214       -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
218       -archivebuild-output=PATH
219              system  PATH  to  output of the resulting .zip archive (use with
220              archivebuild)
221
222       -archivebuild-compress
223              enable deflate compression in the .zip (no  zip  compression  by
224              default since it hurts compression of release packages)
225
226

EXAMPLES

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
234       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
238       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
241

REPORTING BUGS

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
247
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.
253
254
255
2560ad 0.0.26 Zhuangzi               Sep 24 2022                           0AD(6)
Impressum