Skip to content
Timo edited this page Jul 30, 2026 · 3 revisions

Delta Green uses Foundry VTT's built-in localization system to support multiple languages.

  • Localization files live in lang/ as JSON files.
  • en.json is the source of truth. Any new strings must first appear in en.json.
  • To translate, add the matching keys to the appropriate language file (e.g. fr.json, de.json) with the translated value.

Creating a New Translation

  1. Get the latest language pack. Download en.json from the repository: https://github.com/deltagreen-foundryvtt/delta-green-foundry-vtt-system/tree/master/lang
  2. Copy and rename the file to your language code (e.g. pt.json for Portuguese).
  3. Translate the values from English to your target language, keeping the keys unchanged.
  4. Save the file.

💡 Tip: If you're unsure whether a string should be localized, it probably should be.

DG_Translation_01

Testing Your Translation

Test your translation locally before submitting it:

  1. Browse to the Delta Green system in your Foundry install.
  2. Place your new language file next to the other language files.
  3. Update system.json to include your new language pack (see screenshot below).
DG_Translation_02

⚠️ WARNING: Local changes will be deleted when you update your Delta Green system version. Always submit your finished language pack so it can be included in the system.


Submitting Your Translation

Once you're happy with your language pack, submit it in one of two ways:

  • Open an issue: Open an issue on GitHub and attach your file.
  • Submit a pull request: Pull down a copy of the system, make your changes, and open a pull request.

💡 Tip: Non-English language packs are not guaranteed to stay up to date when the system is updated. Community help keeping them current is welcome.


Additional Resources

Clone this wiki locally