Startup
Startup
Cargo
When written: at startup, note this is now written slightly later in startup, after we have initialised missions, so we can detect if any cargo came from an abandoned delivery mission
The first "Cargo" event in the file will contain the full inventory, others just indicate a separate file has been written
The full data is now written to a separate file Cargo.json
A simple event (with no parameters) is written to the main journal file when the cargo file is updated
Parameters:
- Vessel: "Ship" or "SRV"
- Inventory: array of cargo,
- Name
- Count
- Stolen
- MissionID (if relevant)
Example:
{
"timestamp": "2018-06-26T08:21:17Z",
"event": "Cargo",
"Vessel": "Ship",
"Inventory": [
{
"Name": "gold",
"Count": 2,
"Stolen": 0
},
{
"Name": "gold",
"MissionID": 65397935,
"Count": 14,
"Stolen": 0
},
{
"Name": "iondistributor",
"Name_Localised": "Ion Distributor",
"Count": 2,
"Stolen": 0
}
]
}
ClearSavedGame
When written: If you should ever reset your game
Parameters:
- Name: commander name
- FID: player id
Example:
{
"timestamp": "2016-06-10T14:32:03Z",
"event": "ClearSavedGame",
"Name": "HRC1",
"FID": "F44396"
}
Commander
When written: at the start of the LoadGame process
This is written before the inventory, loadout, etc
Parameters:
- Name: commander name
- FID: player id
Loadout
When written: at startup, when loading from main menu, or when switching ships, or after changing the ship in Outfitting, or when docking SRV back in mothership
Parameters:
- Ship: current ship type
- ShipID: ship id number (indicates which of your ships you are in)
- ShipName: user-defined ship name
- ShipIdent: user-defined ship ID string
- HullValue – may not always be present
- ModulesValue – may not always be present
- HullHealth
- UnladenMass – Mass of Hull and Modules, excludes fuel and cargo
- FuelCapacity: { Main: , Reserve: }
- CargoCapacity
- MaxJumpRange: (based on zero cargo, and just enough fuel for 1 jump)
- Rebuy
-
Hot: (if wanted at startup – may not always be present)
-
Modules: array of installed items, each with:
- Slot: slot name
- Item: module name - lowercase
- On: bool, indicates on or off
- Priority: power priority
- Health
- Value
- AmmoInClip: (if relevant)
- AmmoInHopper: (if relevant)
- Engineering: (if engineered)
- EngineerID
- Engineer: name
- BlueprintID
- BlueprintName: blueprint name
- Level
- Quality
- ExperimentalEffect: (name, if applied)
- Modifications: Json array of objects
- Label – (see §15.11 below)
- Value – may not always be present
- OriginalValue
- LessIsGood: bool
(For a passenger cabin, AmmoInClip holds the number of places in the cabin)
Materials
When written: at startup, when loading from main menu into game
Parameters:
- Raw: array of raw materials (each with name and count)
- Manufactured: array of manufactured items
- Encoded: array of scanned data
Example:
{
"timestamp": "2017-02-10T14:25:51Z",
"event": "Materials",
"Raw": [
{
"Name": "chromium",
"Count": 28
},
{
"Name": "zinc",
"Count": 18
},
{
"Name": "iron",
"Count": 23
},
{
"Name": "sulphur",
"Count": 19
}
],
"Manufactured": [
{
"Name": "refinedfocuscrystals",
"Count": 10
},
{
"Name": "highdensitycomposites",
"Count": 3
},
{
"Name": "mechanicalcomponents",
"Count": 3
}
],
"Encoded": [
{
"Name": "emissiondata",
"Count": 32
},
{
"Name": "shielddensityreports",
"Count": 23
}
]
}
Missions
When written: at startup
Parameters:
- Active: (array of objects)
- Failed: (array of objects)
- Complete: (array of objects)
Each object contains:
- MissionID
- Name
- PassengerMission: bool
- Expires: time left in seconds
{
"timestamp": "2017-10-02T10:37:58Z",
"event": "Missions",
"Active": [
{
"MissionID": 65380900,
"Name": "Mission_Courier_name",
"PassengerMission": false,
"Expires": 82751
}
],
"Failed": [],
"Complete": []
}
NewCommander
When written: Creating a new commander
Parameters:
- Name: (new) commander name
- FID: player id
- Package: selected starter package
Example:
{
"timestamp": "2016-06-10T14:32:03Z",
"event": "NewCommander",
"Name": "HRC1",
"FID": "F44396",
"Package": "ImperialBountyHunter"
}
LoadGame
When written: at startup, when loading from main menu into game
Parameters:
- Commander: commander name
- FID: player id
- Horizons: bool
- Odyssey: bool
- Ship: current ship type
- ShipID: ship id number (indicates which of your ships you are in)
- StartLanded: true (only present if landed)
- StartDead:true (only present if starting dead: see "Resurrect")
- GameMode: Open, Solo or Group
- Group: name of group (if in a group)
- Credits: current credit balance
- Loan: current loan
- ShipName: user-defined ship name
- ShipIdent: user-defined ship ID string
- FuelLevel: current fuel
- FuelCapacity: size of main tank
- language
- gameversion
- build
Example:
{
"timestamp": "2017-02-10T14:25:51Z",
"event": "LoadGame",
"Commander": "HRC-2",
"FID": "F44396",
"Horizons": true,
"Ship": "FerDeLance",
"ShipID": 19,
"ShipName": "jewel of parhoon",
"ShipIdent": "hr-17f",
"FuelLevel": 3.964024,
"FuelCapacity": 8,
"GameMode": "Open",
"Credits": 2890718739,
"Loan": 0
}
Passengers
When written: at startup, when loading the saved game file
Parameters:
- Manifest: array of passenger records, each containing:
- MissionID
- Type
- VIP (bool)
- Wanted (bool)
- Count
Powerplay
When written: at startup, if player has pledged to a power
Parameters:
- Power: name
- Rank
- Merits
- Votes
- TimePledged (time in seconds)
Example:
{
"timestamp": "2018-01-31T10:53:04Z",
"event": "Powerplay",
"Power": "Edmund Mahon",
"Rank": 0,
"Merits": 10,
"Votes": 0,
"TimePledged": 433024
}
Progress
When written: at startup
Parameters:
- Combat: percent progress to next rank
- Trade: "
- Explore: "
- Empire: "
- Federation: "
- CQC: "
Example:
{
"timestamp": "2016-06-10T14:32:03Z",
"event": "Progress",
"Combat": 77,
"Trade": 9,
"Explore": 93,
"Empire": 0,
"Federation": 0,
"CQC": 0
}
Rank
When written: at startup
Parameters:
- Combat: rank on scale 0-8
- Trade: rank on scale 0-8
- Explore: rank on scale 0-8
- Empire: military rank
- Federation: military rank
- CQC: rank on scale 0-8
Example:
{
"timestamp": "2016-06-10T14:32:03Z",
"event": "Rank",
"Combat": 2,
"Trade": 2,
"Explore": 5,
"Empire": 1,
"Federation": 3,
"CQC": 0
}
Reputation
When written: at startup (after Rank and Progress)
This gives the player's reputation (on a scale of -100..+100) with the superpowers
Parameters:
- Empire
- Federation
- Independent
- Alliance
Note thresholds:
-100.. -90: hostile
-90.. -35: unfriendly
-35..+ 4: neutral
+4..+35: cordial
+35..+90: friendly
+90..+100: allied
Statistics
When written: at startup
This line contains the information displayed in the statistics panel on the right side of the cockpit
Parameters:
- Bank_Account
- Current_Wealth Spent_On_Ships
- Spent_On_Outfitting Spent_On_Repairs
- Spent_On_Fuel
- Spent_On_Ammo_Consumables
- Insurance_Claims
- Spent_On_Insurance
- Combat
- Bounties_Claimed
- Bounty_Hunting_Profit
- Combat_Bonds
- Combat_Bond_Profits
- Assassinations
- Assassination_Profits
- Highest_Single_Reward
- Skimmers_Killed
- Crime
- Fines
- Total_Fines
- Bounties_Received
- Total_Bounties
- Highest_Bounty
- Smuggling
- Black_Markets_Traded_With
- Black_Markets_Profits
- Resources_Smuggled
- Average_Profit
- Highest_Single_Transaction
- Trading
- Markets_Traded_With
- Market_Profits
- Resources_Traded
- Average_Profit
- Highest_Single_Transaction
- Mining
- Mining_Profits
- Quantity_Mined
- Materials_Collected
- Exploration
- Systems_Visited
- Fuel_Scooped
- Fuel_Purchased
- Exploration_Profits
- Planets_Scanned_To_Level_2
- Planets_Scanned_To_Level_3
- Highest_Payout
- Total_Hyperspace_Distance
- Total_Hyperspace_Jumps
- Greatest_Distance_From_Start
- Time_Played
- Passengers
- Passengers_Missions_Bulk
- Passengers_Missions_VIP
- Passengers_Missions_Delivered
- Passengers_Missions_Ejected
- Search_And_Rescue
- SearchRescue_Traded
- SearchRescue_Profit
- SearchRescue_Count
- Crafting
- Spent_On_Crafting
- Count_Of_Used_Engineers
- Recipes_Generated
- Recipes_Generated_Rank_1
- Recipes_Generated_Rank_2
- Recipes_Generated_Rank_3
- Recipes_Generated_Rank_4
- Recipes_Generated_Rank_5
- Recipes_Applied
- Recipes_Applied_Rank_1
- Recipes_Applied_Rank_2
- Recipes_Applied_Rank_3
- Recipes_Applied_Rank_4
- Recipes_Applied_Rank_5
- Recipes_Applied_On_Previously_Modified_Modules
- Crew
- NpcCrew_TotalWages
- NpcCrew_Hired
- NpcCrew_Fired
- NpcCrew_Died
- Multicrew
- Multicrew_Time_Total
- Multicrew_Gunner_Time_Total
- Multicrew_Fighter_Time_Total
- Multicrew_Credits_Total
- Multicrew_Fines_Total
Note times are in seconds
Example:
{
"timestamp": "2017-09-25T15:18:31Z",
"event": "Statistics",
"Bank_Account": {
"Current_Wealth": 148827050,
"Spent_On_Ships": 14499177,
"Spent_On_Outfitting": 30785093,
"Spent_On_Repairs": 17716,
"Spent_On_Fuel": 1647,
"Spent_On_Ammo_Consumables": 0,
"Insurance_Claims": 4,
"Spent_On_Insurance": 1397620
},
"Combat": {
"Bounties_Claimed": 0,
"Bounty_Hunting_Profit": 0,
"Combat_Bonds": 0,
"Combat_Bond_Profits": 0,
"Assassinations": 0,
"Assassination_Profits": 0,
"Highest_Single_Reward": 0,
"Skimmers_Killed": 0
},
"Crime": {
"Fines": 0,
"Total_Fines": 0,
"Bounties_Received": 0,
"Total_Bounties": 0,
"Highest_Bounty": 0
},
"Smuggling": {
"Black_Markets_Traded_With": 0,
"Black_Markets_Profits": 0,
"Resources_Smuggled": 0,
"Average_Profit": 0,
"Highest_Single_Transaction": 0
},
"Trading": {
"Markets_Traded_With": 3,
"Market_Profits": 40700,
"Resources_Traded": 23,
"Average_Profit": 4070,
"Highest_Single_Transaction": 17961
},
"Mining": {
"Mining_Profits": 0,
"Quantity_Mined": 0,
"Materials_Collected": 100
},
"Exploration": {
"Systems_Visited": 228,
"Fuel_Scooped": 111,
"Fuel_Purchased": 0,
"Exploration_Profits": 304469,
"Planets_Scanned_To_Level_2": 39,
"Planets_Scanned_To_Level_3": 15,
"Highest_Payout": 52503,
"Total_Hyperspace_Distance": 844927,
"Total_Hyperspace_Jumps": 295,
"Greatest_Distance_From_Start": 65222.47204614,
"Time_Played": 651060
},
"Passengers": {
"Passengers_Missions_Bulk": 0,
"Passengers_Missions_VIP": 0,
"Passengers_Missions_Delivered": 0,
"Passengers_Missions_Ejected": 0
},
"Search_And_Rescue": {
"SearchRescue_Traded": 12,
"SearchRescue_Profit": 19467,
"SearchRescue_Count": 8
},
"Crafting": {
"Spent_On_Crafting": 0,
"Count_Of_Used_Engineers": 2,
"Recipes_Generated": 28,
"Recipes_Generated_Rank_1": 9,
"Recipes_Generated_Rank_2": 6,
"Recipes_Generated_Rank_3": 9,
"Recipes_Generated_Rank_4": 4,
"Recipes_Generated_Rank_5": 0,
"Recipes_Applied": 21,
"Recipes_Applied_Rank_1": 8,
"Recipes_Applied_Rank_2": 5,
"Recipes_Applied_Rank_3": 7,
"Recipes_Applied_Rank_4": 1,
"Recipes_Applied_Rank_5": 0,
"Recipes_Applied_On_Previously_Modified_Modules": 0
},
"Crew": {
"NpcCrew_TotalWages": 0,
"NpcCrew_Hired": 0,
"NpcCrew_Fired": 0,
"NpcCrew_Died": 0
},
"Multicrew": {
"Multicrew_Time_Total": 23327,
"Multicrew_Gunner_Time_Total": 14241,
"Multicrew_Fighter_Time_Total": 6070,
"Multicrew_Credits_Total": 0,
"Multicrew_Fines_Total": 0
}
}