Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:37Z

Importing a new version from external source

New page

<languages />



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

 

Traduci il testo visibile del Modloader e il testo Lua usando gli stessi file locale nella cartella della mod. Leggi la lingua del Modloader tramite <code>shroudforge.locale()</code>, aggiunta dalla PR #42.


== File locale ==

Aggiungi un file <code>locales/<code>.json</code> per ogni lingua. I codici attuali del selettore della lingua del Modloader sono <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> e <code>zh</code>. Il nome del file deve corrispondere esattamente al codice. Questi file si trovano accanto a <code>mod.json</code> e <code>extended.mod.json</code>.

Lo schema è pubblicato come [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. Un catalogo locale può tradurre <code>mod.name</code> e <code>mod.description</code>, le etichette di impostazioni e opzioni, i gruppi, le azioni, le righe del changelog e le <code>strings</code> Lua. I cataloghi possono essere parziali. Le voci senza traduzione mantengono il testo sorgente.

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

Le chiavi di impostazioni e opzioni restano uguali a quelle di <code>extended.mod.json</code>. Le traduzioni dei gruppi seguono l'ordine dei gruppi in quel file. Le traduzioni delle azioni usano l'ID esistente dell'azione. I valori salvati non cambiano.


== Usa lo stesso testo in Lua ==

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

<code>shroudforge.i18n.get(key, locale, fallback)</code> usa lo stesso catalogo caricato dal Modloader. Controlla prima un codice regionale come <code>de-AT</code>, poi la relativa lingua <code>de</code>. Se manca una stringa, restituisce il testo di fallback o, se non è specificato, la chiave. La ricerca non rilegge i file. La PR #42 fornisce l'API della lingua e questa funzione la collega al catalogo di ogni mod.

Se <code>shroudforge.locale()</code> restituisce <code>en</code> perché non è possibile leggere la configurazione, il catalogo controlla prima <code>en-GB.json</code> e poi <code>en.json</code>. <code>en-GB</code> è la lingua inglese predefinita del Modloader. <code>en-US</code> resta disponibile come variante selezionabile esplicitamente.

I file locale non richiedono la capacità runtime. Il testo dell'interfaccia ShroudForge resta nelle traduzioni condivise del Modloader.

[[Category:guide:Shroudforge]]

Translate mod text/it - Revision history

Bonsaibauer: Importing a new version from external source