|
 |
341ea6d |
.TH 0AD "1" "Dec 16 2012" "0ad 0.0.12" "User Commands"
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.SH NAME
|
|
|
93b350a |
0ad \- manual page for 0ad 0.0.12
|
|
|
b8284a1 |
.SH SYNOPSIS
|
|
|
b8284a1 |
.B 0ad
|
|
|
b8284a1 |
[\fIoptions\fR]
|
|
|
b8284a1 |
.SH DESCRIPTION
|
|
|
b8284a1 |
0 A.D. (pronounced "zero ey-dee") is a free, open-source, cross-platform
|
|
|
b8284a1 |
real-time strategy (RTS) game of ancient warfare. In short, it is a
|
|
|
b8284a1 |
historically-based war/economy game that allows players to relive or rewrite
|
|
|
b8284a1 |
the history of Western civilizations, focusing on the years between 500 B.C.
|
|
|
b8284a1 |
and 500 A.D. The project is highly ambitious, involving state-of-the-art 3D
|
|
|
b8284a1 |
graphics, detailed artwork, sound, and a flexible and powerful custom-built
|
|
|
b8284a1 |
game engine.
|
|
|
b8284a1 |
|
|
|
b8284a1 |
The game has been in development by Wildfire Games (WFG), a group of volunteer,
|
|
|
b8284a1 |
hobbyist game developers, since 2001.
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Basic gameplay:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart\fR
|
|
|
b8284a1 |
load a map instead of showing main menu (see below)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-editor\fR
|
|
|
b8284a1 |
launch the Atlas scenario editor
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-mod\fR \fINAME\fR
|
|
|
b8284a1 |
start the game using \fINAME\fR mod
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-quickstart\fR
|
|
|
b8284a1 |
load faster (disables audio and some system info logging)
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Autostart:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart\fR=\fINAME\fR
|
|
|
b8284a1 |
map \fINAME\fR for scenario, or rms name for random map
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-ai\fR=\fIPLAYER\fR:\fIAI\fR
|
|
|
b8284a1 |
adds named \fIAI\fR to the given \fIPLAYER\fR (e.g. 2:testbot)
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Multiplayer:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-playername\fR=\fINAME\fR
|
|
|
b8284a1 |
multiplayer local player \fINAME\fR (default 'anonymous')
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-host\fR
|
|
|
b8284a1 |
multiplayer host mode
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-players\fR=\fINUMBER\fR
|
|
|
b8284a1 |
multiplayer host: \fINUMBER\fR of client players (default 2)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-client\fR
|
|
|
b8284a1 |
multiplayer client mode
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-ip\fR=\fIIP\fR
|
|
|
b8284a1 |
multiplayer client: connect to this host \fIIP\fR
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Random maps only:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-random\fR
|
|
|
b8284a1 |
random map
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-random\fR=\fISEED\fR
|
|
|
b8284a1 |
random map with \fISEED\fR value (default 0, use -1 for random)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-size\fR=\fITILES\fR
|
|
|
b8284a1 |
random map \fISIZE\fR in tiles (default 192)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-autostart-players\fR=\fINUMBER\fI
|
|
|
b8284a1 |
\fINUMBER\fR of players on random map
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Configuration:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-conf\fR:\fIKEY\fR=\fIVALUE\fR
|
|
|
b8284a1 |
set a config value (overrides the contents of system.cfg)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-g\fR=\fIF\fR
|
|
|
b8284a1 |
set the gamma correction to '\fIF\fR' (default 1.0)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-nosound\fR
|
|
|
b8284a1 |
disable audio
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-onlyPublicFiles\fR
|
|
|
b8284a1 |
force game to use only the public (default) mod
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-shadows\fR
|
|
|
b8284a1 |
enable shadows
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-vsync\fR
|
|
|
b8284a1 |
enable VSync, i.e. lock FPS to monitor refresh rate
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-xres\fR=\fIN\fR
|
|
|
b8284a1 |
set screen \fIX\fR resolution to '\fIN\fR'
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-yres\fR=\fIN\fR
|
|
|
b8284a1 |
set screen \fIY\fR resolution to '\fIN\fR'
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Advanced / diagnostic:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-dumpSchema\fR
|
|
|
b8284a1 |
creates a file entity.rng in the working directory, containing
|
|
|
b8284a1 |
complete entity XML schema, used by various analysis tools
|
|
|
b8284a1 |
.TP
|
|
|
93b350a |
\fB\-entgraph\fR
|
|
|
93b350a |
(disabled)
|
|
|
93b350a |
.TP
|
|
|
93b350a |
\fB\-listfiles\fR
|
|
|
93b350a |
(disabled)
|
|
|
93b350a |
.TP
|
|
|
93b350a |
\fB\-profile\fR=\fINAME\fR
|
|
|
93b350a |
(disabled)
|
|
|
93b350a |
.TP
|
|
|
b8284a1 |
\fB\-replay\fR=\fIPATH\fR
|
|
|
b8284a1 |
non-visual replay of a previous game, used for analysis purposes
|
|
|
b8284a1 |
\fIPATH\fR is system path to commands.txt containing simulation log
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-writableRoot\fR
|
|
|
b8284a1 |
store runtime game data in root data directory
|
|
|
b8284a1 |
(only use if you have write permissions on that directory)
|
|
|
93b350a |
.TP
|
|
|
93b350a |
\fB\-ooslog\fR
|
|
|
93b350a |
dumps simulation state in binary and ASCII representations each turn,
|
|
|
341ea6d |
files created in sim_log within the game's log folder. \fBNOTE\fR: game will
|
|
|
93b350a |
run much slower with this option!
|
|
|
93b350a |
.TP
|
|
|
93b350a |
\fB-serializationtest\fR
|
|
|
93b350a |
checks simulation state each turn for serialization errors; on test
|
|
|
93b350a |
failure, error is displayed and logs created in oos_log within the
|
|
|
93b350a |
game's log folder. \fBNOTE\fR: game will run much slower with this option!
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.PP
|
|
|
b8284a1 |
Archive builder:
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-archivebuild\fR=\fIPATH\fR
|
|
|
b8284a1 |
system \fIPATH\fR of the base directory containing mod data to be archived/precached
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-archivebuild-output\fR=\fIPATH\fR
|
|
|
b8284a1 |
system \fIPATH\fR to output of the resulting .zip archive (use with archivebuild)
|
|
|
b8284a1 |
.TP
|
|
|
b8284a1 |
\fB\-archivebuild-compress\fR
|
|
|
b8284a1 |
enable deflate compression in the .zip
|
|
|
b8284a1 |
(no zip compression by default since it hurts compression of release packages)
|
|
|
93b350a |
.TP
|
|
|
93b350a |
\fB-buildarchive\fR
|
|
|
93b350a |
(disabled)
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.SH "REPORTING BUGS"
|
|
|
b8284a1 |
Bugs should be reported on Trac: http://trac.wildfiregames.com/
|
|
|
b8284a1 |
.br
|
|
|
b8284a1 |
On Linux / OS X: If the game detects an error, it should generate crashlog.txt
|
|
|
b8284a1 |
in ~/.config/0ad/logs/ . If it doesn't, it should at least print some
|
|
|
b8284a1 |
information on stdout. Attach crashlog.txt or the other information to the
|
|
|
b8284a1 |
bug report. It might also help to run the game in gdb and copy the output of
|
|
|
b8284a1 |
the "bt full" command, if possible.
|
|
|
b8284a1 |
|
|
|
b8284a1 |
.SH COPYRIGHT
|
|
|
b8284a1 |
0 A.D. is released as open source: you can freely use, copy, modify and
|
|
|
b8284a1 |
distribute the game's source code and data files, as long as you include
|
|
|
b8284a1 |
attribution to Wildfire Games and let anyone freely modify and distribute any
|
|
|
b8284a1 |
of your own modifications to the game's files.
|