Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:38Z

Importing a new version from external source

New page

<languages />



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

 

Mod フォルダー内の同じ locale ファイルを使って、Modloader に表示されるテキストと Lua のテキストを翻訳します。PR #42 で追加された <code>shroudforge.locale()</code> から Modloader の言語を取得します。


== Locale ファイル ==

各言語について <code>locales/<code>.json</code> に 1 つファイルを追加します。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>] として公開されています。locale カタログでは <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 を追加し、この機能が各 Mod のカタログに接続します。

設定を読み取れず <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> は明示的に選択できるバリエーションとして残ります。

locale ファイルに runtime 機能は必要ありません。ShroudForge のインターフェーステキストは共有 Modloader 翻訳に含まれます。

[[Category:guide:Shroudforge]]

Translate mod text/ja - Revision history

Bonsaibauer: Importing a new version from external source