wraitii
87a2c3347f
This is the same commit as4bb31f084e, reverted in5d1899785a. Noted issues were fixed. Partial revert/fix of2f19cf86d3and2567fee329. Before this diff, it was possible for a mod containing a cache/ or a config/ folder to get written to incorrectly. The issue is VFS can map multiple directories to one 'virtual' path, for reading mods. However, writing data is problematic: which path to choose? The only viable solution is to use a path relative to the highest priority directory encountered in the VFS path, or write paths could be 'hijacked' by lower-priority mods. This fixes these issues by: - Adding a new lookup mode ('Real-path') that explicitly picks the real path relative to the highest-priority subdirectory in the VFS Path. - Preventing overwriting a real directory with a lower priority one in general. - Revert c0c8132dd4's GetRealPath change, re-introducing the function as GetOriginalPath. This also cleans up some duplication that led to empty mod folders in the user mod path, and cleans up loading the 'user' mod. It also makes it explicit that a directory must be passed to Mount(). Note that the new 'realpath' lookup can still be somewhat complex with many mount points at various hierarchy levels, but it is at least predictable/deterministic without having to be careful about populating order. Fixes #2553 Differential Revision: https://code.wildfiregames.com/D3728 This was SVN commit r25107.
92 lines
6.1 KiB
Plaintext
92 lines
6.1 KiB
Plaintext
COMMAND LINE OPTIONS
|
|
|
|
Basic gameplay:
|
|
-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)
|
|
|
|
Autostart:
|
|
-autostart="TYPEDIR/MAPNAME" enables autostart and sets MAPNAME; TYPEDIR is skirmishes, scenarios, or random
|
|
-autostart-seed=SEED sets randomization seed value (default 0, use -1 for random)
|
|
-autostart-ai=PLAYER:AI sets the AI for PLAYER (e.g. 2:petra)
|
|
-autostart-aidiff=PLAYER:DIFF sets the DIFFiculty of PLAYER's AI (0: sandbox, 5: very hard)
|
|
-autostart-aiseed=AISEED sets the seed used for the AI random generator (default 0, use -1 for random)
|
|
-autostart-player=NUMBER sets the playerID in non-networked games (default 1, use -1 for observer)
|
|
-autostart-civ=PLAYER:CIV sets PLAYER's civilisation to CIV (skirmish and random maps only)
|
|
-autostart-team=PLAYER:TEAM sets the team for PLAYER (e.g. 2:2).
|
|
-autostart-ceasefire=NUM sets a ceasefire duration NUM (default 0 minutes)
|
|
-autostart-nonvisual disable any graphics and sounds
|
|
-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.
|
|
-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)
|
|
-autostart-disable-replay disable saving of replays
|
|
Multiplayer:
|
|
-autostart-playername=NAME sets local player NAME (default 'anonymous')
|
|
-autostart-host sets multiplayer host mode
|
|
-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
|
|
Random maps only:
|
|
-autostart-size=TILES sets random map size in TILES (default 192)
|
|
-autostart-players=NUMBER sets NUMBER of players on random map (default 2)
|
|
|
|
Examples:
|
|
1) "Bob" will host a 2 player game on the Arcadia map:
|
|
-autostart="scenarios/Arcadia" -autostart-host -autostart-host-players=2 -autostart-playername="Bob"
|
|
"Alice" joins the match as player 2:
|
|
-autostart="scenarios/Arcadia" -autostart-client=127.0.0.1 -autostart-playername="Alice"
|
|
The players use the developer overlay to control players.
|
|
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
|
|
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
|
|
|
|
RL client:
|
|
-rl-interface Run the RL interface (see source/tools/rlclient)
|
|
|
|
Configuration:
|
|
-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'
|
|
|
|
Installing mods:
|
|
PATHS install mods located at PATHS. For instance: "./pyrogenesis mod1.pyromod mod2.zip"
|
|
|
|
Advanced / diagnostic:
|
|
-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!
|
|
-serializationtest checks simulation state each turn for serialization errors; on test
|
|
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!
|
|
-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.
|
|
-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.
|
|
-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.
|
|
|
|
Archive builder:
|
|
-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)
|