# StarRupture DSSettings.txt Configuration Guide (/docs/starrupture/dssettings-configuration)



The `DSSettings.txt` file controls your StarRupture server's session and save behavior. This guide covers every setting and how to configure them.

Locating the DSSettings.txt File [#locating-the-dssettingstxt-file]

<div className="fd-steps">
  <div className="fd-step">
    Open Your Server Files [#1-open-your-server-files]

    Access the XGamingServer Panel and go to `Files` in the sidebar.
  </div>

  <div className="fd-step">
    Find DSSettings.txt [#2-find-dssettingstxt]

    The file is located in the server root directory alongside the server executable. If it doesn't exist, you can create it.
  </div>
</div>

Configuration Reference [#configuration-reference]

The file uses JSON format. Here is a complete example:

```json
{
  "SessionName": "MyWorld",
  "SaveGameInterval": "300",
  "StartNewGame": "false",
  "LoadSavedGame": "true",
  "SaveGameName": "AutoSave0.sav"
}
```

Settings Explained [#settings-explained]

| Setting            | Default         | Description                                                                                       |
| ------------------ | --------------- | ------------------------------------------------------------------------------------------------- |
| `SessionName`      | —               | Name of the save folder (max 20 characters). Must match the folder name under `Saved/SaveGames/`. |
| `SaveGameInterval` | `300`           | Auto-save frequency in seconds. `300` = every 5 minutes.                                          |
| `StartNewGame`     | `false`         | Set to `true` to generate a brand new world on next startup.                                      |
| `LoadSavedGame`    | `true`          | Set to `true` to load an existing save on startup.                                                |
| `SaveGameName`     | `AutoSave0.sav` | Which save file to load from the session folder.                                                  |

> ⚠️ **Warning:** `StartNewGame` and `LoadSavedGame` are mutually exclusive. Never set both to `true` at the same time. If `StartNewGame` is `true`, it will generate a new world and can overwrite your existing save.

Common Configurations [#common-configurations]

Loading an Existing Save [#loading-an-existing-save]

```json
{
  "SessionName": "MyWorld",
  "SaveGameInterval": "300",
  "StartNewGame": "false",
  "LoadSavedGame": "true",
  "SaveGameName": "AutoSave0.sav"
}
```

Creating a New World [#creating-a-new-world]

```json
{
  "SessionName": "NewWorld",
  "SaveGameInterval": "300",
  "StartNewGame": "true",
  "LoadSavedGame": "false",
  "SaveGameName": "AutoSave0.sav"
}
```

> ⚠️ **Warning:** After your new world generates, change `StartNewGame` back to `false` and `LoadSavedGame` to `true`, then restart. Otherwise the server will create a new world every time it restarts.

Adjusting Auto-Save Frequency [#adjusting-auto-save-frequency]

Change `SaveGameInterval` to control how often the server saves:

| Value | Interval                  |
| ----- | ------------------------- |
| `60`  | Every 1 minute            |
| `300` | Every 5 minutes (default) |
| `600` | Every 10 minutes          |
| `900` | Every 15 minutes          |

Lower intervals mean less progress is lost on a crash but can cause brief lag spikes during saves, especially on large worlds.

> 💡 **Tip:** Most settings can also be configured through the `Startup` page in the XGamingServer Panel without editing the file directly.