2.2 KiB
Translating Races of Valheim
Thanks for helping. This page covers the rules for translations.
Where to work
- Each language has its own branch,
localisation-<language>(for examplelocalisation-russian). Work only on that branch. - When you're done, open a pull request into
localisation. Never open one intomain. - Edit only the files under
JotunnModStub/Translations/<Language>/. Leave every other file alone.
If your language has no branch yet, ask for one.
The files
Each file is a JSON list of key/value pairs:
"rov_race_furling_desc": "Cunning goblin-like creatures. Agile and resourceful."
- Never change a key. Keys look like
rov_<section>_<thing>. Translate only the value on the right. - Keep placeholders exactly as they are.
$1,$2and any other$wordinside a value get replaced by numbers or names in game. You can move them around in the sentence, but don't rename, translate or delete them. - Keep
\nline breaks where they are.
What not to translate
-
Race IDs. These are the internal race names the code uses, and they never change. Race display names, such as the value of
rov_race_furling_name, are translated. -
Ability names that are quotes or song titles. These stay in the original language:
- Purple Rain
- Weight of Shadows
- Like a Bat out of Hell
- Vae Victis
- Swarm of Terror
- The Furling passives: Master of Shadows, Dance of the Dead, Through Fire and Flames, The Wickerman
If one of these names appears inside a longer sentence, translate the sentence and leave the name as it is.
-
Translate every other, purely functional, ability name (for example "Combat Mastery").
Keep the JSON valid
- Save files as UTF-8 without a BOM.
- No trailing comma after the last entry.
- Escape double quotes inside values as
\".
Check each file before you push:
python -m json.tool JotunnModStub/Translations/<Language>/races.json
If it prints the file back, it's fine. If it prints an error, it shows the line to fix.
Partial translations are fine
Any key missing from your files, or still in English, falls back to the English text in game. You can translate a file at a time and push as you go.