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.

Modloader settings

From Shroudforge
Revision as of 21:14, 18 November 2026 by Bonsaibauer (talk | contribs) (Publish English migration guide)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


This guide covers settings for ShroudForge itself. It is separate from the player-facing settings that a mod declares in Extended.mod.json. The documented preferences are stored in shroudforge/config/modloader-config.json beside the game installation. The Modloader's Settings page is the easiest way to change them because it validates and saves each value for you.

Find and edit the configuration

The file is inside the shroudforge/config folder beside the Enshrouded executable. For example, if the game is installed in D:\Games\Enshrouded, the file is D:\Games\Enshrouded\shroudforge\config\modloader-config.json.

Prefer the Modloader's Settings page for ordinary changes. If you edit the JSON file yourself, close the game and Modloader first, make a backup, preserve the rest of the file, and keep the JSON valid. JSON does not allow comments or a comma after the final item. The configuration contains internal state as well as user preferences, so do not replace the entire file with a short example.

Settings use JSON values. A boolean is true or false. A string is in double quotes. A path can be a string or null. Use null to restore the automatic path for a storage location.

General settings

Compact Modloader layout: general.compactMode

This boolean controls whether the Modloader uses a denser layout. The shipped defaults leave it unset, which keeps the standard layout. Set it to true to use the compact layout or false to keep the standard layout.

{
  "general": {
    "compactMode": true
  }
}

Interface language: general.locale

This string selects the language used by the Modloader interface. The shipped default is en-GB. Choose a language in the Settings page when possible. The schema accepts language-tag-shaped values matching ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$, but a value that matches the pattern is not necessarily a language supplied by the installed Modloader.

{
  "general": {
    "locale": "de"
  }
}

Fallback name for notices: general.messageNameFallback

This string is the name used in a notice when automatic character-name detection cannot supply one. It is also the name used when general.usernameMode is set to manual. The shipped default is Flameborn. The value must contain 1–40 characters. The Settings page trims surrounding whitespace and uses Flameborn if the field is left empty.

{
  "general": {
    "messageNameFallback": "Flameborn"
  }
}

Reduce motion: general.reducedMotion

This boolean reduces interface motion and transition effects. The shipped defaults leave the setting unset, so the normal interface motion is used. Set it to true to reduce motion or false to keep normal transitions.

Choose how notices get a player name: general.usernameMode

This string accepts "auto" or "manual". The shipped default is "auto".

  • "auto" uses the local character name captured by the current game process. ShroudForge captures it when a valid character is first available and again when the character selection or name changes. If capture fails, notices use general.messageNameFallback. A name cached by a previous game process is not restored.
  • "manual" always uses general.messageNameFallback.

This affects names shown in notices. It does not identify remote players or change a mod's own fallback text.

{
  "general": {
    "usernameMode": "auto"
  }
}

Logging

Minimum saved log level: logging.minimumLevel

This string sets the lowest severity that ShroudForge writes to log files. The accepted values, from most detailed to most restrictive, are TRACE, DEBUG, INFO, WARN, and ERROR. The shipped default is INFO. Entries below the selected level are not saved to the regular log file.

The Debug Console has its own display filter. Changing that filter only changes which entries are shown in the console. It does not change what the log file saves. The saved-file threshold is the setting documented here.

{
  "logging": {
    "minimumLevel": "INFO"
  }
}

Export functions

Enable mod export functions: exports.enabled

This boolean enables or disables mod export functions. The shipped default is true. Set it to false to disable those functions for the installation.

{
  "exports": {
    "enabled": true
  }
}

This loader preference is different from the export capability requested by an individual mod in mod.json. A mod still has to declare and use the capability it needs. See Modding: Capabilities.

Module settings

The modules value is an object with separate sections for the built-in modules. There is no modules.modules option or shared module list. Each section is named for its owner. The shipped defaults currently contain these sections:

Section What it configures
modDetection Mod package discovery and how unknown manifest fields are handled.
dllManager DLL discovery and compatibility profiles.
debugConsole Debug Console behavior, including log source, display filter, refresh rate, and shortcut.
worldEditor World Editor enablement, refresh rate, and shortcut.
modloaderUi Modloader interface behavior, including its starting page, remote target, and shortcut.
wiki In-Modloader Wiki availability, paging, and refresh interval.
network Network module availability and dedicated-server or client allowlist settings.
runtimeDiagnostics Runtime diagnostic collection, job selection, timing, and slow-callback threshold.
gameProfileDiscovery Automatic discovery of game profiles.
updates System and mod update behavior and recycle-bin retention.

The exact fields and allowed values belong to the schema. Some saved fields are runtime state rather than preferences. For example, window positions and diagnostic request or session values are managed by ShroudForge. Do not copy those values into a mod's extended.mod.json or treat them as mod settings.

{
  "modules": {
    "debugConsole": {
      "enabled": true,
      "defaultSource": "game",
      "levelFilter": "ALL"
    },
    "worldEditor": {
      "enabled": true
    }
  }
}

This is a partial example. Keep other module sections and settings already present in the configuration.

Storage paths

Reusable cache: paths.cache

Stores reusable cached data. The default value is null, which resolves to <game folder>\shroudforge\cache.

Mod export destination: paths.exports

Folder where files produced by mod export functions are written. The default value is null, which resolves to <game folder>\shroudforge\exports.

Log files: paths.logs

Folder for ShroudForge and mod log files. The client and Dedicated Server write separate log files there. The default value is null, which resolves to <game folder>\shroudforge\logs.

Installed mod packages: paths.mods

Folder where ShroudForge searches for installed mod packages. The default value is null, which resolves to <game folder>\mods. This is a sibling of the shroudforge data folder.

Runtime files and profiles: paths.runtime

Folder for Lua and native runtime data and detected game profiles. The default value is null, which resolves to <game folder>\shroudforge\runtime.

Persistent loader state: paths.state

Folder for persistent Modloader state, including saved enablement and runtime status. The default value is null, which resolves to <game folder>\shroudforge.

Interface data: paths.ui

Folder for persistent interface data and the Modloader WebView profile. The default value is null, which resolves to <game folder>\shroudforge\ui.

Downloaded updates: paths.updates

Folder for downloaded or staged updates. The default value is null, which resolves to <game folder>\shroudforge\updates.

All eight path fields accept a non-empty string or null. With null, ShroudForge chooses the path described above. An absolute path is kept as the selected location. A relative path is resolved from the game folder at startup, then stored as an absolute path. For example, "paths": { "cache": "ShroudForgeCache" } selects a folder named ShroudForgeCache beside the game executable. The selected installation and its client or server process must be able to read and write the chosen folders.

To restore one path to its default, set its value back to null. This does not move data from the old folder. Copy files yourself only when a feature needs existing data at the new location.

Where the values come from

The shipped defaults and accepted fields are defined by the loader configuration schema and default configuration. Use the Modloader Settings page for regular changes. If a field is not described here, check the matching schema instead of guessing its name or value.