⚙️ Factorix

A Ruby gem providing a CLI for Factorio MOD management, settings synchronization, and game control.

Factorix simplifies Factorio MOD management by providing:

• A CLI tool for everyday MOD operations
• Automatic dependency resolution and validation
• JSON-based MOD settings export/import
• Save file synchronization capabilities

• MOD Discovery & Download: Search and download MODs from the Factorio MOD Portal
• Dependency Management: Automatic dependency resolution and validation with graph-based analysis
• MOD State Management: Enable/disable MODs with automatic handling of dependencies and dependents
• Installation & Uninstallation: Install MODs directly from the portal or uninstall existing MODs
• Save File Sync: Synchronize MOD states and startup settings from Factorio save files
• Settings Management: Export/import MOD settings in JSON format
• MOD Portal Integration: Upload new MODs or update existing ones, edit metadata
• Game Control: Launch Factorio from the command line
• Cross-platform Support: Works on Windows, Linux, macOS, and WSL

• Ruby (non-EOL versions)
• Factorio API Key (required for uploading MODs and editing MOD metadata)
  • Obtain your API key from Factorio Profile

For uploading MODs or editing MOD metadata, set the FACTORIO_API_KEY environment variable:

export FACTORIO_API_KEY=your_api_key_here

API key is not required for downloading, installing, or managing local MODs.

Factorix auto-detects Factorio installation paths for Steam installations. For other environments or to override the detected paths, create a configuration file.

Find configuration file location:

factorix path --json | jq -r .factorix_config_path

Create configuration file:

# Copy example configuration
cp example/config.rb ~/.config/factorix/config.rb

# Edit the configuration
$EDITOR ~/.config/factorix/config.rb

Configurable paths:

• executable_path - Path to Factorio executable
• user_dir - Path to Factorio user directory (MODs, saves, settings)
• data_dir - Path to Factorio data directory

Example configuration:

Factorix::Application.configure do |config|
  config.runtime.executable_path = "/Applications/Factorio.app/Contents/MacOS/factorio"
  config.runtime.user_dir = "#{Dir.home}/Library/Application Support/factorio"
  config.runtime.data_dir = "/Applications/Factorio.app/Contents/data"
end

See example/config.rb for platform-specific examples and additional configuration options.

Alternative configuration path:

You can specify a custom configuration file path using the --config-path option or FACTORIX_CONFIG environment variable:

# Using CLI option
factorix mod list --config-path=/path/to/config.rb

# Using environment variable
export FACTORIX_CONFIG=/path/to/config.rb
factorix mod list

Run factorix --help to see available commands, or factorix <command> --help for command-specific usage and examples.

For detailed CLI documentation, run factorix man or see doc/components/cli.md.

Bug reports and pull requests are welcome on GitHub at https://github.com/sakuro/factorix.

For development setup and detailed contribution guidelines, please see DEVELOPMENT.md.

The gem is available as open source under the terms of the MIT License.

Copyright (c) 2025 OZAWA Sakuro