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

• .NET 8 SDK installed.

Running the Application

1. Build the project using Visual Studio 2022 or the .NET CLI:

dotnet build

2. 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.