Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:42Z

Importing a new version from external source

New page

<languages />



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

 

使用模组文件夹中的同一组语言文件，翻译 Modloader 界面文本和 Lua 文本。通过 PR #42 添加的 <code>shroudforge.locale()</code> 读取 Modloader 语言。


== 语言文件 ==

为每种语言在 <code>locales/<code>.json</code> 下添加一个文件。Modloader 语言选择器当前支持的代码为 <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> 和 <code>zh</code>。文件名必须与代码完全一致。这些文件与 <code>mod.json</code> 和 <code>extended.mod.json</code> 放在一起。

架构已发布为 [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]。语言目录可以翻译 <code>mod.name</code> 和 <code>mod.description</code>、设置和选项标签、分组、操作、更新日志条目以及 Lua <code>strings</code>。目录可以只包含部分翻译。没有译文的条目会保留源文本。

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

设置和选项的键与 <code>extended.mod.json</code> 中的键保持一致。分组翻译遵循该文件中的分组顺序。操作翻译使用现有的操作 ID。已保存的值不会改变。


== 在 Lua 中使用相同文本 ==

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

<code>shroudforge.i18n.get(key, locale, fallback)</code> 使用 Modloader 已加载的同一目录。它会先检查 <code>de-AT</code> 这样的区域代码，然后检查语言代码 <code>de</code>。如果缺少字符串，则返回备用文本；如果未提供备用文本，则返回键本身。查询时不会重新读取文件。PR #42 提供语言 API，此功能会将它连接到每个模组的目录。

如果无法读取配置而使 <code>shroudforge.locale()</code> 返回 <code>en</code>，目录查询会先检查 <code>en-GB.json</code>，然后检查 <code>en.json</code>。<code>en-GB</code> 是 Modloader 的默认英语。<code>en-US</code> 仍可作为显式选择的变体使用。

语言文件不需要 runtime 能力。ShroudForge 界面文本仍位于 Modloader 共享翻译中。

[[Category:guide:Shroudforge]]

Translate mod text/zh - Revision history

Bonsaibauer: Importing a new version from external source