This mod makes it (relatively) easy to replace text, add translatable text, and add entire new languages to the game.
<BepInEx Folder>/pluginsUsage of this mod revolves around creating translation sheets.
A translation sheet is an XML document containing many key (used for lookup) and value (displayed to user) pairs formatted as such:
<entries>
<entry name="KEY">Value</entry>
<entry name="Hello">World!</entry>
</entries>
The mod automatically registers directories as localization directories if their path is
<BepInEx folder>/plugins/*/SSL.Localization/.
For example with a layout like this:
└── BepInEx
└── plugins
├── AmazingMod
│ └── SSL.Localization
│ └── EN
│ └── MainMenu
├── Mod
│ └── Sub
│ └── SSL.Localization
├── Mod1
├── MyMod
│ └── SSL.Localization
└── MyOtherMod
└── Nope
Only MyMod/SSL.Localization and AmazingMod/SSL.Localization are registered as localization directories.
Additional directories can be registered with code that calls
SimpleSilkongLocalizerPlugin.AddLocalizationDirectory(string localizationDirectory).
(This requires creating a C# project that uses this as a dependency)
To replace text, you must create a sheet with an entry that has the same key. The sheet must also be named to match the original sheet, but with a slight adjustment.
The game's original sheets are in files named <language code>_<sheet title>,
but this mod looks for files in the localization directory named <language code>/<sheet title>.
Example: Replace the "Start Game" text on the main menu with "Don't Start Game" for English.
This text is usually kept in the EN_MainMenu sheet
<localization directory>/EN/MainMenu
<entries>
<entry name="MAIN_START">Don't Start Game</entry>
</entries>
Please note: ' is used to insert an apostrophe ', because it cannot be used directly for XML values, along with some other characters.
EN/Sheet1)LocalizationSettings.json,LocalizationSettings.json set the CustomSheets key to an array of paths to sheets you'd like to add.{
"CustomSheets": [
"Sheet1",
"subdirectory/mysheet"
]
}
If you are not providing sheets for every available language (default: DE, EN, ES, FR, IT, JA, KO, PT, RU, ZH), and would like for text from another language to be displayed instead of user-unfriendly sheet-key pair strings:
Set the Fallback key. This allows you to set which language to fallback on if text is missing,
as well as exclude certain languages from displaying text from the fallback language.
{
"CustomSheets": [
"Sheet1",
"subdirectory/mysheet"
],
"Fallback": {
"Language": "EN",
"Excluded": []
}
}