Tested with: KSA Version 2026.10.19.5638
Since the 2026.10 builds, bodies can have a magnetic field with radiation belts and aurorae, stars emit radiation and a stellar wind, and there is a cosmic ray background. Together these give the dose rate the HUD shows for a vessel and for its orbit.
At the moment radiation is information only: it drives the dose gauges and the map overlay, and nothing yet harms crew or parts. That may change, so give your bodies sensible values now.
Stock magnetospheres for Mercury, Earth, Jupiter, Saturn, Uranus and Neptune are in
Content\Core\Astronomicals.xml. Their comments explain how each was fitted.
Goes inside any body definition (<PlanetaryBody>, <AtmosphericBody>, <TerrestrialBody> and so on), next to <Atmosphere>, <Rings> and the rest. Earth:
<Magnetosphere>
<PoleLatitude Degrees="80.7" />
<PoleLongitude Degrees="-72.7" />
<Offset>
<X Km="-446" />
<Y Km="290" />
<Z Km="204" />
</Offset>
<EquatorialFieldMicroTesla Value="30" />
<Belt L="1.5" Width="0.15" PeakMilliSievertsPerHour="40" />
<Belt L="4.5" Width="1.0" PeakMilliSievertsPerHour="8" />
<Aurora L="7" Width="2" Brightness="1" />
</Magnetosphere>
| Element | Default | What it does |
|---|---|---|
<PoleLatitude> |
90° | Latitude of the magnetic north pole, in the body's own rotating frame. Takes any angle unit. |
<PoleLongitude> |
0° | Longitude of that pole. |
<Offset> |
centre | Where the dipole sits relative to the body's centre, in the body's rotating frame. X, Y, Z take distance units. Earth's is about 570 km off-centre. |
<EquatorialFieldMicroTesla Value> |
required | Field strength at the magnetic equator, at the surface. Must be above 0. |
<Inflation Value> |
1 | Scales the magnetosphere's size past what the field alone gives. Jupiter uses 1.5 for its plasma disc, Uranus 0.73. |
<Belt> |
none | A radiation belt. Repeat for several. |
<Aurora> |
none | Draws an aurora. Without it there is none. |
The magnetosphere's sunward edge (the magnetopause) sits where the field's pressure balances the star's wind, which falls off with distance from the star. The standoff, in body radii, is roughly
Inflation × (5.95 × B² / (2 μ₀ × windPressure))^(1/6)
with B in tesla, capped at 200 radii. Stronger fields and planets further from their star get larger magnetospheres. The night side is stretched into a tail, and a bow shock sits 1.3 times further out than the magnetopause.
<Belt L="4.5" Width="1.0" PeakMilliSievertsPerHour="8" />
| Attribute | What it is |
|---|---|
L |
Which field shell the belt is centred on, in body radii at the magnetic equator. Must be above 1. |
Width |
Gaussian width of the belt, in the same units. Must be above 0. |
PeakMilliSievertsPerHour |
Dose rate at the centre of the belt, on the magnetic equator. |
Belt radiation falls off away from the magnetic equator and fades out for orbits that dip below about 200 to 600 km above the surface, where the atmosphere would scatter the particles. A belt sitting inside a ring system does not make physical sense; Saturn's single belt is outside its rings for that reason.
<Aurora L="7" Width="2" Brightness="1">
<Green R="0.3" G="1" B="0.45" />
<Red R="1" G="0.15" B="0.25" />
</Aurora>
| Attribute / element | Default | What it does |
|---|---|---|
L |
7 | Field shell whose footprint forms the auroral oval. Higher L puts the oval nearer the poles. Must be above 1. |
Width |
2 | Width of the oval, in L. Must be less than 2 × (L − 1). |
Brightness |
1 | Overall brightness. |
<Green> / <Red> |
as shown | The two emission colours. |
On a <StellarBody>:
<SpaceWeather QuietMilliSievertsPerDay="0.3" WindPressureNanoPascals="2" />
| Attribute | Default | What it does |
|---|---|---|
QuietMilliSievertsPerDay |
0.3 | The star's radiation dose at 1 AU. |
WindPressureNanoPascals |
2 | Stellar wind pressure at 1 AU. Sets the size of every magnetosphere around that star. |
Both fall off with the square of distance from the star. Every star's dose is added up, and a vessel in a planet's shadow gets half of that star's dose. Magnetospheres are sized by the strongest wind reaching the planet, so in a multiple star system the nearest or brightest star usually sets it.
On the <System>:
<CosmicRays MilliSievertsPerDay="1.8" />
The background dose everywhere. Default 1.8. See <System> Tag.
At a vessel's position:
Field shielding is 1 outside the magnetopause and drops to 0.05 near the surface. The atmosphere then cuts the total by e^(−column / 1000 kg/m²), where the column is the mass of air above the vessel.
<EquatorialFieldMicroTesla>. Nothing validates the values on load, so a missing or zero field gives a magnetosphere with no size rather than an error.L at or below 1, which puts the belt inside the planet.<Offset> is in the body's rotating frame, not the orbital frame.