Derail Valley Path Tracer

This is a mod for the video game Derail Valley created by Altfuture.
It periodically reports information about the player's journey through The Valley to a file in its directory.

Download: Nexus Mods
Install using Unity Mod Manager

What could this information be used for?

Map the routes you took, or timelapse your journey through The Valley, with the included animation tool!

But if you want to have a go yourself there's plenty of information to look at that the included tool doesn't touch.
Import the file into Google Sheets or equivalent and go ham!

Basic Usage

Path Tracer

• As of version 0.2.0 the tracer is always active by default.
  • This can be changed in the mod settings.
• While active, the tracer will periodically write information to a csv file in the sessions folder of the folder this mod was installed to.
  (i.e. /Derail Valley/Mods/DVPathTracer/sessions/<date_time>.csv)
  • By default a new file is created every session; if this is disabled in the mod settings each new session will overwrite the file DVTracedPath.csv.

Path Animator

• The included path timelapsing tool can be found in the folder pathAnimator in the folder this mod was installed to.
  (i.e. /Derail Valley/Mods/DVPathTracer/pathAnimator/)
  • For simplicity it is a static webpage hosted on your computer.
• Open the file pathAnimator.html with your browser (Chrome etc).
• Import your traced path manually or by dragging & dropping.
• For a background image, import the included world map (worldMap.png) using the same method.

What information does it report?

The tracer reports to a .csv file with the following information:

Player information:

The first 5 columns indicate information about you, the player:

• Time [s] Time since the tracer was activated.
• PPosX [m] Player's current x coordinate (distance from the West edge of the map).
• PPosY [m] Player's current height (above sea level).
• PPosZ [m] Player's current z coordinate (distance from the South edge of the map).
• PRotA [°] Player's current rotation about the vertical axis, in degrees from North (like a compass).

Rolling stock information:

The following columns indicate information about all spawned rolling stock, in sets of 11:

• CID The object's in-game identifier (e.g. L-001).
• CType The type of rolling stock (e.g. DE2).
• CPosX [m] Current x coordinate (distance from the West edge of the map).
• CPosY [m] Current height (above sea level).
• CPosZ [m] Current z coordinate (distance from the South edge of the map).
• CRotA [°] Current rotation about the vertical axis, in degrees from North (like a compass).
• CSpd [Default: kph] Current reported speed.
  • Imperial units can be enabled in the mod settings.
  • If the MPH mod is detected, imperial units will be enabled by default.
• C% [%] Car health
• CgType Type of loaded cargo (e.g. None, or Tractors)
• CgCat DVPT-specific cargo category if applicable (Currently Military, Hazmat or Inert)
• Cg% [%] Cargo health if applicable

Verbose tracing

With verbose tracing enabled, this information will be reported for every piece of rolling stock every iteration. Order is also preserved to an extent - information about each object will occupy the same column it started in until that object despawns. After the object despawns, until a new object takes its place, the tracer will fill that space with the column headings listed above.

With the default behaviour, information will only be reported when the object is moved or changes state. Naturally, this is a far more performant option.

Future Plans

• Remake the timelapsing tool for better performance and aesthetics.
• Improve ability to trace across multiple sessions.
• More included analysis tools.

Contributing

I greatly appreciate enthusiasm for my project and any offers to contribute, however I am hesitant to accept them for a number of reasons.
If you would like to contribute please let me know in advance - in either the issue tracker here or the official Altfuture Discord (@Talkingpeanut).

Many thanks

This mod uses code for registering custom in-game terminal commands (i.e. Commands.cs) created by Miles "Zeibach" Spielberg.
This and other resources used for this mod are listed in LICENSE_THIRD_PARTY.