Update Settings

Stable

Updating settings replaces the Daemon's stored path configuration. Each field in the request is written if non-empty, or deleted from the store if empty or absent. The stored values after the write are returned.

Property	Value
Applies to	Daemon
Trigger	User submits new path values in the settings form
Preconditions	None

Inputs

dcsWorkingDir : String, optional. Path to the DCS World saved games directory. If empty or absent, the stored value is deleted.

dcsInstallDir : String, optional. Path to the DCS World installation directory. If empty or absent, the stored value is deleted.

dropzoneModsDir : String, optional. Path to the DCS Dropzone mods directory. If empty or absent, the stored value is deleted.

Assertions

Assertion	Status
None — any combination of values (including all empty) is accepted

Outputs

SettingsData : The raw stored values after the write. Fields that were cleared are absent from the response. No defaults are applied and no environment variable expansion is performed.

Effects

Effect	Status
Each non-empty field value is persisted to the key-value store	Implemented
Each empty or absent field deletes the corresponding stored key	Implemented

Warning: This operation is a full replace. Omitting a field has the same effect as passing an empty string — the previous value is erased, not preserved. Callers must include all three fields to retain existing values.

Behavior

mermaid

flowchart TD
    Start([setAll dcsWorkingDir dcsInstallDir dropzoneModsDir]) --> WD{dcsWorkingDir<br/>non-empty?}

    WD -- Yes --> SaveWD[Save dcsWorkingDir]
    WD -- No --> DelWD[Delete dcsWorkingDir]

    SaveWD --> ID{dcsInstallDir<br/>non-empty?}
    DelWD --> ID

    ID -- Yes --> SaveID[Save dcsInstallDir]
    ID -- No --> DelID[Delete dcsInstallDir]

    SaveID --> MD{dropzoneModsDir<br/>non-empty?}
    DelID --> MD

    MD -- Yes --> SaveMD[Save dropzoneModsDir]
    MD -- No --> DelMD[Delete dropzoneModsDir]

    SaveMD --> Return[Return stored values]
    DelMD --> Return

    Return --> Done([SettingsData with raw stored values])

    style Done fill:#4ade80,color:#000

Update Settings ​

Inputs ​

Assertions ​

Outputs ​

Effects ​

Behavior ​