factorio-cli

Factorio CLI

A small utility to manipulate data related to Factorio.

The main feature at this point is to export prototype definitions from Factorio using factorio-exporter.

See crate page on crates.io

Example invocation

$ fct --factorio-dir ~/factorio export -f json | jq '.recipe["iron-plate"]'
{
  "type": "recipe",
  "name": "iron-plate",
  "category": "smelting",
  "energy_required": 3.2,
  "ingredients": [
    [
      "iron-ore",
      1
    ]
  ],
  "result": "iron-plate"
}

Command line

$ fct help
A collection of tools for Factorio (<http://www.factorio.com>)

Usage: fct [OPTIONS] <COMMAND>

Commands:
  export        Exports prototypes from Factorio in JSON or YAML format
  resolve-mods  Lists all dependencies of a set of mods, trying to find compatible versions
  download-mod  Download a mod from the mod portal
  login         Log in to the mod portal API and store the obtained login token
  help          Print this message or the help of the given subcommand(s)

Options:
      --factorio-dir <FACTORIO_DIR>
          Directory where Factorio is installed. This needs to be the full version. Neither the demo nor the headless version are sufficient. This argument is optional if `--factorio-binary` is specified
      --factorio-binary <FACTORIO_BINARY>
          Location of the factorio binary. Defaults to `<FACTORIO_DIR>/bin/x64/factorio(.exe)`. This can be any Factorio binary (full, headless, demo)
  -h, --help
          Print help
  -V, --version
          Print version

$ fct help export
Exports prototypes from Factorio in JSON or YAML format

Usage: fct export [OPTIONS] [MODS]...

Arguments:
  [MODS]...  Mods to install before exporting the prototypes

Options:
  -d, --destination <DESTINATION>  Path where the result should be written. Uses STDOUT if not specified
  -f, --format <FORMAT>            Format of the output [default: json] [possible values: json, yaml]
  -h, --help                       Print help

$ fct help resolve-mods
Lists all dependencies of a set of mods, trying to find compatible versions

Usage: fct resolve-mods [MODS]...

Arguments:
  [MODS]...  A list of mods, optionally with version requirements

Options:
  -h, --help  Print help

Status

This is still very much in the prototype phase. The output will be incomplete and have bugs. Please try it out anyway and report any issues that you run into!

See the change log for progress.

Platform support

This tool is intended to be platform-independent, but it's currently only tested on Linux.

Contributing

Contributions are welcome! Feel free to send pull requests, but if you want to make large-scale changes it would make sense to discuss them first.