GitHunt
BO

BoBoBaSs84/X4.Black.Marketeer.Unlocker

X4 Black Marketeer Unlocker is a .NET 8 console application designed to modify your X4: Foundations save file, instantly unlocking all black marketeers. The tool safely creates a backup of your save file before making any changes, ensuring your original data is preserved.

CI
CodeQL
Dependabot

.NET
C#
Issues
Commit
Size
License
Release

X4.Black.Marketeer.Unlocker

Unlock all black marketeers in your X4: Foundations save file with a single command-line tool.

Overview

X4 Black Marketeer Unlocker is a .NET 8 console application designed to modify your X4: Foundations save file, instantly unlocking all black marketeers. The tool safely creates a backup of your save file before making any changes, ensuring your original data is preserved.

Features

  • Automatic Backup: Creates a .bak backup of your save file before modification.
  • Unlock All Black Marketeers: Scans and updates all relevant NPCs in your save file.
  • Safe and Transparent: Reports the number of marketeers found and details of each unlock.
  • Cross-Platform: Runs anywhere .NET 8 is supported.

Usage

Prerequisites

Running the Application

  1. Build the project using Visual Studio 2022 or the .NET CLI:
dotnet build
  1. Run the application from the command line, providing the path to your X4 save file:
X4.Black.Marketeer.Unlocker.exe <path-to-save-file.xml.gz>

Example:

X4.Black.Marketeer.Unlocker.exe "C:\Users\<YourAccount>\Documents\Egosoft\<YourSteamId>\X4\save\save_001.xml.gz"

What Happens

  • The tool creates a backup of your save file (<save-file>.bak) if one does not already exist.
  • It decompresses and parses the save file, finds all black marketeer NPCs, and unlocks them by updating their traits.
  • The modified save file is compressed and saved, overwriting the original.

License

This project is licensed under the MIT License.

Disclaimer

This tool modifies your X4: Foundations save files. Always keep backups of your original saves. Use at your own risk.

Languages

C#100.0%

Contributors

MIT License
Created January 3, 2026
Updated February 21, 2026
BoBoBaSs84/X4.Black.Marketeer.Unlocker | GitHunt