A command-line tool for managing Fallout Collaboration Project RimWorld mods. Features both interactive and automated workflows for discovering, updating, installing, and managing FCP mods.

Features

Auto-discover RimWorld installation across Steam, GOG, and Lutris on Windows, Linux, and macOS
Interactive mode with rich terminal UI for browsing, updating, and managing mods
Batch update mode for automation scripts
Install new mods directly from the FCP GitHub organization
Convert local mods (ZIP downloads) to Git repositories for easy updates
Branch/commit switching for testing specific mod versions
Status overview showing update availability, local changes, and sync state

Requirements

.NET 10.0 Runtime or later (Except for Self-Contained Releases)
Git installed and available in PATH

Installation

Standard Installation

Note

Your anti-virus may flag the download as suspicious/malicious, this is due to the code being unsigned. To remedy this would cost us real money and not a small amount either, you may check on VirusTotal or build from source.

Archive	Description
`*-selfcontained.zip/.tar.gz`	Standalone, no .NET required
`-win-x64.zip` / `-linux-x64.tar.gz`	Smaller, requires .NET 10 Runtime

Downloads are available in the Releases page:

Build from Source

git clone https://github.com/FalloutCollaborationProject/FCPModUpdater.git
cd FCPModUpdater
dotnet build

Usage

Tip

You may choose between either dotnet run -- ARGS or running the built application directly with the args (ex: FCPModUpdater scan)

Interactive Mode (scan arg, Default)

Launches the interactive menu where you can:

View status of all installed FCP mods
Update mods with available changes
Install new mods from FCP
Uninstall mods
Convert local (non-git) mods to git repositories
Switch mod versions (branches/commits)

Double Click

Windows: Double-click the .exe to launch the interactive menu directly — no command line needed.
Linux: The archive includes fcp-mod-manager.desktop for desktop integration. Copy it to ~/.local/share/applications/ and update the Exec path to point to the extracted binary.

Batch Update Mode

dotnet run -- update

Non-interactive mode that updates all FCP mods with available changes. Ideal for automation and scheduled tasks. Returns exit code 0 on success, 1 if any updates fail.

Options

Both commands accept:

-d, --directory <path> — Path to RimWorld Mods folder (auto-discovers if omitted)

dotnet run -- scan --directory "/path/to/RimWorld/Mods"
dotnet run -- update -d "C:\Games\RimWorld\Mods"

Environment Variables

Variable	Description
`GITHUB_TOKEN`	Optional. GitHub personal access token to increase API rate limit from 60 to 5000 requests/hour

How Mods Are Identified

FCP mods are identified by:

Git remote URL containing github.com/FalloutCollaborationProject/
Folder name matching an FCP repository (supports ZIP downloads with branch suffixes like -main)

Only repositories tagged with the rimworld-mod topic are included.

Status Icons

Icon	Status	Description
✓	Up to Date	No updates available
↓	Behind	Updates available
↑	Ahead	Local commits not on remote
⇅	Diverged	Both behind and ahead
~	Modified	Has uncommitted local changes
—	Not Git	Local folder (not a git repo)
✗	Error	Git operation failed