Jump to content
Toggle menu
  • 64 articles
  • 37 files
  • 9 users
  • 4.6K edits
Shroudforge
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

大きなMod設定を検索して整理する

From Shroudforge
This page is a translated version of the page Search and organize large mod settings and the translation is 100% complete.


Search and organize large mod settings



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以降が必要です。古いバージョンは認識しないフィールドを拒否します。