In the Game

Mod Settings File

Everything here can be changed from the settings panel in game, and this page is for the times you would rather edit a file. It is a KSP ConfigNode, which has one quirk worth knowing about.

Where it lives

GameData/BoundlessMissions/PluginData/settings.cfg

The node inside it is named GeneKerman, which is the add-on’s source project name rather than the folder it installs to. A node with any other name is ignored and the add-on falls back to its defaults, so do not rename it to match the folder.

The file does not ship with a release. It is written the first time the add-on saves settings, which means an update never overwrites your choices.

Example

settings.cfg

GeneKerman
{
    useOfficialServer = true
    serverProtocol = http
    serverHost = localhost
    serverPort = 5022
    enableNotifications = true
    enableCheckpointPhotos = true
    enableDataGathering = true
    enableWebUi = false
    enableEmergencyFreeze = true
    emergencyRationDays = 3
    enablePartSubstitution = true
    enableTextureTransfer = true
    enableFuelConfigTransfer = true
    marketplaceProtocol = https
    marketplaceAddress = example.com/marketplace
}

Why every URL is split in two

In ConfigNode format, // starts a comment. A full URL written as one value would be silently truncated at its double slash, which is a bug that is very hard to see and very easy to reintroduce. So protocol, host and port are always stored as separate keys and recombined by the add-on.

Server

`useOfficialServer` bool, default true	Use the official Boundless Missions server. When false, the host, port and protocol below are used instead. The custom address is remembered either way, so switching back and forth does not mean retyping it.
`serverHost` string, default localhost	Hostname or IP of the machine running the API. Only used when useOfficialServer is false.
`serverPort` int, default 5022	Port the API listens on.
`serverProtocol` http or https, default http	Protocol used to reach the API.

Interface and privacy

`enableDataGathering` bool, default true	The master opt-out. While false the add-on transmits nothing and runs inert until you switch it back on from the in-game panel. This is the setting behind KSP's add-on rules on data collection.
`enableNotifications` bool, default true	Whether in-game notification popups are shown.
`enableWebUi` bool, default false	Open the interface in your browser instead of the sidebar drawn over the game. Absent means off, so an update never moves an existing install to a different interface.
`enableCheckpointPhotos` bool, default true	Whether milestone photo prompts fire on a rendezvous, flyby or asteroid encounter. Currently dormant because the feature is switched off server side, so the add-on holds it off too and hides its switch. Your value is still read and written and takes effect again when the feature returns.

Craft transfer

All three of these are on by default, and switching one off does not make the add-on blind to the problem it solves. Each one still scans and still reports; it just stops changing anything, offering advice instead. See Sharing Craft.

`enablePartSubstitution` bool, default true	Swap a part a received craft asks for but this install does not have, where a provably identical equivalent exists. Only engages on a craft that would otherwise refuse to load.
`enableTextureTransfer` bool, default true	Carry a craft's paint job (Textures Unlimited or Reforged Materials Redux) and reconcile it against what is installed here on arrival.
`enableFuelConfigTransfer` bool, default true	Carry a craft's RealFuels tank and engine configuration, and either check it or strip it back to local fuels depending on whether RealFuels is installed here.

Life support and rescues

`enableEmergencyFreeze` bool, default true	Freeze the crew of a rescue wreck out of the life support simulation while they wait, and thaw them with a clean slate on arrival.
`emergencyRationDays` int, default 3	How many days of the rescuer's own resources to stow aboard a wreck on thaw. Zero is allowed; a negative value is clamped to zero rather than sizing a ration kit backwards.

Marketplace

`marketplaceProtocol` http or https, default https	Protocol for the marketplace website opened from the Market panel.
`marketplaceAddress` string	Optional override for the marketplace website, without the scheme. Replaces an older single-value key that could not survive ConfigNode comment parsing; a leftover of that key is read once and migrated.

The other files in that folder

`session.token` the active session	The signed token for the server you are currently pointed at. Deleting it returns this install to its unlinked state, ready for a new code, and affects nothing else.
`sessions.cfg` parked sessions	A token per server address, so moving between the official server and one you run yourself does not mean linking again each time.
`consent.cfg` privacy opt-in	Kept separate from settings.cfg on purpose. It is re-read when it changes on disk, so an edit takes effect without a restart.
`device.id` random identifier	Written once, sent with every request, and bound to your account. Not a MAC address and not derived from your hardware.
`favorites.cfg` starred players	The players you have starred in the picker lists.
`trait_repairs.cfg` roster repair records	The original crew professions the roster repair tool overwrote, kept so they can be handed back when the defining mod is reinstalled.

None of these ship with a release

Every file listed here is created by the add-on at runtime, so upgrading never overwrites your settings, your session or your starred players.

PreviousLife Support NextBrowser Interface