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.

Extended.mod.json

From Shroudforge
Revision as of 00:15, 18 November 2026 by Bonsaibauer (talk | contribs) (Marked this version for translation)


extended.mod.json is an optional file alongside mod.json. Use it to define player-facing settings, organize them into groups, add actions and links, and store the enabled state.

Main fields

  • schemaVersion is currently 1.
  • enabled stores whether the mod is switched on.
  • targets selects the process that loads the mod. It does not replicate changes over the network.
  • settings stores mod-specific values.
  • groups organizes settings in the Modloader. Ungrouped settings appear in a default group.
  • launcher can preserve the origin of an imported EML mod.

Example

{
  "$schema": "https://shroudforge.net/schemas/1.8.0/extended.mod.schema.json",
  "schemaVersion": 1,
  "enabled": false,
  "targets": ["client"],
  "settings": {
    "greeting": {
      "value": "Hello from my mod",
      "label": "Greeting",
      "control": "text"
    }
  },
  "groups": [
    {
      "label": "Messages",
      "settings": ["greeting"]
    }
  ]
}

The setting key is greeting. Lua code reads the value by using that exact key with shroudforge.settings.get. A group makes the setting visible in the Modloader.

The canonical extended manifest schema defines the structure and data types. Use the Mod Settings editor to edit a sample and preview how its settings appear in the Modloader. The versioned schema catalogue lists the published manifest schemas.