Skip to content

Command line ​

OpenAoK starts at its main menu. From the command line it can also start straight into a game, a scenario, a saved game or a network game, with the lobby's settings given as options. On a desktop run it from build/:

sh
cd build
./OpenAoK --game --map Arabia --size small --difficulty hard

A game ​

Option
--gameStraight into a random map game against the computer
--map NAMEThe map: a random map script by name (Arabia, Archipelago, Baltic, BlackForest, Coastal, Continental, CraterLake, Fortress, GoldRush, Highland, Islands, Mediterranean, Migration, Nomad, Rivers, TeamIslands)
--size Stiny, small, medium, normal, large or giant
--seed NThe map's seed: the same seed makes the same map
--seats NAn offline game of this many seats, the computer in the rest
--difficulty Dhardest, hard, moderate, easy or easiest
--resources Rstandard, low, medium or high starting resources
--age Adark, feudal, castle or imperial starting age
--reveal Vnormal, explored or all
--population NThe population limit: the largest of the lobby's choices (25 to 1000) not over N
--regicide, --deathmatchA Regicide game, or a Death Match
--cheatsAllow cheats
--ai-onlyThe computer plays every seat, yours too: to watch
--no-aiNobody plays the other seats

Scenarios, saves and recordings ​

Option
--scenario FILEPlays a scenario
--load FILELoads a saved game
--recordRecords the game, as the lobby's Record Game does
--play FILEPlays a recorded game back
--editor [FILE]Opens the scenario editor, with a scenario if one is named

Network games ​

Option
--host PORT --players NOpens a network game on this port, this machine at seat 1, started once N people are in
--join HOST:PORTJoins the network game at that address; the seat and the game come from the host

These skip the lobby; the Multiplayer menu is described in Multiplayer.

The window ​

Option
--windowed, --fullscreenIn a window, or full screen
--widescreenThe frame as wide as the screen
--resolution 800x600, 1024x768, 1280x1024The screen size the frame is laid out at
--zoom ZThe first frame at this zoom
--muteNo sound device at all
--vsync, --no-vsyncWait for the display's refresh, or not
--fpsThe frame rate under the top bar

For testing ​

Options like --screenshot PATH --frames N (render that many frames, write the image and exit), --select NAME, --spawn NAME, --place NAME, --look X Y, --advance SECONDS and --verify TICKS exist to test the engine; they are described in Building from source and Self-checks.

Released under the MIT license. Not affiliated with, endorsed by or sponsored by Microsoft.