Sök i och ordna stora modinställningar
More actions
Använd Modloaders befintliga inställningsgrupper för att ordna en modsida i flikar och göra långa flervalslistor sökbara, med valfria kategorier. Funktionerna är frivilliga. Sparade värden ändras först när spelaren ändrar ett val. Moddens befintliga språkfiler används.
Vad som ändras på en stor moddsida
Funktionen gäller inställningar som en mod deklarerar i extended.mod.json. Den använder den befintliga moddsidan för inställningar, sparade inställningsvärden och moddens språkfiler. Den skapar ingen separat inställningslagring.
Ordna en lång flervalslista
För multiselect förblir value en array och tillgängliga val anges i options. Sökfunktioner visas automatiskt när det finns fler än 12 val. Exemplet grupperar även valen och placerar inställningsgruppen på en egen sidflik.
{
"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 }
]
}
Alternativnycklar som Twigs är värdena som sparas för modden. Textetiketter som "Twigs": "Twigs" stöds fortfarande. Objektformen lägger till en synlig label och en valfri group. Kategoriflikarna delar upp valen i flervalslistan. Sökningen kontrollerar både den synliga etiketten och det sparade värdet i alla kategorier. Räknaren visar synliga, totala och valda alternativ. ”Endast valda” döljer omarkerade alternativ utan att avmarkera dem. När en kryssruta ändras uppdateras samma sparade array som tidigare. En lång lista rullar inom inställningen.
Översätt moddetiketter och flikar
Etiketter som modden själv skriver hör hemma i dess befintliga filer locales/<code>.json. Delade kontroller som Search, Only selected och All använder spelarens allmänna Modloader-språk.
{
"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" }
]
}
Se guiden för moddens språkfiler för det befintliga formatet.
Lägg en inställningsgrupp på en egen flik
Ett fungerande exempel finns i [ShroudForge World Editors extended.mod.json](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json), där Keyboard shortcuts, Blueprint placement och Native entity operations använder tab: true.
Sparade värden och kompatibilitet
Befintliga textetiketter för alternativ, sparade arrayer, grupper utan tab och språkfiler utan optionGroups fortsätter att fungera utan migrering. Sökningen visas bara för flervalslistor med fler än 12 val. Grupperade alternativobjekt, tab: true och optionGroups i språkfiler kräver ShroudForge 1.8.0 eller senare. Äldre versioner avvisar fält de inte känner igen.