Skip to content

Repository files navigation

Note: If you're experiencing EDMC crashes on startup with v2.0.0 a fresh install of NeutronDancer will correct it.

Neutron Dancer Logo

Navl's Neutron Dancer

Python CodeQL GitHub Latest Version Github All Releases

Neutron Dancer makes neutron jumping easier by letting you plot a Spansh Neutron or Galacy route directly within EDMC; tracking progress along the route; and copying the next waypoint into your clipboard with a single click. It can work for almost any router by importing a CSV of the jumps.

The original goal of this fork was support for the new 6x overcharge of the Caspian Explorer and a cleaner UI. It has grown beyond that into a significant rewrite.

Route View

Key Features

  • Use Spansh's sophisticated Galaxy Plotter directly from EDMC without having to manually export, copy and paste ship builds.
  • Neutron Plotter, Road to Riches, Expressway to Exomastery, Trade Planner, Tourist Route, and Fleet Carrier Route planners are also supported.
  • Click the next destination button to copy it straight into your paste buffer.
  • Remembers your route, progress, ships, loadouts, and destinations across sessions.
  • Refuel locations and Neutron stars are highlighted.
  • Star name autocompletion
  • CSV import supports almost any route file, for any route type above or otherwise.
  • Route export makes it easy to save a route for later reuse.
  • Fleet carrier support includes jump countdown and cooldown tracking and cooldown notifications.
  • Tracks and reports statistics including jumps and distance per hour.
  • Single screen and VR support via
    • Modern Overlay for in game display of routes and countdown timers.
    • Chat commands (!nd next, !nd previous, !nd copy)
    • Hotkeys for next waypoint, previous waypoint, and copy to clipboard operations.
  • Full EDMC theme support

Installation

  • Download and unzip the latest EDMC-NeutronDancer.zip from here.
  • Open your EDMC plugins folder (in EDMC settings, select "Plugins" tab, click the "Open" button).
  • Create a folder inside the plugins folder and call it whatever you want, EDMC-NeutronDancer for instance.
  • Copy the unzipped files into this folder.
  • Restart EDMC.

Route Plotting

Idle View

By default Neutron Dancer starts in a minimized mode in order to be as unobtrusive as possible when not in use. To plot a route click do the neutron dance to open the route plotting form.

Neutron Dancer supports direct route creation for:

  1. The sophisticated Spansh Galaxy Plotter
  2. The simpler Spansh Neutron Plotter
  3. Road to Riches
  4. Expressway to Exomastery
  5. Trade Planner
  6. Tourist Route
  7. Fleet Carrier Route

It also supports CSV file import for any of the above, or any other Spansh route export.

Galaxy Plotting

To use the Galaxy Plotter, also known as the exact plotter, enter your source and destination systems, select the ship and set any other options and choose Calculate. The Galaxy Plotter options are explained in the help window as well as at Spansh.

Galaxy Plotter

When you complete a route Neutron Dancer saves the source, destination, and ship details for easy entry. These are available from a right click menu to simplify entry.

Note: In order to perform a galaxy plot the Neutron Dancer needs the full loadout of the ship you intend to use. For Neutron Dancer to know this information you must have switched to this ship to plot a route for it.

Neutron Plotting

This works like the Galaxy plotter but is simpler and produces less efficient routes.

Neutron Plotter

Road to Riches and Expressway to Exomastery

Road to Riches and Expressway to Exomastery (Exobiology) work the same way.

Expressway to Exomastery

Trade Planner

Trade routes are fully available.

Trade Planner

Tourist Route

Tourist routes are also supported.

Touriste Route

Fleet Carrier Router

This is the final supported route type.

Fleet Carrier Router

Following the Route

Route View

Once your route is plotted, the next waypoint is shown on the System Name button — click it to copy that waypoint to your clipboard. In Elite Dangerous bring up the Galaxy Map, paste in the waypoint, and click Plot route.

If for some reason your clipboard is empty or contains other stuff that you copied yourself, click the System Name button again to re-copy the waypoint.

The progress bar has a Tooltip that provides the number of jumps remaining and distance remaining if those values are known.

Viewing the Route

Route Window

The Show route button will open a window showing progress and the details of the plotted route. The current waypoint is hightlighted and progress includes waypoints completed and remaining, distance completed and remaining, jumps and lightyears per hour. For each jump the details include waypoints, distance traveled and remaining, fuel used and remaining, tritium used and remaining, whether to refueld and whether a star is a neutron star or scoopable depending on the type of route being followed.

CSV Import

Neutron Dancer is very flexible about CSV formats. It requires a column called "System Name" or "system" and will accept any other columns provided. If there are columns for remaining distance or number of jumps it will use those to calculate those values. If there is a column for refueling it will use that too.

Route Export

The Export route button will open a file dialog allowing you to save the current route as a CSV.

Overlays

This requires the EDMC Modern Overlay to be installed, older overlays aren't supported.

Three overlays are available.

  1. Default displays the next jump in the current route and other details in the ship main window
  2. Galaxy Map replaces the default frame when in the Galaxy Map and displays just the jump destination
  3. Carrier displays carrier jump and cooldown timers

Each can be individually enabled and frame size, color, position, background, text alignment etc. are all configurable.

Route Overlay

The Default frame can be further customized with:

  • A progress bar showing route progress
  • A customizable route details string that can display a wide variety of route information

Overlay Customization

Chat Commands

This enables management of Neutron Dancer without tabbing out of the game. Simply bring up a chat window and type in !nd and a command. Supported commands are:

  • next – move to the next waypoint
  • previous (or just prev) – move to the previous waypoint
  • copy – re-copy the next waypoint into the past buffer

Hotkeys

If you install the EDMC Hotkeys plugin you can define hotkeys for the next, previous and copy commands.

Saving State

If you close EDMC, the plugin will save your progress. The next time you run EDMC, it will continue from where you left off and even catch up any progress made while EDMC was inactive.

It also saves ship details and source and destination systems for easy entry.

Linux Clipboard

This is notoriously variable and problematic. Neutron Dancer tries to find wl-copy, xsel and xclip based on the current session. If it doesn't find anything appropriate it runs all of them that exist. If it can't find any of them it falls back to using the Tk native method.

If you have problems with waypoints not being put into the clipboard you can override all of this by setting an environment variable EDMC_CLIPBOARD_CLI to the command you wish to use before running EDMC. e.g.

export EDMC_CLIPBOARD_CLI="/usr/local/random/xsel --clipboard --input"
/usr/bin/python EDMarketConnector.py

Note, if you're running Flatpak and still having problems even with the environment variable set, check that EDMC is allowed to run the command you're referencing and allowed to follow any symlinks.

Credits

The biggest thank you must go to CMDR Spansh for the amazing Spansh Route Planners.

This code is based on the original Spansh router by CMDR Kiel42, RadarCZ's, and Norohind's forks.

Suggestions

Please let me know if you have any suggestions or find any bugs by submitting an issue, and if you like Neutron Dancer I don't need a coffee, I live in Seattle so I'm plenty caffeinated already, but please give it a ⭐ and consider donating to CMDR Spansh's patreon.

Fly dangerous! o7

About

Advanced Neutron (and any Spansh) Jump Plotter for EDMC

Topics

Resources

Security policy

Stars

23 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages