X2 Runtime Localization

X2 Runtime Localization

Overview
X2-Runtime-Localization is a mod for Xenonauts 2 that lets you add custom translation strings without overwriting the game’s original localization files. Instead, it merges your translations with the existing ones during the loading process.

How It Works

The mod activates when the game processes localization CSV files.

• It detects the language code from each file (e.g., en-US, ru-RU).

• It checks for a matching file in %mod_folder%/locale/<code>.csv.

• If a match exists, the mod appends your custom entries before the game parses the file.

• If no matching file is found, the process continues without changes.

This happens for every localization file the game loads, but only supported languages in your mod are affected.

Requirements

• A compiled X2-Runtime-Localization.dll file (provided separately).

• Translation CSV files placed in %mod_folder%/locale/, using the same naming format as the game (e.g., en-US.csv).

• CSV structure must match the original format, including columns like GUID, Key, Text, and Translation.

Installation

• Place X2-Runtime-Localization.dll in:
  %mod_folder%/assembly/common/

• Add your translation CSV files to:
  %mod_folder%/locale/

• Enable the mod through the launcher and start the game.

GUID and JSON Setup

Each translation must use GUIDs that match the LocalizableGUID entries defined in the game’s JSON assets. Name and description fields use separate GUIDs.

Debug Mode (Optional)

On first launch, the mod creates a DEBUG_FALSE file inside:
%mod_folder%/locale_mode/

Rename it to DEBUG_TRUE to enable logging. Logs will appear in the standard game log (if active) and in:
%mod_folder%/locale_mode/logs/runtime_localization.log

Compatibility & Status

This mod was developed quickly and hasn’t undergone full testing, so occasional bugs or instability may occur.