Moonlight Peaks Translation Toolkit

Moonlight Peaks Translation Toolkit

Short description

An open-source toolkit for extracting all available Moonlight Peaks localization strings, preparing multilingual TSV or JSONL translation files, validating translated text, and generating a lightweight BepInEx translation plugin.

The project currently targets French, but it can be adapted to any language.

---

About this mod

Moonlight Peaks Translation Toolkit is a complete workflow for creating and maintaining community translations for Moonlight Peaks.

• []Extract every localization collection loaded by the game.[/]

  []Export English, German, Japanese, Korean, Chinese, and any other detected language.[/]

  []Align all languages using the game's stable localization keys.[/]

  []Generate TSV files for manual translation with Excel, LibreOffice, or Google Sheets.[/]

  []Generate JSONL batches for AI-assisted translation.[/]

  []Import AI-generated translations.[/]

  []Validate placeholders, tags, controller inputs, and text encoding.[/]

  []Build a small BepInEx plugin that applies the translation at runtime.[/]

  []Update an existing translation after a game update.[/]

The original game files are never modified.

The current translation target is French, but the source code can be adapted for other languages.

---

Important information

This upload is a translation development toolkit.

It does not include:

• []The complete original English text.[/]

  []The official German, Japanese, Korean, or Chinese translations.[/]

  []Game DLL files.[/]

  []Game assets.[/]

  []BepInEx itself.[/]

  []Translation files copied from another mod.[/]

All official language files must be extracted locally from a legally owned copy of Moonlight Peaks.

---

Requirements

• []Moonlight Peaks[/]

  []Windows[/]

  []BepInEx 5 x64[/]

  []. NET 8 SDK[/]

  []Windows PowerShell 5. 1 or PowerShell 7[/]

BepInEx must already be installed in the Moonlight Peaks directory.

Launch the game once after installing BepInEx so that its folders are created.

---

Installation

1. Extract the toolkit

Extract the archive anywhere outside the Moonlight Peaks installation directory.

C:\Modding\MoonlightPeaksTranslationToolkit2. Configure the game path

Open PowerShell in the toolkit directory and run:

.\scripts\Configure.ps1 `

-GameDir "C:\Program Files (x86)\Steam\steamapps\common\Moonlight Peaks"This creates a local configuration file containing your game path (if your path is different, then change it).

3. Install the extractor

.\scripts\Install-Extractor.ps1The extraction plugin will be copied into:

Moonlight Peaks\BepInEx\plugins\MoonlightPeaksExtractor4. Launch the game

Launch Moonlight Peaks and wait at the main menu for several seconds.

The extractor searches for every loaded localization asset named:

TranslationCollection_Extracted files are created under:

BepInEx\plugins\MoonlightPeaksExtractor\workIf some languages are missing, select each missing language once in the game settings and return to the main menu.

You do not need to play through the game or manually encounter every dialogue line.

5. Copy the extracted files

Close the game and run:

.\scripts\Copy-Extraction.ps1The language files will be copied into the local toolkit workspace.

---

Manual translation workflow

Generate a multilingual TSV file:

.\scripts\Sync-Multilingual.ps1The generated file is:

work\review.multilingual.fr.tsvIt contains columns similar to:

ChineseSimplified

ChineseTraditional

frenchOpen this file with:

• []Microsoft Excel[/]

  []LibreOffice Calc[/]

  []Google Sheets[/]

  []Any UTF-8-compatible TSV editor

Only edit the

frenchcolumn.

Do not modify localization keys, placeholders, formatting tags, or input tokens.

After translating, import the TSV:

.\scripts\Import-Translations.ps1

---

AI-assisted translation workflow

Generate JSONL translation batches:

.\scripts\Export-AI-Corpus.ps1 -BatchSize 500The files are created under:

work\ai-corpus[/co