Icarus Dedicated Server Configuration Guide
An Icarus dedicated server is configured through a single file, ServerSettings.ini, plus a small set of command-line launch parameters. This guide lists every supported setting, where the file lives, and how the server chooses which prospect to run on startup.
Configuration Overview
- Config file:
ServerSettings.ini(one file, one section) - Section header:
[/Script/Icarus.DedicatedServerSettings] - Default location:
Saved\Config\WindowsServer\ServerSettings.iniunder the server's save directory - Server name: set with the
-SteamServerNamelaunch parameter, not in the file (the in-fileSessionNamecurrently has no effect)
The ServerSettings.ini File
This is the complete default file shipped with the official RocketWerkz dedicated server. There is only one section and no other config files such as a separate prospect or outpost file.
[/Script/Icarus.DedicatedServerSettings]
SessionName=
JoinPassword=
MaxPlayers=
AdminPassword=
ShutdownIfNotJoinedFor=300.000000
ShutdownIfEmptyFor=300.000000
AllowNonAdminsToLaunchProspects=True
AllowNonAdminsToDeleteProspects=False
LoadProspect=
CreateProspect=
ResumeProspect=True
LastProspectName=
Settings Reference
| Setting | Description | Default |
|---|---|---|
SessionName | Intended to set the name shown in the server browser. This currently does nothing; use the -SteamServerName launch parameter instead. | empty |
JoinPassword | Password required to join. Leave empty for a public, no-password server. | empty |
MaxPlayers | Maximum number of players that can connect. Minimum 1, maximum 8. | 8 |
AdminPassword | Password used to authenticate as admin. If left empty, the first player to join is granted admin. | empty |
ShutdownIfNotJoinedFor | Seconds to wait for the first player after startup before shutting down. Set to a negative value (for example -1) so a hosted server stays running indefinitely. | 300 |
ShutdownIfEmptyFor | Seconds the server stays up after the last player leaves before shutting down. Use a negative value to keep it running. | 300 |
AllowNonAdminsToLaunchProspects | Whether non-admin players may create or load prospects. | True |
AllowNonAdminsToDeleteProspects | Whether non-admin players may delete prospects. | False |
LoadProspect | Name of an existing saved prospect to load on startup. | empty |
CreateProspect | Create and launch a new prospect on startup (format below). | empty |
ResumeProspect | If True, automatically resume the last prospect (named in LastProspectName) on startup. | True |
LastProspectName | Name of the most recent prospect. The server writes this itself; ResumeProspect uses it. | empty |
Launch Parameters
The server name and network ports are passed on the command line when you start IcarusServer.exe, not stored in the config file.
| Parameter | Description |
|---|---|
-SteamServerName="My Server" | Sets the server name shown in the in-game browser (64 character limit). This is the working replacement for SessionName. |
-Port=17777 | Game port the server listens on. |
-QueryPort=27015 | Steam query port used by the server browser. |
-Log | Opens a log console window. |
-UserDir=[path] | Changes the base directory used for the Saved/ folder (config, saves, logs). Useful for running multiple servers. |
-MULTIHOME=[IP] | Binds the server to a specific local IP address. |
A typical Windows launch command looks like this:
IcarusServer.exe -SteamServerName="My Icarus Server" -Port=17777 -QueryPort=27015 -LogHow the Server Picks a Prospect
Icarus is mission-based. A "prospect" is a session on a chosen map and difficulty. On startup the server evaluates the prospect settings in this order: LoadProspect, then ResumeProspect, then CreateProspect. If none of them apply, the server idles in a waiting state and admins can start a prospect through RCON.
LoadProspect
Loads a previously saved prospect by its save name.
# In ServerSettings.ini
LoadProspect=MySavedProspect
# Or on the command line
-LoadProspect=MySavedProspectResumeProspect
Resumes the prospect named in LastProspectName. This is on by default, so a restarted server normally continues the session it was last running.
ResumeProspect=TrueCreateProspect
Creates and launches a new prospect. The value is four space-separated fields:
CreateProspect=<ProspectType> <Difficulty> <Hardcore> <SaveName>| Field | Meaning |
|---|---|
ProspectType | The internal prospect/map name (for example Tier1_Forest_Recon_0). |
Difficulty | A number from 1 to 4 (1 = easiest, 4 = hardest). |
Hardcore | true or false. When true, players cannot respawn. |
SaveName | The save name for this prospect. Required for outposts; optional otherwise (a random name is generated if omitted). |
Example, on the command line:
-CreateProspect="Tier1_Forest_Recon_0 3 false MyProspect01"Applying Changes
- Stop the server before editing
ServerSettings.ini. - Save the file as UTF-8 with no syntax errors and keep the exact section header.
- Restart the server. Config changes are read at startup, not live.
- Keep a backup of the file and of your prospect saves before making larger changes.
Troubleshooting
My server name is not showing in the browser
Set the name with the -SteamServerName launch parameter. The SessionName key in the file currently has no effect.
The server shuts down shortly after starting with nobody on it
That is ShutdownIfNotJoinedFor and ShutdownIfEmptyFor at their 300-second default. Set both to a negative value (for example -1) so a hosted server stays up.
Settings are not taking effect
Confirm you edited the file at Saved\Config\WindowsServer\ServerSettings.ini, kept the [/Script/Icarus.DedicatedServerSettings] header, saved as UTF-8, and restarted the server.
The server does not load my world on restart
Check ResumeProspect=True and that LastProspectName matches an existing save, or set LoadProspect to the save name explicitly.
Managed configuration: Supercraft runs Icarus dedicated servers with the config and launch parameters above pre-set, so prospects load on restart and the server name shows correctly in the browser without manual file editing.
Looking for managed Icarus server hosting? Supercraft runs Icarus dedicated servers with daily backups, instant setup, and 5 region options. Plans from $5.99/mo.