Skip to main content

Route Planner

Overview

The Route Planner panel helps you calculate optimal travel paths between systems—either through jump gates or mapped wormholes. It includes:

  • Action buttons for managing your route list.
  • A dynamic list of destination systems.
  • Automatic pathfinding based on wormhole and gate connections.

If a system is selected and has a valid route (gate or mapped wormhole), the planner automatically calculates the best path based on your preference: Shorter or Safer.
By default, the planner uses the Shorter route configuration.

info

WHMapper uses a custom-built algorithm to compute the most efficient route between systems.

Route Planner Module


Action Buttons

The action buttons vary depending on your user role:

Admin View

As an administrator, you can define a global list of key systems (e.g., Jita, Amarr). These will be visible to all characters with access to the map.

Admin Action Buttons

User View

As a regular user, you can still create your own custom system list, in addition to those defined by admins.

User Action Buttons


Add a System

To add a system to your route list:

  1. Click the Add button:

    • Admin: Admin Route Add Button
    • User: User Route Add Button
  2. The system search dialog appears:
    Search System Dialog

  3. Start typing the name of the system (e.g., Jita):
    Search System Dialog - Jita

    tip

    Enter at least 3 characters — the list will update in real time.

  4. Choose your action:

    • Click Add System to confirm.
      • Admin Example:
        Admin Route Jita Added
      • User Example:
        Admin Route Amarr Added
    • Click Cancel to close the dialog.

Edit a System

To modify your route list:

  • Click the Edit button: Edit Action Button

Once enabled, a delete icon will appear next to each entry.

Admin Permissions
  • Admins can remove both global and personal systems.
  • Regular users can only delete systems they personally added.

Admin View
Admin Edit Mode Enabled

User View
User Edit Mode Enabled


Delete a System

To remove a system from your list:

  1. Click the delete icon beside the system: Delete Action Button

  2. Confirm the action in the dialog:
    Delete Route Message


Automatic Path Calculation

How It Works

  1. Select a system on the map.
  2. The planner calculates jump distances between the selected system and each listed destination, based on the selected mode:
    • Shorter (default)
    • Safer

When a Route Exists

If a route is found, the number of jumps appears next to each destination.

Routes can be:

  • Fully mapped wormhole connections.
  • Standard stargate paths.

Examples:

  • Via wormhole:
    Route Is Up From WH

  • Via K-space gates:
    Route Is Up From Kspace


When No Route Exists

If no path is found, the jump count will show 0.

This can happen if:

  • The selected system is a wormhole with no mapped connections.
  • A listed system is isolated from the current network.

Example:
Route is Down From WH


Display a Route Path on the Map

You can visually display the route path (in yellow) between the selected system and any destination in your list.

Note

Only mapped systems are shown in the path.
Unmapped systems are not visualized even if the route technically exists.

Path Display Enabled

Toggle Path Display

  • To show a path:
    Click this icon beside the system: Show Path Button

  • To hide the path:
    Click the same icon again: Hide Path Button