#journal #dangerous #parser #models #progress #elite-dangerous #elite-journal

ed-journals

Provides models for representing and parsing elite dangerous journal files

8 releases (4 breaking)

0.5.1 Jul 26, 2024
0.5.0 Jun 16, 2024
0.4.0 May 26, 2024
0.3.0 May 21, 2024
0.1.2 May 5, 2024

#997 in Encoding

Download history 14/week @ 2024-06-21 110/week @ 2024-07-26 5/week @ 2024-08-02 10/week @ 2024-09-13 23/week @ 2024-09-20 17/week @ 2024-09-27 1/week @ 2024-10-04

51 downloads per month

MIT license

1MB
24K SLoC

ED Journals

Warn this project is currently in beta, which means that it is very much work in progress. Breaking changes are likely to happen.

Work in progress parsing and utilities for working with journal files from Elite Dangerous, with specific emphasis on creating structs and enums to make working with journal entries a lot easier and predictable.

Features and plans

This is a list of some of the current features and some of the features I really want to have added before a 1.0 release.

  • Models for journal directory and files.
  • Journal reader to read entries from journal files.
  • Serde models for journal entries.
  • Parsing dynamic files like Market.json, Status.json etc.
  • Async variants of models, especially the JournalReader.
  • Automatic journal detection based on platform etc.
  • Exobiology utilities for things like predicting available species based on planet scan etc.
  • Exploration utilities for pointing out special or unusual discoveries.

Contributing

One of the best ways to contribute to this project is by contributing journal logs to the test-suite. Doing this will allow the project to be more and more accurate. Note that this project currently only focuses on the live version of the game, so game version 4 and up.

You can contribute journal files by following these steps:

  1. Locate your journal files. On Windows they are saved at C:\users\<your username>\Saved Games\Frontier Developments\Elite Dangerous On Linux it depends on a number of things. Check our this forum post for more information.
  2. It's probably a good idea to anonymize your logs and remove some of the personal content. You can do so by using the ED logs anonymizer tool. Make sure to check some of the exported files to ensure everything has been processed correctly.
  3. Create a fork of the project and add your journal files to the test-jounals directory in the root of the project.
  4. Create a PR and wait for it to be merged.
  5. Thank you so much!

Dependencies

~5–15MB
~195K SLoC