Bonsaibauer: Importing a new version from external source

2026-11-07T01:55:50Z

Importing a new version from external source

New page

<languages />



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

 

Les textes visibles dans le Modloader et les textes Lua utilisent les mêmes fichiers de langue du mod. La langue choisie dans le Modloader se lit avec <code>shroudforge.locale()</code>, ajoutée par la PR #42.


== Fichiers de langue ==

Ajoutez un fichier <code>locales/<code>.json</code> par langue. Les codes actuels du sélecteur du Modloader sont <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> et <code>zh</code>. Le nom du fichier reprend exactement le code. Ces fichiers accompagnent <code>mod.json</code> et <code>extended.mod.json</code>.

Le schéma est publié sous [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. Le catalogue peut traduire <code>mod.name</code>, <code>mod.description</code>, les libellés des paramètres et des options, les groupes, les actions, les notes de version et les chaînes Lua sous <code>strings</code>. Les fichiers peuvent être incomplets. Le texte source est conservé pour les traductions manquantes.

<pre>
{
"$schema": "https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json",
"settings": {
"severity": {
"label": "Niveau du journal",
"options": { "info": "Information", "warn": "Avertissement" }
}
},
"groups": [
{ "label": "Journal", "actions": { "write": { "label": "Écrire un message" } } }
],
"strings": { "overlay.ready": "Prêt" }
}
</pre>

Les clés des paramètres et des options restent identiques à celles de <code>extended.mod.json</code>. Les groupes suivent le même ordre que dans ce fichier. Les traductions d’action utilisent leur identifiant existant. Les valeurs enregistrées ne changent pas.


== Utiliser les mêmes textes dans Lua ==

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

<code>shroudforge.i18n.get(key, locale, fallback)</code> utilise le même catalogue chargé que le Modloader. Le code régional, comme <code>de-AT</code>, est recherché avant sa langue <code>de</code>. Si le texte manque, la fonction renvoie le texte de remplacement ou la clé. La recherche ne relit pas les fichiers. La PR #42 fournit l’API de langue, puis cette fonctionnalité la relie au catalogue de chaque mod.

Si <code>shroudforge.locale()</code> renvoie <code>en</code> parce que la configuration est illisible, la recherche consulte d’abord <code>en-GB.json</code>, puis <code>en.json</code>. <code>en-GB</code> est la langue anglaise par défaut du Modloader. <code>en-US</code> reste disponible comme variante sélectionnée explicitement.

Les fichiers de langue ne nécessitent pas la capacité runtime. Les textes de l’interface ShroudForge restent dans les traductions communes du Modloader.

[[Category:guide:Shroudforge]]

Translate mod text/fr - Revision history

Bonsaibauer: Importing a new version from external source