App Data

App Data & File Locations

Data Directory

Platform	Location
Windows	%APPDATA%\DVModManager\
Linux	$XDG_CONFIG_HOME/DVModManager/ (usually ~/.config/DVModManager/)

settings.json always lives here. Everything else is stored under the StoragePath setting, which defaults to this same directory. Change it via Settings if needed.

Directory Structure

DVModManager/
  settings.json
  logs/
    dvmm-YYYY-MM-DD.log
  downloads/
    <ModId>/
      <version>.zip
  versions/
    <ModId>/
      versions.json
      1.0.0.zip
      1.1.0.zip
  profiles/
    Default.json
    MyProfile.json

Log Files

One log file per day: dvmm-YYYY-MM-DD.log

[HH:mm:ss.fff] [LEVEL] [Category] Message

Levels: Debug, Information, Warning, Error

Version Cache

versions/ stores ZIP archives of previous mod versions. Each mod gets a subdirectory with a versions.json manifest and the archived zips. See Version Archive & Rollback.

Profile Files

Each profile is a JSON file in profiles/. File names are sanitized from the profile name. See Profiles Overview.

Companion Mod Files

DVModProfiles keeps its own data separately from the desktop app. It reads settings.json from the data directory above to find the active profile and the StoragePath, then follows that to the profiles/ directory. Under Proton, it looks for the Linux data directory through Wine's Z: drive.

In the Game's Mods Folder

Derail Valley/
  Mods/
    DVModProfiles/
      Settings.xml
      manager-sync.json
      profiles/
        Default.json
        MyProfile.json
      associations.json

File	Purpose
Settings.xml	The mod's own UMM settings (the Steam Cloud toggle)
manager-sync.json	Records what this machine last agreed with Steam Cloud on for each DV Mod Manager profile for conflict resolution.
profiles/<ProfileName>.json	Per-profile mod settings. See Mod Settings Sync. Only written here when Steam Cloud is off or unavailable.

In Steam Cloud

When Steam Cloud sync is on and available, the mod stores files in Derail Valley's Steam Cloud quota under a dvmodprofiles/ prefix instead of the profiles/ folder above:

Cloud File	Purpose
dvmodprofiles/profiles/<ProfileName>.json	Per-profile mod settings (same content as the local profiles/ files)
dvmodprofiles/manager-profiles/<ProfileName>.json	Copies of your DV Mod Manager profile files, synced two-way with the profiles/ directory in the data directory

Toggling the Steam Cloud setting copies existing per-profile settings between the local folder and the cloud, so nothing is lost when switching.

In Other Mods' Folders

When a profile's settings are restored, the mod overwrites Mods/<ModId>/Settings.xml for each mod that has saved settings under that profile.

In Save Games

The profile associated with a save is stored in the save's own session data under the key DVModProfiles.Profile, so it travels with the save file. See Save Associations.

See Also

• Troubleshooting
• DVModProfiles Overview