Bonsaibauer: Importing a new version from external source

2026-11-07T01:06:32Z

Importing a new version from external source

New page

<languages />



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

 

Los textos visibles del Modloader y los textos de Lua usan los mismos archivos de idioma del mod. El idioma elegido en el Modloader se obtiene con <code>shroudforge.locale()</code>, incorporada en el PR #42.


== Archivos de idioma ==

Añade un archivo <code>locales/<código>.json</code> por cada idioma. Los códigos actuales del selector de idioma del Modloader son <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> y <code>zh</code>. El nombre del archivo debe coincidir exactamente con el código. Estos archivos se guardan junto a <code>mod.json</code> y <code>extended.mod.json</code>.

El esquema está publicado en [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. El catálogo puede traducir <code>mod.name</code>, <code>mod.description</code>, las etiquetas de ajustes y opciones, los grupos, las acciones, las notas de versión y las cadenas Lua bajo <code>strings</code>. Los catálogos pueden estar incompletos. El texto original se conserva si falta una traducción.

<pre>
{
"$schema": "https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json",
"settings": {
"severity": {
"label": "Nivel del registro",
"options": { "info": "Información", "warn": "Aviso" }
}
},
"groups": [
{ "label": "Registro", "actions": { "write": { "label": "Escribir mensaje" } } }
],
"strings": { "overlay.ready": "Listo" }
}
</pre>

Las claves de ajustes y opciones se mantienen iguales que en <code>extended.mod.json</code>. Los grupos siguen el mismo orden que en ese archivo. Las traducciones de acciones usan su identificador actual. Los valores guardados no cambian.


== Usar los mismos textos en 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 el mismo catálogo cargado que el Modloader. Busca primero el código regional, como <code>de-AT</code>, y después el idioma <code>de</code>. Si falta un texto, devuelve el texto alternativo o la clave. La consulta no vuelve a leer archivos. El PR #42 aporta la API de idioma y esta función la conecta con el catálogo de cada mod.

Si <code>shroudforge.locale()</code> devuelve <code>en</code> porque no se puede leer la configuración, la búsqueda consulta primero <code>en-GB.json</code> y después <code>en.json</code>. <code>en-GB</code> es el inglés predeterminado del Modloader. <code>en-US</code> sigue disponible como variante seleccionable explícitamente.

Los archivos de idioma no requieren el permiso <code>runtime</code>. Los textos propios de la interfaz de ShroudForge permanecen en las traducciones compartidas del Modloader.

[[Category:guide:Shroudforge]]

Translate mod text/es - Revision history

Bonsaibauer: Importing a new version from external source