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.

Cercare e organizzare le impostazioni estese delle mod

From Shroudforge
Revision as of 23:14, 8 November 2026 by Bonsaibauer (talk | contribs) (Importing a new version from external source)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Search and organize large mod settings



Usa i gruppi di impostazioni già presenti nel Modloader per organizzare la pagina di una mod in schede e rendere consultabili le lunghe liste a selezione multipla, con categorie facoltative. Le funzioni sono opzionali. I valori salvati non cambiano finché il giocatore non modifica una scelta. Si usano i file di lingua già presenti nella mod.

Cosa cambia in una pagina mod estesa

Questa funzione riguarda le impostazioni dichiarate da una mod in extended.mod.json. Usa la pagina delle impostazioni, i valori salvati e i file di lingua della mod già esistenti. Non aggiunge un archivio separato per le impostazioni.

Organizzare una selezione multipla lunga

Per multiselect, value resta un array e le scelte disponibili sono dichiarate in options. I controlli di ricerca appaiono automaticamente quando ci sono più di 12 scelte. L’esempio raggruppa anche le scelte e mette il gruppo di impostazioni in una scheda dedicata della pagina.

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

Le chiavi delle opzioni, come Twigs, sono i valori salvati per la mod. Le etichette testuali come "Twigs": "Twigs" restano supportate. La forma a oggetto aggiunge un label visibile e un group facoltativo. Le schede di categoria dividono le scelte all’interno della selezione multipla. La ricerca controlla sia l’etichetta visibile sia il valore salvato in tutte le categorie. Il conteggio mostra scelte visibili, totali e selezionate. “Solo selezionate” nasconde le scelte non selezionate senza deselezionarle. Modificando una casella si aggiorna lo stesso array salvato di prima. Una lista lunga scorre all’interno della sua impostazione.

Tradurre le etichette e le schede della mod

Le etichette create dalla mod si trovano nei suoi file esistenti locales/<code>.json. I controlli condivisi come Search, Only selected e All usano la lingua generale del Modloader scelta dal giocatore.

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

Le informazioni sul formato esistente sono disponibili nella guida alle lingue dei mod.

Mettere un gruppo di impostazioni in una scheda dedicata

Come esempio concreto, l’[extended.mod.json del World Editor di ShroudForge](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json) usa tab: true per Keyboard shortcuts, Blueprint placement e Native entity operations.

Valori salvati e compatibilità

Le etichette testuali esistenti, gli array salvati, i gruppi senza tab e i file di lingua senza optionGroups continuano a funzionare senza migrazione. La ricerca appare solo nelle selezioni multiple con più di 12 scelte. Gli oggetti opzione raggruppati, tab: true e optionGroups nei file di lingua richiedono ShroudForge 1.8.0 o successivo. Le versioni precedenti rifiutano i campi che non riconoscono.