Tested with: KSA Version 2026.10.19.5638
Since 2026.10.7.5541 a system can hold more than one star: stars placed at real distances from Sol, binary pairs orbiting a shared centre of mass, and companions orbiting a pair. Core's SolSystemInterstellar.xml and EarthOnlyInterstellar.xml use all of it, and InterstellarAstronomicals.xml holds the definitions. Those three files are the best reference.
This page assumes you already know how to build a single-star system. See System and <Assets> Tag first.
| Element | What it is |
|---|---|
<StellarBody> with no Parent |
A star fixed at a <Position>. Sol is one, at the origin. |
<Barycenter> |
An invisible point at a <Position> that stars can orbit. It has no radius and takes its mass from its stars. |
<StellarBody> with a Parent |
A star on an <Orbit> around a barycenter or another star. |
Every body without a Parent in the system file starts its own tree, so a system can have several roots. The first <StellarBody> listed becomes the system's primary star. List Sol (or your main star) first.
A star with no parent sits at its <Position>, in ecliptic coordinates with Sol at the origin. Ly is the natural unit here (see Units).
<StellarBody Id="TauCeti">
<MeanRadius Km="551690" />
<Mass Suns="0.8" />
<Color R="1" G="0.89" B="0.8" />
<Sunlight R="9" G="8.3" B="7.6" />
<Position>
<X Ly="10.2932272" />
<Y Ly="3.308481" />
<Z Ly="-4.999418" />
</Position>
</StellarBody>
Planets then use it as a Parent exactly as they would Sol.
A fixed star's sphere of influence is unlimited by default. Space between systems is divided between whole systems, so a vessel is handed from one star to the next by distance. Set <SphereOfInfluence> to limit it.
A pair orbits a <Barycenter>. The barycenter has only an Id and a <Position>:
<Barycenter Id="AlphaCentauri">
<Position>
<X Ly="-1.6240716" />
<Y Ly="-2.7548531" />
<Z Ly="-2.9400738" />
</Position>
</Barycenter>
Both stars then author the same relative orbit, the separation of the pair, 180 degrees apart, with <Barycentric Value="true" />:
<StellarBody Id="AlphaCentauriA" Parent="AlphaCentauri">
<Orbit DefinitionFrame="Ecliptic">
<SemiMajorAxis Au="23.5" />
<Inclination Degrees="0" />
<Eccentricity Value="0.518" />
<LongitudeOfAscendingNode Degrees="0" />
<ArgumentOfPeriapsis Degrees="180" />
<TimeAtPeriapsis Days="0" />
<Barycentric Value="true" />
</Orbit>
<MeanRadius Km="851928" />
<Mass Suns="1.0788" />
<SphereOfInfluence Au="3" />
<Color R="1" G="0.97" B="0.9" />
<Sunlight R="9.2" G="9.1" B="8.7" />
</StellarBody>
<StellarBody Id="AlphaCentauriB" Parent="AlphaCentauri">
<Orbit DefinitionFrame="Ecliptic">
<SemiMajorAxis Au="23.5" />
<!-- same as A, except: -->
<ArgumentOfPeriapsis Degrees="0" />
<Barycentric Value="true" />
</Orbit>
<Mass Suns="0.9092" />
<SphereOfInfluence Au="3" />
<!-- ... -->
</StellarBody>
What Barycentric does for you:
Barycentric set. You never write it yourself, and changing a star's mass keeps the pair consistent.(total mass − own mass) / total mass. The heavier star ends up closer to the barycenter.Give both stars a <SphereOfInfluence>. Without one, an orbiting star's sphere of influence is computed from its orbit (0.9431 × a × (m/M)^0.4), which for a close pair can be small enough that a vessel near one star is captured by the other the moment it burns. Core uses 3 AU for both Alpha Centauri stars for that reason.
Proxima orbits the Alpha Centauri barycenter from far out. It is not part of the pair's mass, so it does not set Barycentric. It sets <TwoBody Value="true" />, which moves it under its parent's mass plus its own:
<StellarBody Id="ProximaCentauri" Parent="AlphaCentauri">
<Orbit DefinitionFrame="Ecliptic">
<SemiMajorAxis Au="8600" />
<Eccentricity Value="0.5" />
<!-- ... -->
<TwoBody Value="true" />
</Orbit>
<MeanRadius Km="107412" />
<Mass Suns="0.1221" />
<Color R="1" G="0.6" B="0.5" />
<Sunlight R="9" G="5.8" B="3.4" />
<SpaceWeather QuietMilliSievertsPerDay="3" WindPressureNanoPascals="0.4" />
</StellarBody>
These three go inside <Orbit>. They are new in 2026.10.7.5541 and work on any orbit, not just stars. If more than one is set, the first in this table wins.
| Element | Central mass the orbit uses |
|---|---|
<CentralMass Suns="..."/> |
Exactly the value given. For a body whose orbit is set by more than its parent and itself. Takes any mass unit. |
<Barycentric Value="true"/> |
Worked out from the pair, and the semi-major axis is scaled to this body's share. Use on both members of a pair. |
<TwoBody Value="true"/> |
Parent mass plus this body's mass. |
| none | Parent mass only, as before. |
On <StellarBody>:
| Element | Default | What it does |
|---|---|---|
<Position> |
origin | Fixed position, for a star with no parent. X, Y, Z each take a distance unit. |
<Orbit> |
none | Orbit around the parent, for a star with a parent. |
<SphereOfInfluence> |
unlimited (fixed) / computed (orbiting) | Override the sphere of influence. |
<StarMaskRadius> |
2% of the distance from Sol | Background catalogue stars inside this radius are hidden, so the star does not draw twice. See Star Binaries. |
<SpaceWeather QuietMilliSievertsPerDay="0.3" WindPressureNanoPascals="2"/> |
values shown | Radiation dose and stellar wind pressure at 1 AU. |
On <System>:
| Element | Default | What it does |
|---|---|---|
<InterstellarGas AtomsPerCm3="0.1"/> |
0.1 | Hydrogen density between the stars, which magnetic scoop parts collect. |
<CosmicRays MilliSievertsPerDay="1.8"/> |
1.8 | Background radiation dose. |
Load every root and every star the same way you load planets:
<LoadFromLibrary Id="Sol"/>
<LoadFromLibrary Id="Earth" Parent="Sol" HomeBody="true"/>
<LoadFromLibrary Id="AlphaCentauri"/>
<LoadFromLibrary Id="AlphaCentauriA" Parent="AlphaCentauri"/>
<LoadFromLibrary Id="AlphaCentauriB" Parent="AlphaCentauri"/>
<LoadFromLibrary Id="ProximaCentauri" Parent="AlphaCentauri"/>
<LoadFromLibrary Id="TauCeti"/>
Core's interstellar definitions are in InterstellarAstronomicals.xml, listed in Core's mod.toml, so a mod can load AlphaCentauri and friends into its own system without copying them.
starmask in the console lists which catalogue stars each star body hides, with the angular separation and distance ratio. If a star you placed is not hiding its own catalogue entry, the position is off.Barycentric on only one star of a pair. The barycenter's mass then comes from that star alone.Barycentric, write the separation of the pair. The game does the split.Parent. With a parent, <Position> is ignored and the star needs an <Orbit>.<SphereOfInfluence> on a close pair.