contributing translations

Contributing Translations

A translation pack always has gaps. Some are sentences nobody noticed; some are strings the game constructs in a way the plugin doesn't yet recognize. Sharing what you find helps everyone.

Where to share

• Shared translation spreadsheet. Maintained collaboratively across languages — used to compare English source strings and identify missing entries.
• GitHub issues. This is for bugs in the plugin itself. It's not the place for "please translate my language" — that's your own pack.
• Pull requests. Welcome for plugin-side fixes: new FSM hooks, additional drift-tracked paths, parser improvements. See Setting up development environment for how to build.

Bundling the plugin with your language pack

You can ship MWC_Localization_Core.dll alongside your .txt files so end users only need to download one archive. That's the intended distribution model.

A few asks if you do:

• Mention the source. A line like "Includes MWC Localization Core" with a link to this repo or the upstream NexusMods page is appreciated. The plugin updates independently of language packs, and pointing users back lets them grab fixes.
• Note the plugin version you bundled. Helps end users tell whether they need to update.
• Tell users to remove old BepInEx installs if you're shipping a v1.x release that follows a v0.x BepInEx-era pack. Stale BepInEx folders cause hard-to-diagnose conflicts.

Reporting missing strings

The most useful bug report includes:

1. The exact English (or Finnish) source as it appears on screen.
2. Where in the game it shows up (screen, scene, what triggers it).
3. Whether you tried it in translate.txt and it didn't take effect.
4. A screenshot if the position or layout is part of the problem.

That's enough for whoever picks up the issue to grep the source and decide whether it's a missing entry, a pattern that needs to be added, or a new FSM hook.

A note on credit

Translators do real work. Put your name in the language pack README, on the NexusMods page, anywhere you like — and feel free to lift translations from other community packs into your own (or contribute back into theirs). The whole point of having a shared spreadsheet is to make that easy.