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.

Wyszukiwanie i porządkowanie rozbudowanych ustawień modów

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



Użyj istniejących grup ustawień Modloadera, aby uporządkować stronę moda na kartach i umożliwić wyszukiwanie na długich listach wielokrotnego wyboru, opcjonalnie podzielonych na kategorie. Funkcje są opcjonalne. Zapisane wartości zmieniają się dopiero wtedy, gdy gracz zmieni wybór. Mod korzysta ze swoich istniejących plików lokalizacji.

Co zmienia się na rozbudowanej stronie moda

Ta funkcja dotyczy ustawień zadeklarowanych przez moda w extended.mod.json. Korzysta z istniejącej strony ustawień moda, zapisanych wartości i plików lokalizacji. Nie dodaje osobnego miejsca przechowywania ustawień.

Porządkowanie długiej listy wielokrotnego wyboru

W kontrolce multiselect wartość value pozostaje tablicą, a dostępne opcje są określone w options. Wyszukiwanie pojawia się automatycznie, gdy opcji jest więcej niż 12. Przykład grupuje też opcje i umieszcza grupę ustawień na osobnej karcie strony.

{
  "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 }
  ]
}

Klucze opcji, takie jak Twigs, są wartościami zapisywanymi dla moda. Etykiety tekstowe, na przykład "Twigs": "Twigs", nadal są obsługiwane. Forma obiektu dodaje widoczną etykietę label i opcjonalną kategorię group. Karty kategorii dzielą opcje wewnątrz listy wielokrotnego wyboru. Wyszukiwanie sprawdza widoczną etykietę i zapisaną wartość we wszystkich kategoriach. Licznik pokazuje widoczne, wszystkie i wybrane opcje. „Tylko wybrane” ukrywa niewybrane pozycje, ale ich nie odznacza. Zmiana pola wyboru aktualizuje tę samą zapisaną tablicę co wcześniej. Długa lista przewija się wewnątrz ustawienia.

Tłumaczenie etykiet i kart moda

Etykiety przygotowane przez moda znajdują się w jego istniejących plikach locales/<code>.json. Wspólne elementy, takie jak Search, Only selected i All, używają ogólnego języka Modloadera wybranego przez gracza.

{
  "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" }
  ]
}

Zobacz poradnik lokalizacji modów, aby poznać istniejący format.

Umieszczanie grupy ustawień na osobnej karcie

Praktyczny przykład to [extended.mod.json moda ShroudForge World Editor](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json), gdzie grupy Keyboard shortcuts, Blueprint placement i Native entity operations używają tab: true.

Zapisane wartości i zgodność

Istniejące tekstowe etykiety opcji, zapisane tablice, grupy bez tab i pliki lokalizacji bez optionGroups nadal działają bez migracji. Wyszukiwanie pojawia się tylko w listach wielokrotnego wyboru z ponad 12 opcjami. Grupowane obiekty opcji, tab: true i optionGroups w plikach lokalizacji wymagają ShroudForge 1.8.0 lub nowszego. Starsze wersje odrzucają nierozpoznane pola.