Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:38Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-modding-locales.svg|thumb|left|600px|Translate mod text]]

 

Vertaal zichtbare Modloader-tekst en Lua-tekst met dezelfde taalbestanden in de modmap. Lees de Modloader-taal via <code>shroudforge.locale()</code>, toegevoegd in PR #42.


== Taalbestanden ==

Voeg voor elke taal één bestand toe onder <code>locales/<code>.json</code>. De huidige codes uit de taalkeuze van Modloader zijn <code>de</code>, <code>de-AT</code>, <code>de-CH</code>, <code>en-GB</code>, <code>en-US</code>, <code>es</code>, <code>fr</code>, <code>hi</code>, <code>it</code>, <code>ja</code>, <code>nl</code>, <code>pl</code>, <code>sv</code> en <code>zh</code>. De bestandsnaam moet exact overeenkomen met de code. Deze bestanden staan naast <code>mod.json</code> en <code>extended.mod.json</code>.

Het schema is gepubliceerd als [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. Een taalcatalogus kan <code>mod.name</code> en <code>mod.description</code>, labels van instellingen en opties, groepen, acties, changelogregels en Lua-<code>strings</code> vertalen. Catalogi mogen gedeeltelijk zijn. Niet-vertaalde items behouden de brontekst.

<pre>
{
"$schema": "https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json",
"settings": {
"severity": {
"label": "Log level",
"options": { "info": "Information", "warn": "Warning" }
}
},
"groups": [
{ "label": "Logging", "actions": { "write": { "label": "Write message" } } }
],
"strings": { "overlay.ready": "Ready" }
}
</pre>

Sleutels voor instellingen en opties blijven hetzelfde als in <code>extended.mod.json</code>. Vertalingen van groepen volgen de volgorde van de groepen in dat bestand. Actievertalingen gebruiken de bestaande actie-ID. Opgeslagen waarden veranderen niet.


== Dezelfde tekst in Lua gebruiken ==

<pre>
local locale = shroudforge.locale()
local ready = shroudforge.i18n.get("overlay.ready", locale, "Ready")
</pre>

<code>shroudforge.i18n.get(key, locale, fallback)</code> gebruikt dezelfde catalogus die door Modloader is geladen. Het controleert eerst een regiocode zoals <code>de-AT</code> en daarna de bijbehorende taal <code>de</code>. Als een tekenreeks ontbreekt, retourneert de functie de terugvaltekst of de sleutel wanneer geen terugvaltekst is opgegeven. Bestanden worden bij het opzoeken niet opnieuw gelezen. PR #42 levert de taal-API en deze functie verbindt die met de catalogus van elke mod.

Als <code>shroudforge.locale()</code> <code>en</code> retourneert omdat de configuratie niet kan worden gelezen, controleert de catalogus eerst <code>en-GB.json</code> en daarna <code>en.json</code>. <code>en-GB</code> is de standaardtaal Engels van Modloader. <code>en-US</code> blijft beschikbaar als expliciet gekozen variant.

Taalbestanden vereisen geen runtime-mogelijkheid. ShroudForge-interfacetekst blijft in de gedeelde Modloader-vertalingen.

[[Category:guide:Shroudforge]]

Translate mod text/nl - Revision history

Bonsaibauer: Importing a new version from external source