Grote modinstellingen doorzoeken en ordenen
More actions
Gebruik de bestaande instellingengroepen van de Modloader om een modpagina in tabbladen te ordenen en lange meerkeuzelijsten doorzoekbaar te maken, met optionele categorieën. De functies zijn optioneel. Opgeslagen waarden veranderen pas wanneer de speler een keuze wijzigt. De bestaande taalbestanden van de mod worden gebruikt.
Wat verandert er op een grote modpagina
Deze functie is bedoeld voor instellingen die een mod in extended.mod.json opgeeft. Ze gebruikt de bestaande modinstellingenpagina, opgeslagen instellingswaarden en taalbestanden van de mod. Er komt geen aparte instellingenopslag bij.
Een lange meerkeuzelijst ordenen
Bij multiselect blijft value een array en staan de beschikbare keuzes in options. Zoekbediening verschijnt automatisch bij meer dan 12 keuzes. Het voorbeeld groepeert de keuzes ook en zet de instellingengroep in een eigen paginatabblad.
{
"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 }
]
}
Optiesleutels zoals Twigs zijn de waarden die voor de mod worden opgeslagen. Tekstlabels zoals "Twigs": "Twigs" blijven ondersteund. De objectvorm voegt een zichtbaar label en een optionele group toe. Categorietabbladen verdelen de keuzes binnen de meerkeuzelijst. De zoekfunctie controleert zowel het zichtbare label als de opgeslagen waarde in alle categorieën. De teller toont zichtbare, totale en geselecteerde keuzes. “Alleen geselecteerde” verbergt niet-geselecteerde keuzes zonder ze uit te vinken. Een wijziging werkt dezelfde opgeslagen array bij als voorheen. Een lange lijst scrolt binnen de instelling zelf.
Modlabels en tabbladen vertalen
Door de mod geschreven labels horen in de bestaande bestanden locales/<code>.json. Gedeelde bedieningselementen zoals Search, Only selected en All gebruiken de algemene Modloader-taal van de speler.
{
"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" }
]
}
Bekijk de handleiding voor modtaalbestanden voor het bestaande formaat.
Een instellingengroep een eigen tabblad geven
Een werkend voorbeeld is de [extended.mod.json van ShroudForge World Editor](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json), waarin Keyboard shortcuts, Blueprint placement en Native entity operations tab: true gebruiken.
Opgeslagen waarden en compatibiliteit
Bestaande tekstlabels voor opties, opgeslagen arrays, groepen zonder tab en taalbestanden zonder optionGroups blijven zonder migratie werken. Zoeken verschijnt alleen bij meerkeuzelijsten met meer dan 12 keuzes. Gegroepeerde optieobjecten, tab: true en optionGroups in taalbestanden vereisen ShroudForge 1.8.0 of nieuwer. Oudere versies weigeren velden die ze niet herkennen.