factorio-tools

Table of Contents

• Installation
• Tools
  • facmod

Tools to help you manage your Factorio server.

Caution

This project is still in its early days, and development is still ongoing. Until the project version reaches v1, be aware that there may be some breaking changes between releases.

Installation

1. mkdir /opt/factorio

2. Create a factorio group

3. Create a factorio user, whose primary group is factorio, and homedir is /opt/factorio

4. mkdir -p /opt/factorio/.local/bin

Tools

facmod

facmod helps you manage the mods on your Factorio server.

Synopsis

facmod disable [FLAGS] [MOD ...]
facmod install [FLAGS] [MOD ...]
facmod list [FLAGS]
facmod remove [FLAGS] [MOD ...]
facmod search
facmod update [FLAGS]
facmod upgrade [FLAGS] [MOD ...]

Description

Certain operations are performed locally, such as facmod search, to minimize unnecessary traffic to Factorio’s Mod portal API. By keeping operations — like search — "offline" and having them work off of a local cache, it allows facmod to implement extended functionality over what the Mod portal API can, or is willing to, provide.

When a user runs facmod update, facmod will fetch all of the paginated results from https://mods.factorio.com/api/mods, and cache them in a SQLite database.

Subcommands

disable [MOD …​]

Disable one or more mods. Disabling a mod does not uninstall it. NOT IMPLEMENTED

enable [MOD …​]

Enable an installed mod. NOT IMPLEMENTED

install [MOD …​]

Install one or more mods. NOT IMPLEMENTED

list

List installed mods. IN PROGRESS

remove [MOD …​]

Uninstall (remove) one or more mods. NOT IMPLEMENTED

search

Search for mods. The Mod portal API only allows users to filter results based on name matching, supported Factorio versions, and whether or not the mod is deprecated. The searching facility provided by facmod provides additional search features, which are described in Searching for Mods. This command requires the mod cache database to have been initialized. If the local mod cache database has not been initialized, or needs to by updated, the user will be prompted to run facmod update. NOT IMPLEMENTED

update

Updates the mod cache database with the Mod Portal API so you can perform more actions locally. IN PROGRESS

upgrade [MOD …​]

Upgrade all of the currently-installed mods. Specifying one or more MOD arguments limits the process to upgrade only those mods. NOT IMPLEMENTED

Searching for Mods

TODO: Detail all of the ways users can search for mods with facmod search.

Files

$XDG_STATE_HOME/facmod/mod.db

The mod cache database.

$XDG_CACHE_HOME/facmod/mod

Cache directory for downloaded mods.

Examples