Localization/Translation

You can contribute to this mod by translating (localizing) text it adds into your native language. The mod adds a number of new incantations, cosmetics, boons and other texts that need translation into the different languages supported by Hades II. In addition to this, Hades II supports more languages than Hades did (Hades II added Greek, Turkish, Ukrainian and Traditional Chinese), meaning that for these languages, even more text (such as boss and NPC dialogues) are currently in English only.

This is the current localization progress:

Fully localized:

• French (fr) (by @JeanDupin)

Need localization for mod content:

• German (de)
• Spanish (es)
• Italian (it)
• Japanese (ja)
• Korean (ko)
• Polish (pl)
• Brazilian Portuguese (pt-BR)
• Russian (ru)
• Simplified Chinese (zh-CN)

Need full localization (Hades base texts + mod texts):

• Greek (el)
• Turkish (tr)
• Ukrainian (uk)
• Traditional Chinese (zh-TW)

You can provide localizations for texts the mod adds for these languages the same way as for other languages. If you would like to provide localizations beyond this, for base game Hades texts, please reach out to me on the Hades Modding Discord by creating a post in the #help-h2 channel.

How to contribute a localization

You can contribute translations for your native language very easily, either only for certain sections of the mod, or for all new content - but I would ask that if you start translating one type of content, that you translate all text in that section.

To get started, I recommend creating a GitHub account and forking the repository, modifying the files on your fork, and then opening a Pull Request from your fork. This is the easiest way of contributing, and for us to collaborate on potentially required changes.

If you do not have a GitHub account, you may also manually download the repository files, translate the relevant ones, and then send me the changed files on Discord - you can find me under @NikkelM on the Hades Modding Discord. Create a post in the #help-h2 channel, and I'll get in touch with you.

Everything except Cosmetics

You can find most texts in the data/Hell2Modding-SJSON/Text/<language shorthand> folders of the mod repository.

Each folder contains a number of .sjson files, which have entries such as this:

// {
// 	Id = "ModsNikkelMHadesBiomes_Codex_EurydiceUnlockHint01"
// 	DisplayName =
// 	"{$TempTextData.CharacterName} would love to cook with {!TempTextData.ResourceIcon} once she has reconnected with her long lost love."
// }

To translate an entry, remove the comments (leading //) in front of the lines starting with the opening brace { and including the closing brace }, and replace everything except content in curly {} brackets (which are formatting placeholders) with your translation.

The above snippet would look like this if translated into e.g. French:

{
  Id = "ModsNikkelMHadesBiomes_Codex_EurydiceUnlockHint01"
  DisplayName =
  "{$TempTextData.CharacterName} adorerait cuisiner avec {!TempTextData.ResourceIcon} une fois qu'elle aura retrouvé son amour perdu."
}

For some sections, I have added comments describing limitations, e.g. maximum lengths of certain items, so that they fit into the space the game provides for the text.

Cosmetics

For Cosmetics, texts are located in src/Scripts/CosmeticsData.lua, directly assigned to each cosmetic item. To add a translation for an item, remove the comment (leading --) in front of your language's shorthand (e.g. fr for French). For cosmetics, Hades II has certain rules it follows for each cosmetic item and language, e.g. in English, all cosmetics follow the <Type>, <Name> format, while in e.g. French they follow <Type> <Name> without a comma - these rules are documented in the first cosmetic in the file for your convenience.

One more thing

Zagreus' Journey automatically installs the Hades OST for the Music Maker mod, which adds one new incantation to unlock music from the Hades soundtrack at the Music Maker. You can localize this incantation using the same approach as for the other .sjson files before by translating the relevant file at this path: src/Game/Text/HelpText.<language shorthand>.sjson.lua.