catan - Linux


catan is a command-line tool that facilitates the exploration and analysis of Catan board game scenarios. It provides a structured environment to evaluate game states, perform simulations, and generate statistical insights. Catan enthusiasts and board game analysts can leverage this tool to enhance their gameplay and optimize their strategies.


catan [OPTIONS] <subcommand> [ARGS]


  • -h, –help: Display the help message and exit.
  • -v, –version: Print the version information and exit.
  • -f, –file : Specify the path to the Catan game state file.
  • -l, –log: Enable logging to a file.
  • -j, –json: Output the results in JSON format.


  • init: Initialize a new Catan game state.
  • roll: Simulate dice rolls and update the game state.
  • build: Build a settlement, city, road, or development card.
  • trade: Trade between players.
  • stats: Generate statistics about the current game state.
  • sim: Run a series of simulations to evaluate different strategies.


Create a new game state:

catan init my_game.csv

Simulate a series of dice rolls:

catan roll --file my_game.csv --count 100

Build a settlement:

catan build --file my_game.csv --player 1 --type settlement --location 5,6

Generate statistics about the current game state:

catan stats --file my_game.csv

Run a simulation:

catan sim --file my_game.csv --strategy random --iterations 1000

Common Issues

  • Incorrect file format: Ensure the provided game state file is in the correct CSV format.
  • Invalid dice roll: The dice roll should be a comma-separated string of two numbers between 1 and 6.
  • Invalid build: Verify that the specified build location is valid and соответствует the player’s resources.


catan can be integrated with other Linux commands to automate tasks. For instance, you can use the output of the stats subcommand as input to a data analysis script.

Related Commands

  • csvstat: Generate statistics from CSV files.
  • ggplot: Create visualizations from data.
  • Catan Universe: Official website of Catan.