Tested with: KSA Version 2026.10.19.5638
<Assets> is the root element of most content files. Around forty files in Content\Core use it, not just Astronomicals.xml, and it accepts about sixty different child elements.
Examples on this page are taken from stock files. They are illustrative rather than exact. Anything in italics is unconfirmed. Every stock file opens with <?xml version="1.0" encoding="utf-8"?>.
A <System> file can hold the same definitions inline, but they will be local to that system and other files cannot reference them. See <System> Tag.
Files are loaded in the order they are listed under assets in mod.toml, so a file that references an id from another file has to come after it.
Unknown elements are ignored rather than rejected. Misspell an element name and nothing errors, the element is skipped, and whatever it configured keeps its default. That is the single most common reason a change "does nothing".
Specifies a star. This is used as a base for a system. Id specifies the name of the star, this shows up in-game as well.
Stock Sol is now just four elements:
<StellarBody Id="Sol">
<MeanRadius Km="696342" />
<Mass Suns="1" />
<Color R="1" G="1" B="1" />
<Sunlight R="9" G="9" B="9" />
</StellarBody>
Descendants:
<MeanRadius Km="696342" />: Used for the radius of the star.<Mass Suns="1" />: Used for the mass of the star.<Color R="1" G="1" B="1" />: Overall color of the star when seen.<Sunlight R="9" G="9" B="9" />: Color of the sunlight the star produces, slightly modifying the surfaces it hits. This can be higher than the normal 0 to 1 range to make sunlight persist farther.<SpaceWeather QuietMilliSievertsPerDay="0.3" WindPressureNanoPascals="2" />: Optional. The star's radiation dose and wind pressure at 1 AU. See Magnetospheres.<Position>, <Orbit>, <SphereOfInfluence>, <StarMaskRadius>: For stars other than the main one. See Multiple Star Systems.Craft are no longer declared here. <Vehicle> is still a valid element name, but VehicleTemplate reads only SituationRef, Body2Cce, BodyRates and WindSound now. The part tree, mass, propellant mass, moments of inertia, orbit and colour all moved or were removed, and no stock file declares a <Vehicle> any more.
A craft is now a folder under Content\Core\defaultvehicles\ holding meta.toml and vehicle.xml, with its starting orbit as a separate <Situation>, joined together in the system file by <LoadVehicleFromLibrary>.
See Adding a vehicle.
This element does not exist any more. Kittens are ordinary craft whose vehicle.xml carries a Character="BanjoKitten" attribute. Stock Banjo, Hunter and Polaris sit in defaultvehicles\ alongside Gemini7 and Rocket and load exactly the same way.
Where a craft starts. Defined once, referenced by any number of craft.
<Situation Id="Gemini7StartingSituation">
<Orbit DefinitionFrame="Ecliptic">
<SemiMajorAxis Km="6713" />
<Inclination Degrees="28.87" />
<Eccentricity Value="0.0077" />
<LongitudeOfAscendingNode Degrees="60.48" />
<ArgumentOfPeriapsis Degrees="30.0015" />
<TimeAtPeriapsis Minutes="-20" />
</Orbit>
</Situation>
Also accepts <CelestialId> and <LocationId> for placing a craft at a named surface location instead of in orbit. Stock situations live in Content\Core\Situations.xml.
Specifies a planet with atmosphere. Id is the planet's name, this is also shown in-game. Parent specifies the object the planet is orbiting.
Descendants:
<Orbit>: Specifies the orbit of the planet.
<SemiMajorAxis Km="1.495396277103892E+08" />: Specifies the semi-major axis of the planet and appears to be able to use scientific notation.<Inclination Degrees="4.495777668608611E-03" />: Specifies the inclination of the planet's orbit and appears to be able to use scientific notation. (degrees from the equator)<Eccentricity Value="1.657443784940060E-02" />: Specifies the eccentricity of the planet's orbit and appears to be able to use scientific notation. (0 - circular, 1 - line)<LongitudeOfAscendingNode Degrees="2.001005464352027E+02" />: Specifies the longitude of ascending node of the planet's orbit and appears to be able to use scientific notation. (honestly no idea)<ArgumentOfPeriapsis Degrees="2.647204271842132E+02" />: Specifies the argument of periapsis of the planet's orbit in degrees and appears to be able to use scientific notation. (what?)<TimeAtPeriapsis Seconds="3155415.2731954656" />: Time at periapsis, used to set the starting position along the orbit. Takes any time unit, not just minutes.<Rotation DefinitionFrame="Ecliptic">: Specifies rotation of the planet. DefinitionFrame sets the reference for rotation, "Ecliptic" appears to be the only option.
<SiderealPeriod Hours="23.9344695944"/>: Specifies the rotation period of the planet in hours.<Tilt Degrees="23.441522" />: Specifies the axial tilt of the planet in degrees.<Azimuth Degrees="-0.363633" />: Specifies the azimuth of the planet in degrees.<IsTidallyLocked Value="true" />: Locks rotation to the orbit, overriding SiderealPeriod.<IsRetrograde Value="true" />: Rotates the other way.<InitialParentFacingLongitude Degrees="-118" />: Specifies the initial rotation based on the degrees of the parent-facing longitude.<MeshCollection Id="EarthScale"/>: Specifies the mesh to use for the planet. Id specifies the name of the mesh.<Diffuse Id="Earth_Diffuse" Path="Textures/Earth_Diffuse.ktx2" Category="Terrain"/>: Base colour for the planet surface. Stock uses .ktx2 cubemaps. Id names the texture for reference elsewhere.<Normal Id="Earth_Normal" Path="Textures/Earth_Normal.ktx2" Category="TerrainHeight"/>: Normal map. Note the category is TerrainHeight, not Terrain.<Height Id="Earth_Height" Path="Textures/Earth_Height.ktx2" Category="TerrainHeight">: Height map driving the surface geometry.
<Minimum Km="-10.930"/>: Specifies the lowest possible point on the planet's surface in kilometers. This is used to apply the height map between this value and the <Maximum> value.<Maximum Km="8.627"/>: Specifies the highest possible point on the planet's surface in kilometers. This is used to apply the height map between the <Minimum> value and this value.<Biomes>: Biome maps and the biome list. Note this sits directly on the body, it is no longer nested inside <Terrain>.
<BiomeIDMap Id="EarthBiomeID" Path="Textures/Earth_Biome_ID.ktx2" Category="TerrainHeight"/>: Which biome each point of the surface belongs to.<BiomeControlMap Id="EarthBiomeControl" Path="Textures/Earth_Biome_Control.ktx2" Category="TerrainHeight"/>: Blending control between biomes.<BlendStrength Value="5" />: How sharp the transition between two biomes is.<Biome IdMapIndex="0" Alias="Beach"/>: Names a biome. IdMapIndex is the value in the ID map, Alias is the name that <BiomeMaterial> and <Modifier> refer to. One of these per biome.<Terrain>: Terrain generation and surface materials.
<ProceduralModifiers>: Noise layered on top of the height map.
<GradientScale Value="3.5" />: Global scale applied to modifier gradients.<Modifier Type="Erosion" Name="EarthErosion" Biomes="DesertMountains,Desert,Snow">: One modifier. Biomes is a comma-separated list of biome aliases it applies to; omit it to apply everywhere.
<Frequency Value="150" />: Frequency of the modifier.<Amplitude Value="100" />: Amplitude of the modifier.<Lacunarity Value="2" />: Lacunarity of the modifier.<GradientFalloff Value="0.1" />: Gradient falloff multiplier.<Curvature Value="0.00035" />: Curvature of the modifier.<Seed Value="1" />: Seed used when generating.<Octaves Value="6" />: Octaves of the modifier.<GenerateColor Value="false" />: Whether the noise carries colour or stays greyscale.<ValleyColor R="0.0" G="0.0" B="0.0" A="0.0" />: Valley colour.<RidgeColor R="0.42" G="0.42" B="0.42" A="1.0" />: Ridge colour.<BiomeSounds>: Ambient sound per biome.<BiomeMaterials>: Ground and slope textures per biome.
<BlendStrength Value="5" />: How strong the gradient between two biomes is.<DetailFadeInStart Km="3000" /> and <DetailFadeInEnd Km="100" />: The altitude band over which close-up detail fades in.<BiomeMaterial Biome="Snow">: Materials for one biome, matched by Biome against a <Biome Alias=> above. This is no longer keyed by document order.
<GroundMaterial>: The material on flat ground.
<Diffuse Id="EarthPolesDiffuse" Path="Textures/....ktx2" Category="Terrain"/>: Base colour. Id names the texture so other elements can reference it.<Normal Id="..." Path="..." Category="Terrain"/>: Normal map.<AoRoughMetal Id="..." Path="..." Category="Terrain"/>: Packed ambient occlusion, roughness and metallic.<Displacement Id="..." Path="..." Category="Terrain"/>: Displacement map.<Height Id="..." Path="..." Category="Terrain"/>: Height map.<TextureTiling Value="0.078" />: How often the texture repeats.<HeightTiling Value="0.0000155" />: How often the height map repeats.<HeightDeformity Value="0.0" />: How strongly the height map deforms geometry.<DiffuseScale Value="1.0" />, <NormalScale Value="1.0" />, <DisplacementScale Value="0.25" />: Per-map multipliers.<SlopeMaterial>: The material on steep ground. Same children as <GroundMaterial>.<GroundClutter>: Grass, rocks and trees scattered across the surface.
<Ecotype Name="Grass">: One clutter type.
<CollisionType Value="None" />: Whether the clutter is solid.<Placement Biomes="Grass,GrassMountains" />: Which biomes it appears in.<ClutterObject Id="Grass" />: The mesh to scatter. Defined elsewhere as a <ClutterObject> asset.<Material Id="EarthGrassClutterMaterial" />: Its material.<Scattering Id="Earth_Scattering" Path="Textures/Earth_Scattering.ktx2" Category="Terrain">: Hapke photometric scattering for the surface.
<MeanAlbedo Value="0.3" /><MeanDiffuseLuminosity Value="0.47" /><Surge Id="Earth_Surge" Path="Textures/Earth_Surge.ktx2" Category="Terrain">: Opposition surge.
<MeanSlopeRoughness Degrees="0.0" /><Detail> and <Triplanar>: PbrMaterial references used for close-up surface detail.<Rings>: Planetary rings. Takes a DefinitionFrame attribute plus <Inclination>, <LongitudeOfAscendingNode>, <InnerRadius>, <OuterRadius>, <Texture>, <ControlTexture>, <DetailScale>, <Volume> and <RingObjects>.<Magnetosphere>: A magnetic field, with optional radiation <Belt>s and an <Aurora>. See Magnetospheres.<EnvironmentSound Id="EarthAmbience"/>: Ambient sound for the body.<SphereOfInfluence>: Explicit SOI radius. Derived from mass if omitted.<TerrainScale>: Multiplier on terrain height.<RandomHeightmapCollection>: For procedurally varied terrain.<Crater Id="...">: A named crater marker. Same shape as <Mountain>.<MeanRadius Km="6371" />: Specifies the mean radius of the planet in kilometers.<Mass Earths="1" />: Mass of the planet. See Units for the full list.<Color R="0.11" G="0.31" B="0.415" />: Specifies the orbit line color to use for the planet. This could also be used for the sprite and planetshine since it is stated that the <Color> tag does that in <PlanetaryBody>.<Atmosphere>: Split into <Physical> (SeaLevelPressure, SeaLevelDensity, ScaleHeight) and <Visual> (RayleighScattering, MieScattering, Ozone, StartHeight). Worked examples on Planets.<Ocean>: <Level>, <Density>, <MeshCollection>, <Color>, <ColorTexture>, <TransparencyDepth>, plus <WindWaves> and <GerstnerWaves>. Worked example on Planets.<Clouds>: <OrbitTransitionStartAltitude>, <OrbitTransitionEndAltitude>, <MaxShadowsAltitude>, <VolumetricsFlickerReductionDistance>, and one or more <Layer>. Worked example on Planets.<Mountain Id="Everest">: Specifies a mountain marker to add to the planet. Id specifies the name of the mountain, this is also shown in-game.
<Latitude Degrees="27.9881" />: Specifies the latitude of the mountain in degrees.<Longitude Degrees="86.9250" />: Specifies the longitude of the mountain in degrees.<City Id="Auckland">: Specifies a city marker to add to the planet. Id specifies the name of the city, this is also shown in-game.
<Latitude Degrees="-36.8485" />: Specifies the latitude of the city in degrees.<Longitude Degrees="174.7633" />: Specifies the longitude of the city in degrees.<Landmark Id="CCSFS LC-39A" IsLaunchPad="true">: A landmark marker. Id is shown in-game. IsLaunchPad="true" is what makes it usable as a launch site.
<Latitude Degrees="28.608263" />: Specifies the latitude of the landmark in degrees.<Longitude Degrees="-80.604144" />: Specifies the longitude of the landmark in degrees.Specifies a planet with no atmosphere. Id is the planet's name, this is also shown in-game. Parent specifies the object the planet is orbiting.
Descendants:
Defined in Content\Core\DefaultAssets.xml. It loads a mesh using a relative path to a .glb or .gltf file. (specified in Path) Id is used to give the Mesh an internal name that can be used to load it.
Defined in Content\Core\DefaultAssets.xml. It loads a texture using a relative path to a .png or .dds file. (specified in Path) Id is used to give the Mesh an internal name that can be used to load it.
This is the same as the <Texture/> tag but it can contain tags inside of it too.
Descendants:
<IsVirtual>false</IsVirtual>: Specifies if the texture is virtual. (broken up into pieces and loaded on demand)<Manifest>: Contains various texture information.
<MaxSize>0</MaxSize>: Specifies the maximum size for the texture.<MipMaps>false</MipMaps>: Specifies whether mipmaps should be used.Defined in Content\Core\DefaultAssets.xml. It loads a shader using a relative path to a .vert, .frag, .tesc, .tese, or comp file. (specified in Path) Id is used to give the Mesh an internal name that can be used to load it.
Defined in Content\Core\Sounds.xml. It contains information for a spatial sound. Id is used to give the Mesh an internal name that can be used to load it.
Descendants:
<VolumeRange Min="1" Max="10000"/>: Specifies the minimum and maximum volume of the audio.<TwoDRange Min="0" Max="0"/>: Specifies the range of the audio.Defined in Content\Core\Sounds.xml. It contains information for a sound group. Id is used to give the sound group an internal name that can be used to use it. MuteFadeSpeed specifies how fast the volume fades out when muted.
Descendants:
<Behavior Value="StealLowest"/>: Specifies the behavior of the audio. The only known value is "StealLowest".<MaxChannels Value="4"/>: Specifies the maximum number of audio sources of this type playing at the same time.Defined in Content\Core\Sounds.xml. It contains information for a sound file. It loads a sound using a relative path to a .wav file. (specified in Path) Id is used to give the sound file an internal name that can be used to load it.
Descendants:
<Loop/>: If this tag is present, the audio in the file will loop.Defined in Content\Core\Sounds.xml. It contains information for a sound. SimSpeed specifies if the sound should be sped up or slowed down based on the current simulation speed. Channel specifies the channel for the sound. Currently known channels are "UI" and "Sfx". Id is used to give the sound an internal name that can be used to load it.
Descendants:
<SoundFile Path="Sounds/LedButtonDown.wav" TwoD="true"/>: This loads a file to use for the sound. Path specifies a relative path to a .wav or .ogg file to use for the sound. TwoD specifies if the sound will be 2D.<SpatialSoundData Id="EngineSpatialData"/>: This specifies what spatial sound data to use for the sound. Id specifies the spatial sound data's internal name.<FadeOut Time="0.1"/>: This specifies how fast the sound fades out.<SoundFile Path="Sounds/RCSDefault.wav">: This is the same as <SoundFile/> above in the descendants list, however it can contain other tags.
<Loop/>: If this tag is present, the audio in the file will loop.<Loop>: Used instead of <Loop/>. Contains loop information for the sound.<Start Value="93227" Unit="Pcm"/>: Specifies when the sound's loop starts (Value) and what units are used for the starting point. (Units)<Pitch Min="0.9" Max="1.1"/>: Specifies the minimum and maximum pitch of the sound.<Volume Min="0.8" Max="1"/>: Specifies the minimum and maximum volume of the sound.Defined in Content\Core\Sounds.xml. It specifies a compound sound (a sound with multiple sounds with each having a role) and assigns it an internal name. (Id)
Descendants:
<StartSound Id="DefaultEngineStart"/>: Specifies the starting sound, this will play first. Id specifies an internal name of the sound to load.<Sound Id="DefaultEngine"/>: Specifies the main sound, this will play in between the starting and the stopping sounds. Id specifies an internal name of the sound to load.<StopSound Id="DefaultEngineStart"/>: Specifies the stopping sound, this will play last. Id specifies an internal name of the sound to load.Defined in Content\Core\Sounds.xml. It contains multiple <Sound> tags with the exact same syntax as if they were in the root node.
Defined in Content\Core\Sounds.xml. This will create a music playlist with internal name Id, that would start playing at LocationId, affected (or not) by the current simulation speed based on SimSpeed, with the sounds being selected based on the SelectionRule, and playing using the audio channel Channel.
Descendants:
<MusicFile Path="Music/08_SunSynchronous.ogg" StreamFromDisk="true" TwoD="true" Volume="0.2">: Specifies a music file to load. Path is a relative path to an .ogg file to use for the music. StreamFromDisk specifies whether the file should be played directly from the disk. TwoD specifies whether the file should be 2D. Volume sets the volume of the sound.
<Loop>: Contains loop information.<Start Value="6967" Unit="Ms"/> :Specifies when the sound's loop starts (Value) and what units are used for the starting point. (Units)<SyncPoint Value="6967" Unit="Ms" />: Specifies a synchronization point. Value specifies where the point is and Units chooses the units to use for the point's position.<FadeOut Time="5"/>: Specifies how fast the music fades out.AssetBundle declares sixty element names. The ones below are real and in stock use but not documented in detail yet. Listed so you at least know they exist.
Celestial bodies: StellarBody, AtmosphericBody, PlanetaryBody, TerrestrialBody, MinorBody, Asteroid, Comet, PeriodicComet, InterstellarComet
Parts: Part, SubPart, PartGameData, SubPartGameData, EditorTagDef
Placement: Situation
Chemistry and propulsion: Substance, MixtureReaction, FixedReaction, ThermalReaction, GrainGeometry
Geometry and materials: MeshFile, MeshAtlas, GltfFile, Texture, PbrMaterial, GroundClutterMaterial, ClutterObject, KeyframeAnimation
Characters: Character, CharacterCore, CharacterAttachment, CharacterFur, CharacterExpressions, CharacterMMUAnimations, CharacterAnimationMasks, CharacterGroundAnimations, CharacterTextures
VFX: VolumetricExhaustTemplate, PlumeTrailTemplate, ParticleEmitter, ParticleMesh, DistantGlint, DistantGlintSettings
UI and text: GaugeComponent, GaugeCanvas, GaugeShader, Shader, LanguageFile
Audio: SoundFile, Sound, MultiSound, CompoundSound, ClusterSound, SpatialSoundData, SoundGroup, MusicPlaylist, ChannelGroup
Undocumented audio elements that stock Sounds.xml uses inside the ones above: FadeIn, SyncPoint, Param, Send, MultibandEq.