Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:45Z

Importing a new version from external source

New page

<languages />



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

 

Översätt synlig Modloader-text och Lua-text från samma språkfiler i modmappen. Läs Modloader-språket med <code>shroudforge.locale()</code>, som lades till i PR #42.


== Språkfiler ==

Lägg till en fil under <code>locales/<code>.json</code> för varje språk. De aktuella koderna i Modloaders språkval är <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> och <code>zh</code>. Filnamnet ska stämma exakt med koden. Filerna ligger bredvid <code>mod.json</code> och <code>extended.mod.json</code>.

Schemat publiceras som [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. En språkkatalog kan översätta <code>mod.name</code> och <code>mod.description</code>, etiketter för inställningar och alternativ, grupper, åtgärder, ändringsloggar och Lua-<code>strings</code>. Kataloger kan vara ofullständiga. Poster utan översättning behåller sin källtext.

<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>

Nycklar för inställningar och alternativ är desamma som i <code>extended.mod.json</code>. Gruppöversättningar följer gruppordningen i den filen. Åtgärdsöversättningar använder det befintliga åtgärds-ID:t. Sparade värden ändras inte.


== Använd samma text i Lua ==

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

<code>shroudforge.i18n.get(key, locale, fallback)</code> använder samma katalog som Modloader har läst in. Funktionen kontrollerar först en regionkod som <code>de-AT</code> och därefter språket <code>de</code>. Om en sträng saknas returneras reservtexten eller nyckeln om ingen reservtext anges. Sökningen läser inte in filerna på nytt. PR #42 tillhandahåller språk-API:t och den här funktionen kopplar det till varje mods katalog.

Om <code>shroudforge.locale()</code> returnerar <code>en</code> eftersom konfigurationen inte kan läsas, kontrollerar katalogen först <code>en-GB.json</code> och sedan <code>en.json</code>. <code>en-GB</code> är Modloaders standard för engelska. <code>en-US</code> finns kvar som en variant som kan väljas uttryckligen.

Språkfiler kräver inte runtime-funktionen. ShroudForges gränssnittstext finns kvar i Modloaders gemensamma översättningar.

[[Category:guide:Shroudforge]]

Translate mod text/sv - Revision history

Bonsaibauer: Importing a new version from external source