Skip to content

Time, system, and bodies

PathFormatMeaning
time/utsecondsuniversal simulation time
time/warpscalarcurrent warp factor; 1 is realtime
time/sim_dtsecondslast simulation advance; 0 is effectively paused
time/warp_speedsf f …discrete game warp factors
time/auto_warp0 or 1 target-utautomatic warp state and target
time/alarmsecondswrite a target UT; its read blocks until that time

time/alarm is the simulation-clock sleep primitive. It is warp-correct, unlike sleeping for wall time. HTTP offers the same wait as GET /v1/time/wait?until=<ut>.

system/{name,home,sun} and bodies/<id>/ exist when telemetry_bodies=true. Body catalogs update at telemetry_bodies_rate_hz, or every sample when it is zero.

GroupLeavesUnits / caveat
identityid, class, parent, childrenchildren is a newline list
physicalmass, radius, mu, soi, rotation_ratekg, m, m³/s², m, rad/s
motionposition/ecl, velocity/eclECL m and m/s
orbitapoapsis, periapsis, ecc, inc, lan, argpe, sma, periodapses are altitude in m; angles are degrees
atmospherepresent, height, scale_height, sea_level_pressure, sea_level_densityabsent for airless bodies
oceanpresent, densityabsent without an ocean

bodies/<id>/focus is a trigger: write 1 to move the main camera to the body. It is view-only and does not require vessel-control authority. For coordinate meanings, use Frames and units.