236 lines
10 KiB
Markdown
236 lines
10 KiB
Markdown
# EliteBGS
|
|
|
|
This tool is meant to help people contributing to the BGS effort to create BGS reports.
|
|
The tool allows you to configure BGS objectives, and will then parse your player journal
|
|
for tasks you completed relating to that BGS objective. Once the JSON player journal has
|
|
been parsed, you may then generate a BGS report you can copy/paste into Discord.
|
|
|
|
Source code is available [here](https://git.aror.org/florian/elitebgs).
|
|
|
|
Binary downloads can be found here: [https://bgs.n0la.org/](https://bgs.n0la.org/).
|
|
|
|
## How To
|
|
|
|
Press "Parse Journal", which will check your Elite Dangerous player journal for completed
|
|
transactions. Currently the tool recognises the following transactions:
|
|
|
|
* Buying of cargo from stations (new in Update 10)
|
|
* Completed missions
|
|
* Failed missions
|
|
* Murders
|
|
* Search and Rescue contributions
|
|
* Selling cartography data
|
|
* Selling of cargo to stations
|
|
* Selling of micro resources (Odyssey only)
|
|
* Selling of organic data (Odyssey only)
|
|
* Vouchers, including bounty vouchers, combat bonds, and settlement vouchers (aka intel packages)
|
|
|
|
Vouchers help the faction that is listed for them. If said faction is not present in the
|
|
current system, then there is no BGS impact. So the tool looks for all system factions, and
|
|
makes sure that your vouchers actually have a BGS impact, otherwise it won't list them.
|
|
|
|
Selling cargo attempts to discern the profit and/or loss, which is helpful to gauge BGS
|
|
impact. But the player journal does not tell the amount of profit in the sell message.
|
|
So the tool looks for a buy a message related to the same commodity, and calculates loss
|
|
and/or profit from that. If the buy of the commodity is not within the time and date range,
|
|
or some other shenanigans happen that the tool does not yet support, the profit/loss could
|
|
be wrong. You can use the "Adjust Trade Profit" button to manually adjust the trade profit,
|
|
or you could simply edit the discord log manually.
|
|
|
|
Please note that cartography data, and micro resources only help the controlling faction
|
|
of a station. The tool is clever enough to exclude these if the station you turn them in at, is not
|
|
controlled by the faction you specified in the objective.
|
|
|
|
Some missions may show up having zero influence for the given faction. This happens if you do
|
|
missions for a faction which is currently in an election state. You do not gain influence for
|
|
the faction so the influence reads as zero. But you contribute towards the election, so the
|
|
missions are selected anyway.
|
|
|
|
There is no entry in the journal if you win a combat zone. So you have to add those manually. Select
|
|
an objective for which you wish to log a combat zone. The faction in the objective, must be the
|
|
faction you fought for in the combat zone. Then click "Add Combat Zone Win". Select type,
|
|
either "On Foot" for Odyssey, or "Ship" for regular ones. Then select the grade (low, medium or
|
|
high), and how many you won. Then press "Accept". Select "Cancel" to abort. You can of course remove
|
|
the combat zone entries by selecting them, and pressing "DEL".
|
|
|
|
If you deliberately fail a mission (to log negative INF towards a faction), the tool cannot detect
|
|
it, if the day you accepted the mission is outside of the given date range. It needs the journal
|
|
entry where you accept the mission to connect the mission to a faction, system and station. The tool
|
|
will warn you if this happens, with a message in the error log in the fourth tab.
|
|
|
|
When committing murder, the journal entry contains the faction information of the faction that gave
|
|
you the bounty. And not the faction of the victim. The tool will look for an event in which you
|
|
scanned your victim, and gleem the victim's faction from that. If you did not scan your victim, then
|
|
sadly the tool cannot connect the victim's faction to the victim.
|
|
|
|
|
|
|
|
The window will then list all the journal entries it has found, and group them by objectives. You
|
|
can select which objectives you wish to report, by using the checkmarks.
|
|
|
|
You can exclude a specific entry within an objective by deselecting the checkbox next to them.
|
|
This way said entry will not appear in the final log. You can also remove individual entries
|
|
(if you think the tool detected something you thought was wrong), by selecting the entry,
|
|
and pressing the "DEL" key.
|
|
|
|
Once you are satisfied with the result, the discord report should be displayed below, ready to be
|
|
copy and pasted. Before you copy/paste it into the discord of your squadron, you should check the log.
|
|
You can of course edit it, if something is wrong or the tool itself missed something. If you want to
|
|
regenerate it, just click "Generate Log".
|
|
|
|
## Known Issues and Bugs
|
|
|
|
### Settlement Vouchers
|
|
|
|
Settlement vouchers (aka Intel Packages) help every faction aligned with the given superpower.
|
|
So if you turn in an Imperial intel package on an imperial station, all factions aligned with
|
|
the Empire will gain a bit of INF boost. The tool currently cannot handle that. All intel packages
|
|
are displayed instead.
|
|
|
|
### Bugged bounty vouchers
|
|
|
|
Sometimes bounty vouchers are not properly recognised. This is a bug in the player journal, where
|
|
the faction information is not properly written out in the journal:
|
|
|
|
```
|
|
{
|
|
"timestamp":"2021-10-07T14:57:50Z", "event":"RedeemVoucher",
|
|
"Type":"bounty", "Amount":20750,
|
|
"Factions":[ { "Faction":"", "Amount":500 }, { "Faction":"", "Amount":20250 }]
|
|
}
|
|
```
|
|
|
|
Since the tool does not know for which faction these bounties were redeemed for, it cannot assign
|
|
it to an objective.
|
|
|
|
### Combat Zones
|
|
|
|
The player journal currently does not make an entry when you win or lose a combat zone. This is a
|
|
an ommission from FDev:
|
|
|
|
* [https://issues.frontierstore.net/issue-detail/43509](https://issues.frontierstore.net/issue-detail/43509)
|
|
|
|
Please upvote the issue to get it fixed. Until then, you have to add combat zone wins manually.
|
|
|
|
### On-Foot NPC givers
|
|
|
|
Up until update 13 missions accepted from NPCs in Odyssey concourses do not get a player journal entry.
|
|
This has been fixed in update 13. Any on foot missions from NPCs accepted before update 13, do not have
|
|
an entry in the player journal.
|
|
|
|
### Failed vs. Abandoned Missions
|
|
|
|
The tool also currently cannot differentiate between missions you have abandoned in the transaction
|
|
tab before it was completed, and those that you have failed - either delibaretly or by time-out. So
|
|
it will find and add them all, and you simply can remove those that you have abandoned manually.
|
|
|
|
### Influence given to empty/non-existent faction
|
|
|
|
Sometimes the log will state that it gave positive or negative influence to a faction, but the
|
|
faction name is empty:
|
|
|
|
```
|
|
"FactionEffects": [
|
|
{
|
|
"Faction": "",
|
|
"Effects": [
|
|
{
|
|
"Effect": "$MISSIONUTIL_Interaction_Summary_EP_down;",
|
|
"Effect_Localised": "The economic status of $#MinorFaction; has declined in the $#System; system.",
|
|
"Trend": "DownBad"
|
|
}
|
|
],
|
|
"Influence": [
|
|
{
|
|
"SystemAddress": 251012319587,
|
|
"Trend": "DownBad",
|
|
"Influence": "+"
|
|
}
|
|
],
|
|
"ReputationTrend": "DownBad",
|
|
"Reputation": "+"
|
|
}
|
|
]
|
|
```
|
|
This happens for example if you do a scan/heist mission from a surface POI, but no one owns said
|
|
surface POI. Randomly generated surface POIs sometimes have no owner, and said non-existant owner
|
|
then gets the negative influence.
|
|
|
|
### Mission Completed but no one gains influence
|
|
|
|
Sometimes missions are completed but no one gains any influence:
|
|
|
|
```
|
|
{
|
|
"timestamp": "2022-02-25T21:30:45Z",
|
|
"event": "MissionCompleted",
|
|
"Faction": "Social LHS 6103 Confederation",
|
|
"Name": "Mission_Courier_Elections_name",
|
|
"MissionID": 850025233,
|
|
"TargetFaction": "Delphin Blue Federal PLC",
|
|
"DestinationSystem": "Delphin",
|
|
"DestinationStation": "Aristotle Orbital",
|
|
"Reward": 122300,
|
|
"FactionEffects": [
|
|
{
|
|
"Faction": "Social LHS 6103 Confederation",
|
|
"Effects": [
|
|
{
|
|
"Effect": "$MISSIONUTIL_Interaction_Summary_EP_up;",
|
|
"Effect_Localised": "The economic status of $#MinorFaction; has improved in the $#System; system.",
|
|
"Trend": "UpGood"
|
|
}
|
|
],
|
|
"Influence": [],
|
|
"ReputationTrend": "UpGood",
|
|
"Reputation": "+"
|
|
},
|
|
{
|
|
"Faction": "Delphin Blue Federal PLC",
|
|
"Effects": [],
|
|
"Influence": [],
|
|
"ReputationTrend": "UpGood",
|
|
"Reputation": "+"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
Here the is known that at the time of completion the Confederation was in an Election and could not
|
|
have gained any influence regardless. It is unclear whether this also holds true for Delphin Blue
|
|
Federal PLC. So to be save, the tool assumes that if no influence was gained for the source faction,
|
|
it still has to make an entry for the source system. The same applies for the target faction: if no
|
|
influence is gained for the target faction, still add an entry for the target faction in the missions
|
|
target system.
|
|
|
|
Since it is not possible to differentiate between missions that give no influence no matter what, and
|
|
no influence gained because of an election, we have to assume it *gave* influence and let the user
|
|
decide whether it was because of an election, or not.
|
|
|
|
Future tool versions should probably take faction states into account in such matters.
|
|
|
|
## Nothing's Perfect
|
|
|
|
The tool itself is still a work in progress, and it might miss something. If you think the tool
|
|
missed a task you have done, please contact `Hekateh` on the Elite Dangerous community discord.
|
|
It would be helpful if you included the JSON player journal. This player journal can be found here:
|
|
|
|
```
|
|
%userprofile%\saved Games\Frontier Developments\Elite Dangerous\
|
|
```
|
|
|
|
## Build Dependencies
|
|
|
|
Handling of Elite Dangerous player journals have been moved to a separate project called `EDJournal`.
|
|
Its source can be found [here](https://git.aror.org/florian/edjournal). This project simply depends
|
|
on the binary DLL that `EDJournal` builds.
|
|
|
|
The project also requires `Ookii.Dialogs.WPF` controls, which contains the auto complete text box.
|
|
|
|
And of course, `Newtonsoft.Json` as the JSON parser.
|
|
|
|
## About
|
|
|
|
This tool was made by CMDR Hekateh (Discord: `nola#2457`).
|
|
|
|
Long live the Empire. |