Tested with: KSA Version 2026.10.19.5638
<System> is the root element of a system file. One file per star system, and each one adds an entry to the system picker on the main menu.
A system file is loaded by listing it under systems in your mod.toml. Stock ones live in Content\Core: SolSystem.xml, SolSystemDense.xml, EarthSystem.xml, EarthOnly.xml, SolSystemInterstellar.xml and EarthOnlyInterstellar.xml. EarthOnly.xml is the smallest and the best one to read first.
This page is the element reference. For a walkthrough of building a system, see System.
A system file gets parsed twice, by two different classes. The first pass builds the entry in the system picker and works out what the system needs. The second pass builds the system when you actually select it.
That is why a couple of elements below look redundant, and why two near-identical vehicle elements exist.
Id<System Id="Test">
The internal name. It does not show in the picker, but it is what the loading screen prints ("Loading Test") and what a craft's meta.toml refers to under systems.
If two system files share an Id, the game loads whichever file name sorts first, regardless of which one the player picked.
<DisplayName Value="Earth Only" />
The text shown in the picker. Purely cosmetic, duplicates are fine.
<GalacticPlane>
<RightAscension Degrees="192.86" />
<Declination Degrees="27.13" />
</GalacticPlane>
Orients the background star field relative to the system. Optional; leave it out for the default orientation.
The values above are the real galactic north pole, which is what stock uses.
<InterstellarGas AtomsPerCm3="0.1" />
Hydrogen density between the stars, in atoms per cubic centimetre. Magnetic scoop parts collect it (see Interstellar Engines). Optional, default 0.1. New in 2026.10.7.5541.
<CosmicRays MilliSievertsPerDay="1.8" />
Background radiation dose. Optional, default 1.8. See Magnetospheres.
<VesselTextures Size="184 MB">
<Texture Width="4096" Height="4096" Count="12" Size="181 MB" />
<Texture Width="512" Height="512" Count="3" Size="3 MB" />
</VesselTextures>
Three of these exist: <VesselTextures>, <TerrainTextures> and <UnscaledTextures>. They are cached VRAM estimates used to warn a player before they pick a system their card cannot hold.
Each <Texture> records a resolution and how many textures of that size the system uses. Count is that number, and it is what the estimate is actually built from.
You do not write these by hand. Run textures summarize in the in-game console once your system loads and paste the output. Stock files carry a comment saying exactly that. A missing or rough block does not stop anything working, it just mis-reports the estimate.
<LoadFromLibrary Id="Sol"/>
<LoadFromLibrary Id="Earth" Parent="Sol" HomeBody="true"/>
<LoadFromLibrary Id="Luna" Parent="Earth"/>
Pulls a celestial body defined in an <Assets> file into this system.
| Attribute | Meaning |
|---|---|
Id |
The body's id, as defined by a <StellarBody>, <AtmosphericBody>, <PlanetaryBody> and so on in an assets file. |
Parent |
The body it orbits. Omit on the root body only. |
HomeBody |
true on the one body the game treats as home. |
The hierarchy declared here wins over anything in the body's own definition, which is what lets the same body be reused across systems in different arrangements.
LoadFromLibrary handles celestial bodies only. A craft added this way is silently dropped.
<LoadVehicleFromLibrary Id="Gemini7" Parent="Earth">
<SituationRef InstanceOf="Gemini7StartingSituation"/>
<Body2Cce X="1.815" Y="0.0091" Z="1.9134" />
<BodyRates X="0" Y="0.0011657209075534262" Z="0" />
</LoadVehicleFromLibrary>
Places a craft in the system. Id matches the name in that craft's meta.toml under Content\Core\defaultvehicles\.
| Child | Meaning |
|---|---|
<SituationRef InstanceOf="..."/> |
The <Situation> holding the starting orbit or launch site. |
<Body2Cce> |
Starting orientation. Optional. |
<BodyRates> |
Starting roll, pitch and yaw rate. Optional. |
<WindSound SoundId="..."/> |
Optional. |
Those four plus the Parent attribute are everything this element reads. Anything else is silently dropped.
Stock EarthOnly.xml still carries <Color> and <SoundEvent> children here as leftovers; they do nothing.
Full walkthrough on Adding a vehicle.
The other vehicle element, read by the first pass rather than the second. It is a whitelist saying "this system needs that craft".
The whitelist matters only if you declare a <Vehicle> inside an <Assets> file. When a system is selected, any celestial or vehicle template sitting in an assets file that the chosen system does not list gets skipped instead of registered, which is how an Earth-only start avoids loading Jupiter's textures.
Stock declares no <Vehicle> elements in assets files at all, which is why no stock system file contains a LoadVesselFromLibrary. If you follow the defaultvehicles\ route you never need it.
Instead of referencing with <LoadFromLibrary>, a body can be written out in full, using exactly the same syntax as in an <Assets> file:
<StellarBody>, <Barycenter>, <AtmosphericBody>, <PlanetaryBody>, <TerrestrialBody>, <MinorBody>, <Asteroid>, <Comet>, <PeriodicComet>, <InterstellarComet>
For more than one star, see Multiple Star Systems.
A body written inline is local to that system. Other files cannot reference it. See
<Assets> Tag for what goes inside each one.
This is Content\Core\EarthOnly.xml, abridged:
<?xml version="1.0" encoding="utf-8"?>
<System Id="Test">
<DisplayName Value="Earth Only" />
<GalacticPlane>
<RightAscension Degrees="192.86" />
<Declination Degrees="27.13" />
</GalacticPlane>
<!-- generated and cached using the 'textures summarize' in game and used for VRAM estimates -->
<VesselTextures Size="184 MB">
<Texture Width="4096" Height="4096" Count="12" Size="181 MB" />
<Texture Width="512" Height="512" Count="3" Size="3 MB" />
</VesselTextures>
<TerrainTextures Size="0.6 GB">
<Texture Width="16384" Height="8192" Count="2" Size="171 MB" />
<Texture Width="8192" Height="4096" Count="2" Size="256 MB" />
</TerrainTextures>
<UnscaledTextures Size="8 MB">
<Texture Width="1024" Height="1024" Count="1" Size="4 MB" />
</UnscaledTextures>
<LoadFromLibrary Id="Sol"/>
<LoadFromLibrary Id="Earth" Parent="Sol" HomeBody="true"/>
<LoadVehicleFromLibrary Id="Gemini7" Parent="Earth">
<SituationRef InstanceOf="Gemini7StartingSituation"/>
<Body2Cce X="1.815" Y="0.0091" Z="1.9134" />
<BodyRates X="0" Y="0.0011657209075534262" Z="0" />
</LoadVehicleFromLibrary>
<LoadVehicleFromLibrary Id="Banjo" Parent="Earth">
<SituationRef InstanceOf="BanjoStartingSituation"/>
</LoadVehicleFromLibrary>
</System>