#1484

feat(i18n): Add localization framework and support for 13 languages

OpenProGraMajsterwants to merge intofrom

Overview

BeamNG.Earth can now follow any of the 13 official BeamNG.drive interface languages. English is the base language, and every bundled language has a complete shared message catalog, including the Polish translation that started this work. The same framework gives community translators a place to improve existing wording or add another language. BeamNG.drive language list

What's included?

LanguageCatalogShared catalog coverage
Englishen1,005 / 1,005
German (Germany)de-DE1,005 / 1,005
Spanish (Spain)es-ES1,005 / 1,005
Spanish (Latin America)es-4191,005 / 1,005
French (France)fr-FR1,005 / 1,005
Japaneseja-JP1,005 / 1,005
Koreanko-KR1,005 / 1,005
Polishpl-PL1,005 / 1,005
Portuguese (Brazil)pt-BR1,005 / 1,005
Portuguese (Portugal)pt-PT1,005 / 1,005
Russianru-RU1,005 / 1,005
Simplified Chinesezh-Hans1,005 / 1,005
Traditional Chinesezh-Hant1,005 / 1,005

The catalog completion adds 493 entries to each of the eleven newer catalogs, for 5,423 translated entries in total. Each game locale also has 22 native metadata messages for the HUD app library and input bindings.

  • Language selection. Interface → Interface language defaults to Automatic, which follows BeamNG.drive. A manual choice is saved and updates open views without a restart. The launcher follows the operating system language at startup and supports a manual override.
  • Shared catalogs. Vue, Lua and the Python launcher draw from the same catalogs. The framework supports named placeholders and plural forms, with locale-aware number and date formatting in the Vue UI. Spanish, Portuguese and Chinese variants keep their own wording.
  • Translated screens. The catalogs cover both maps, GPS and navigation, teleportation and saved places, settings and help, loading and server status, the welcome screen, add-ons, multiplayer, the launcher, reports and the performance profiler.

How fallback works

Suppose a new catalog includes Ustawienia for Settings and Grafika for Graphics, with Restart server still to translate. The interface will show Ustawienia, Grafika, and Restart server. The language choice stays active, and English supplies the missing message. Invalid messages also fall back safely. This lets contributors share useful translations before every entry is ready.

For translators and contributors

Translations live in JSON catalogs. You can edit a message there without changing the interface components that display it. The validator reports missing entries and checks placeholders, plural forms, and native metadata. BeamNG.Earth localization guide

The eleven newer catalogs were prepared with AI assistance. Native-speaker feedback is welcome, especially on regional usage, technical terms and how the text fits in the game. Contributions for additional languages and improvements to existing translations are welcome.

Verification

  • python tools/check_locales.py --format json passed. Strict coverage checks passed for all 13 catalogs, with 1,005 shared entries and 22 native metadata messages per locale. Coverage measures the keys in the localization inventory.
  • The catalog completion passed 17 JavaScript tests for localization, UI lifecycle and map search, two targeted Lua modules for localization and loading status, and eight Python launcher localization tests.
  • The earlier review covered 142 Lua modules, compilation of eight Vue components, and verification of the source and BeamMP packages. Two Windows symlink errors in the broader checks were reproduced on clean upstream. The PR author also tested the Polish interface and key gameplay flows in BeamNG.drive 0.40.6 on Windows. In-game language and layout review of the eleven newer catalogs remains open.

Compatibility

Existing world settings, saved places, geographic data, action IDs, and network message formats retain their current representation. The language preference is stored separately. English remains the fallback. The native HUD library and input binding labels follow the game's locale.