2012-02-18 00:22:45 +01:00
COMMAND LINE OPTIONS
2004-08-29 22:27:05 +02:00
2012-02-18 00:22:45 +01:00
Basic gameplay:
2016-09-24 12:37:21 +02:00
-autostart=... load a map instead of showing main menu (see below)
-editor launch the Atlas scenario editor
-mod=NAME start the game using NAME mod
-quickstart load faster (disables audio and some system info logging)
2012-02-18 00:22:45 +01:00
Autostart:
2014-11-16 20:53:29 +01:00
-autostart="TYPEDIR/MAPNAME" enables autostart and sets MAPNAME; TYPEDIR is skirmishes, scenarios, or random
2023-06-14 08:35:27 +02:00
-autostart-biome=BIOME sets BIOME for a random map
2017-06-08 16:47:55 +02:00
-autostart-seed=SEED sets randomization seed value (default 0, use -1 for random)
2016-09-24 12:37:21 +02:00
-autostart-ai=PLAYER:AI sets the AI for PLAYER (e.g. 2:petra)
2023-05-10 17:34:38 +02:00
-autostart-aidiff=PLAYER:DIFF sets the DIFFiculty of PLAYER's AI (default 3, 0: sandbox, 5: very hard)
2014-11-16 20:53:29 +01:00
-autostart-aiseed=AISEED sets the seed used for the AI random generator (default 0, use -1 for random)
2018-04-04 20:46:36 +02:00
-autostart-player=NUMBER sets the playerID in non-networked games (default 1, use -1 for observer)
2022-03-06 22:12:16 +01:00
-autostart-civ=PLAYER:CIV sets PLAYER's civilisation to CIV (skirmish and random maps only). Use random for a random civ.
2016-05-04 08:51:34 +02:00
-autostart-team=PLAYER:TEAM sets the team for PLAYER (e.g. 2:2).
2018-03-16 01:12:58 +01:00
-autostart-ceasefire=NUM sets a ceasefire duration NUM (default 0 minutes)
2017-05-23 21:26:33 +02:00
-autostart-nonvisual disable any graphics and sounds
2019-03-16 15:20:28 +01:00
-autostart-victory=SCRIPTNAME sets the victory conditions with SCRIPTNAME located in simulation/data/settings/victory_conditions/ (default conquest). When the first given SCRIPTNAME is "endless", no victory conditions will apply.
2018-03-16 00:46:29 +01:00
-autostart-wonderduration=NUM sets the victory duration NUM for wonder victory condition (default 10 minutes)
-autostart-relicduration=NUM sets the victory duration NUM for relic victory condition (default 10 minutes)
-autostart-reliccount=NUM sets the number of relics for relic victory condition (default 2 relics)
2019-07-03 23:36:40 +02:00
-autostart-disable-replay disable saving of replays
2012-02-18 00:22:45 +01:00
Multiplayer:
2014-11-16 20:53:29 +01:00
-autostart-playername=NAME sets local player NAME (default 'anonymous')
2016-09-24 12:37:21 +02:00
-autostart-host sets multiplayer host mode
2014-11-16 20:53:29 +01:00
-autostart-host-players=NUMBER sets NUMBER of human players for multiplayer game (default 2)
-autostart-client=IP sets multiplayer client to join host at given IP address
2014-09-17 03:15:03 +02:00
Random maps only:
2014-11-16 20:53:29 +01:00
-autostart-size=TILES sets random map size in TILES (default 192)
-autostart-players=NUMBER sets NUMBER of players on random map (default 2)
2014-09-17 03:15:03 +02:00
Examples:
1) "Bob" will host a 2 player game on the Arcadia map:
2022-03-06 22:12:16 +01:00
-autostart="scenarios/arcadia" -autostart-host -autostart-host-players=2 -autostart-playername="Bob"
2018-04-04 20:46:36 +02:00
"Alice" joins the match as player 2:
2022-03-06 22:12:16 +01:00
-autostart-client=127.0.0.1 -autostart-playername="Alice"
2018-04-04 20:46:36 +02:00
The players use the developer overlay to control players.
2014-09-17 03:15:03 +02:00
2) Load Alpine Lakes random map with random seed, 2 players (Athens and Britons), and player 2 is PetraBot:
-autostart="random/alpine_lakes" -autostart-seed=-1 -autostart-players=2 -autostart-civ=1:athen -autostart-civ=2:brit -autostart-ai=2:petra
2018-04-04 20:46:36 +02:00
3) Observe the PetraBot on a triggerscript map:
-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
2012-02-18 00:22:45 +01:00
2020-08-01 12:52:59 +02:00
RL client:
-rl-interface Run the RL interface (see source/tools/rlclient)
2012-02-18 00:22:45 +01:00
Configuration:
2016-09-24 12:37:21 +02:00
-conf=KEY:VALUE set a config value
-nosound disable audio
-shadows enable shadows
-vsync enable VSync, i.e. lock FPS to monitor refresh rate
-xres=N set screen X resolution to 'N'
-yres=N set screen Y resolution to 'N'
2011-04-17 22:58:14 +02:00
2018-04-15 03:46:28 +02:00
Installing mods:
PATHS install mods located at PATHS. For instance: "./pyrogenesis mod1.pyromod mod2.zip"
2012-02-18 00:22:45 +01:00
Advanced / diagnostic:
2016-09-24 12:37:21 +02:00
-version print the version of the engine and exit
-dumpSchema creates a file entity.rng in the working directory, containing
complete entity XML schema, used by various analysis tools
-entgraph (disabled)
-listfiles (disabled)
-profile=NAME (disabled)
-replay=PATH non-visual replay of a previous game, used for analysis purposes
PATH is system path to commands.txt containing simulation log
-replay-visual=PATH visual replay of a previous game, used for analysis purposes
PATH is system path to commands.txt containing simulation log
-writableRoot store runtime game data in root data directory
(only use if you have write permissions on that directory)
-ooslog dumps simulation state in binary and ASCII representations each turn,
files created in sim_log within the game's log folder. NOTE: game will
run much slower with this option!
2012-12-04 02:48:05 +01:00
-serializationtest checks simulation state each turn for serialization errors; on test
2016-09-24 12:37:21 +02:00
failure, error is displayed and logs created in oos_log within the
game's log folder. NOTE: game will run much slower with this option!
2016-11-15 14:26:58 +01:00
-rejointest=N simulates a rejoin and checks simulation state each turn for serialization
errors; this is similar to a serialization test but much faster and
less complete. It should be enough for debugging most rejoin OOSes.
2017-09-09 15:16:05 +02:00
-unique-logs adds unix timestamp and process id to the filename of mainlog.html, interestinglog.html
and oos_dump.txt to prevent these files from becoming overwritten by another pyrogenesis process.
2018-05-29 04:14:38 +02:00
-hashtest-full=X whether to enable computation of full hashes in replaymode (default true). Can be disabled to improve performance.
-hashtest-quick=X whether to enable computation of quick hashes in replaymode (default false). Can be enabled for debugging purposes.
2007-09-08 10:07:43 +02:00
2012-02-18 00:22:45 +01:00
Archive builder:
2016-09-24 12:37:21 +02:00
-archivebuild=PATH system PATH of the base directory containing mod data to be archived/precached
specify all mods it depends on with -mod=NAME
-archivebuild-output=PATH system PATH to output of the resulting .zip archive (use with archivebuild)
-archivebuild-compress enable deflate compression in the .zip
(no zip compression by default since it hurts compression of release packages)