大きなMod設定を検索して整理する
More actions
Modloaderに既にある設定グループを使ってModページをタブに整理し、長い複数選択リストを検索できるようにして、必要に応じてカテゴリを付けられます。どちらも任意の機能です。プレイヤーが選択を変更しない限り、保存済みの値は変わりません。Modに既にあるロケールファイルを使います。
大きなModページで変わること
この機能は、Modがextended.mod.jsonで宣言する設定を対象とします。既存のMod設定ページ、保存済みの設定値、Modロケールファイルを使います。別の設定保存先は追加しません。
長い複数選択を整理する
multiselectではvalueは配列のままにし、選択肢をoptionsに定義します。選択肢が12個を超えると検索コントロールが自動で表示されます。この例では選択肢をグループ化し、設定グループをページ内の専用タブにも配置します。
{
"schemaVersion": 1,
"enabled": true,
"settings": {
"showEffects": {
"value": true,
"label": "Show effects",
"control": "toggle"
},
"excludeItems": {
"value": [],
"label": "Excluded items",
"description": "Choose items this mod should ignore.",
"control": "multiselect",
"options": {
"Twigs": { "label": "Twigs", "group": "Materials" },
"Stone": { "label": "Stone", "group": "Materials" },
"Resin": { "label": "Resin", "group": "Materials" },
"Plant Fiber": { "label": "Plant Fiber", "group": "Materials" },
"Shroud Wood": { "label": "Shroud Wood", "group": "Materials" },
"Fossilized Bone": { "label": "Fossilized Bone", "group": "Materials" },
"Metal Scraps": { "label": "Metal Scraps", "group": "Materials" },
"Fire Fly": { "label": "Fire Fly", "group": "Creatures" },
"Fell Wispwyvern": { "label": "Fell Wispwyvern", "group": "Creatures" },
"Hollow Halls": { "label": "Hollow Halls", "group": "Creatures" },
"Bronze Arrows": { "label": "Bronze Arrows", "group": "Ammunition" },
"Explosive Arrows": { "label": "Explosive Arrows", "group": "Ammunition" },
"Poison Arrows": { "label": "Poison Arrows", "group": "Ammunition" }
}
}
},
"groups": [
{ "label": "General", "settings": ["showEffects"] },
{ "label": "Excluded items", "settings": ["excludeItems"], "tab": true }
]
}
Twigsなどの選択肢キーはModに保存される値です。"Twigs": "Twigs"のような文字列ラベルも引き続き使えます。オブジェクト形式では表示用のlabelと任意のgroupを追加できます。カテゴリタブは複数選択内の選択肢を分類します。検索は表示ラベルと保存値の両方を対象に、すべてのカテゴリを検索します。件数には表示中、合計、選択済みの数が表示されます。「選択済みのみ」は未選択の項目を隠すだけで、選択状態は変更しません。チェックを変更すると従来と同じ保存配列が更新され、長いリストは設定欄の中でスクロールします。
Modのラベルとタブを翻訳する
Modが用意するラベルは、既存のlocales/<code>.jsonファイルに記述します。Search、Only selected、Allなど共通の操作ラベルには、プレイヤーが選んだModloader全体の言語を使います。
{
"settings": {
"excludeItems": {
"options": {
"Twigs": "Twigs",
"Stone": "Stone",
"Fire Fly": "Fire Fly",
"Bronze Arrows": "Bronze Arrows"
},
"optionGroups": {
"Materials": "Materials",
"Creatures": "Creatures",
"Ammunition": "Ammunition"
}
}
},
"groups": [
{ "label": "General" },
{ "label": "Excluded items" }
]
}
既存の形式についてはModロケールガイドを参照してください。
設定グループを専用タブにする
実例として、[ShroudForge World Editorのextended.mod.json](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json)ではKeyboard shortcuts、Blueprint placement、Native entity operationsの各グループにtab: trueを指定しています。
保存値と互換性
既存の文字列オプションラベル、保存済み配列、tabのないグループ、optionGroupsのないロケールファイルは、移行なしで引き続き使えます。検索は選択肢が12個を超える複数選択にだけ表示されます。グループ化されたオプションオブジェクト、tab: true、ロケール内のoptionGroupsにはShroudForge 1.8.0以降が必要です。古いバージョンは認識しないフィールドを拒否します。