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?
| Language | Catalog | Shared catalog coverage |
|---|---|---|
| English | en | 1,005 / 1,005 |
| German (Germany) | de-DE | 1,005 / 1,005 |
| Spanish (Spain) | es-ES | 1,005 / 1,005 |
| Spanish (Latin America) | es-419 | 1,005 / 1,005 |
| French (France) | fr-FR | 1,005 / 1,005 |
| Japanese | ja-JP | 1,005 / 1,005 |
| Korean | ko-KR | 1,005 / 1,005 |
| Polish | pl-PL | 1,005 / 1,005 |
| Portuguese (Brazil) | pt-BR | 1,005 / 1,005 |
| Portuguese (Portugal) | pt-PT | 1,005 / 1,005 |
| Russian | ru-RU | 1,005 / 1,005 |
| Simplified Chinese | zh-Hans | 1,005 / 1,005 |
| Traditional Chinese | zh-Hant | 1,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 jsonpassed. 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.