Skip to content

dwomble/EDMC-NeutronDancer

Repository files navigation

neutrondancer_logo125

Navl's Neutron Dancer

Python CodeQL GitHub Latest Version Github All Releases

Neutron Dancer makes neutron jumping easier by plotting a route using Spansh within EDMC and automatically copying the next waypoint on the route to your clipboard. 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 and a cleaner UI. It has grown beyond that into a significant rewrite.

Screenshot 2025-12-27 164511

Key Features

  • Spansh Galaxy Plotting and Neutron Plotting directly from within EDMC
  • CSV import supports almost any route file including Road to Riches, Expressway to Exomastery, Tourist planner, and Fleetcarrier plotter
  • History tracking remembers your current waypoint as well as ships, loadouts, and destinations
  • Route export makes it easy to save a route for later reuse
  • Fleet carrier support includes jump cooldown tracking and notification
  • Tracks and reports statistics including jumps and distance per hour
  • Supports Modern Overlay for in game display
  • Supports chat commands (!nd next, !nd previous, !nd copy) for single screen operation

Installation

  • 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, NeutronDancer for instance
  • Download the latest release here and unzip it.
  • Open the folder you created and put all the files and folders you extracted inside
  • Restart EDMC

Usage

neutron_dance

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 two route creation methods:

  1. Direct plotting from Spansh Neutron Router or Spansh Galaxy Router
  2. CSV import from Spansh Road to Riches, Expressway to Exomastery, Tourist planner, Fleetcarrier plotter, etc.

Neutron Plotting

To use the Neutron Plotter, enter your source and destination systems, ship range, routing efficiency, and neutron jump multiplier. 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.

Screenshot 2025-12-27 164632

Next click Calculate to query Spansh and plot your route.

Galaxy Plotting

This works the same as the Neutron Plotter but because the Galaxy Plotter is much more sophisticated Neutron Dancer must have seen the ship you're going to use (you must have switched to it) in order to calculate all the details required. The options available are also more complex and using the wrong values can lead to getting stuck so make sure you understand them before taking a route.

Screenshot 2026-01-16 173246

Note In order to perform a galaxy plot the Neutron Dancer needs the full loadout of the ship you intend to use. This means you need to have switched to this ship for it to be able to plot it.

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.

To import a CSV click Import and select an appropriate file such as that exported by the various Spansh route plotters.

Following the route

Screenshot 2025-12-27 164511

Once your route is plotted, and every time you reach a waypoint, the next one is automatically copied 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 should be empty or contain other stuff that you copied yourself, click on the System Name button, and the waypoint will be copied again to your clipboard.

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

Show Route

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.

Export Route

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

Overlay Support

When you make a jump the next waypoint as well as your current statistics will be displayed on screen. This requires the EDMC Modern Overlay to be installed. To enable overlay display, in the ED:MC options select Navl's Neutron Dancer, enable Overlay and choose where and in which colour you want text to be displayed.

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-insert the next waypoint into the past buffer

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 catch up any jumps made while EDMC was inactive.

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

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 star.

Fly dangerous! o7

Packages

No packages published

Contributors 10

Languages