Status File

In addition to the journal file, which is written incrementally, there is now (in v3.0) a new file Status.json which is updated every few seconds, with some information about the current state of the game.

This has a similar format to a line in the journal, but the whole file is replaced every time. It has a timestamp like the journal, and "event":"Status"

Parameters:

Flags: multiple flags encoded as bits in an integer (see below)
Flags2: more flags, mainly for when on foot
Pips: an array of 3 integers representing energy distribution (in half-pips)
Firegroup: the currently selected firegroup number
GuiFocus: the selected GUI screen
Fuel: { FuelMain, FuelReservoir} – both mass in tons
Cargo: mass in tons
LegalState
Latitude (if on or near a planet)
Altitude
Longitude
Heading
BodyName
PlanetRadius
Balance
Destination:
- System
- Body
- Name

LegalState: one of:

"Clean"
"IllegalCargo"
"Speeding"
"Wanted"
"Hostile"
"PassengerWanted"
"Warrant"
"Allied"
"Thargoid"

Additional values when on foot:

Oxygen: (0.0 .. 1.0)
Health: (0.0 .. 1.0)
Temperature (kelvin)
SelectedWeapon: name
Gravity: (relative to 1G)

Flags:

Bit	Value	Hex	Meaning
0	1	0000 0001	Docked, (on a landing pad)
1	2	0000 0002	Landed, (on planet surface)
2	4	0000 0004	Landing Gear Down
3	8	0000 0008	Shields Up
4	16	0000 0010	Supercruise
5	32	0000 0020	FlightAssist Off
6	64	0000 0040	Hardpoints Deployed
7	128	0000 0080	In Wing
8	256	0000 0100	LightsOn
9	512	0000 0200	Cargo Scoop Deployed
10	1024	0000 0400	Silent Running,
11	2048	0000 0800	Scooping Fuel
12	4096	0000 1000	Srv Handbrake
13	8192	0000 2000	Srv using Turret view
14	16384	0000 4000	Srv Turret retracted (close to ship)
15	32768	0000 8000	Srv DriveAssist
16	65536	0001 0000	Fsd MassLocked
17	131072	0002 0000	Fsd Charging
18	262144	0004 0000	Fsd Cooldown
19	524288	0008 0000	Low Fuel ( < 25% )
20	1048576	0010 0000	Over Heating ( > 100% )
21	2097152	0020 0000	Has Lat Long
22	4194304	0040 0000	IsInDanger
23	8388608	0080 0000	Being Interdicted
24	16777216	0100 0000	In MainShip
25	33554432	0200 0000	In Fighter
26	67108864	0400 0000	In SRV
27	134217728	0800 0000	Hud in Analysis mode
28	268435456	1000 0000	Night Vision
29	536870912	2000 0000	Altitude from Average radius
30	1073741824	4000 0000	fsdJump
31	2147483648	8000 0000	srvHighBeam

Flags2 bits:

Bit	Value	Hex	Meaning
0	1	0001	OnFoot
1	2	0002	InTaxi (or dropship/shuttle)
2	4	0004	InMulticrew (ie in someone else's ship)
3	8	0008	OnFootInStation
4	16	0010	OnFootOnPlanet
5	32	0020	AimDownSight
6	64	0040	LowOxygen
7	128	0080	LowHealth
8	256	0100	Cold
9	512	0200	Hot
10	1024	0400	VeryCold
11	2048	0800	VeryHot
12	4096	1000	Glide Mode
13	8192	2000	OnFootInHangar
14	16384	4000	OnFootSocialSpace
15	32768	8000	OnFootExterior
16	65536	0001 0000	BreathableAtmosphere
17	131072	0002 0000	Telepresence Multicrew
18	262144	0004 0000	Physical Multicrew
19	524288	0008 0000	Fsd hyperdrive charging
20	1048576	0010 0000	Supercruise Overdrive (SCO) Active
21	2097152	0020 0000	Supercruise Assist Active (SCA is enabled and active (aligned and throttled to blue zone))

Examples:

json

{
	"timestamp": "2017-12-07T10:31:37Z",
	"event": "Status",
	"Flags": 16842765,
	"Pips": [
		2,
		8,
		2
	],
	"FireGroup": 0,
	"Fuel": {
		"FuelMain": 15.146626,
		"FuelReservoir": 0.382796
	},
	"GuiFocus": 5
}

json

{
	"timestamp": "2017-12-07T12:03:14Z",
	"event": "Status",
	"Flags": 18874376,
	"Pips": [
		4,
		8,
		0
	],
	"FireGroup": 0,
	"Fuel": {
		"FuelMain": 15.146626,
		"FuelReservoir": 0.382796
	},
	"GuiFocus": 0,
	"Latitude": -28.584963,
	"Longitude": 6.826313,
	"Heading": 109,
	"Altitude": 404
}

In the first example above 16842765 (0x0101000d) has flags 24, 16, 3, 2, 0: In main ship, Mass locked, Shields up, Landing gear down, Docked

GuiFocus values:

Value	Description
0	NoFocus
1	InternalPanel (right hand side)
2	ExternalPanel (left hand side)
3	CommsPanel (top)
4	RolePanel (bottom)
5	StationServices
6	GalaxyMap
7	SystemMap
8	Orrery
9	FSS mode
10	SAA mode
11	Codex

The latitude or longitude need to change by 0.02 degrees to trigger an update when flying, or by 0.0005 degrees when in the SRV

If the bit29 is set, the altitude value is based on the planet's average radius (used at higher altitudes)

If the bit29 is not set, the Altitude value is based on a raycast to the actual surface below the ship/srv

Status File ​

Status File