DTNR Nav Tool

1  Introduction

The DTNR Nav Tool is the central desktop application of the Daymar Tactical Navigation & Racing Project. It serves as a navigation tool for the moon Daymar in the game Star Citizen and offers extensive features for maps, route planning, live tracking and race participation.

The application displays an interactive satellite map of Daymar using Mercator projection, on which you can track your current position, plan routes and navigate to Points of Interest (POIs).

What can the Nav Tool do?

• Interactive map of Daymar with zoom, panning and infinite scrolling
• Automatic position query from Star Citizen
• Create and edit up to 10 simultaneous routes
• Navigation with bearing display, distance and ETA
• Route recording (tracking) with export
• Day/night rendering with realistic terminator
• Race participation via the integrated race server
• Configurable status overlay and hotkeys

2  Installation and First Launch

Installation

Use the DTNR Installer to install the Nav Tool. The Nav Tool is the required component – the Race Tool is optional. There is no longer a standalone Transponder Tool – the transponder is fully integrated into the Nav Tool.

After installation, you can find the application under:

• Start Menu: DTNR Tool → DTNR Nav Tool
• Desktop: DTNR Nav Tool (if shortcut was created)

First Launch

The installer creates the following directory structure under C:\Program Files\DTNR-Tool:

System Requirements

• Windows 10 or 11
• Screen resolution: at least 1920×1080
• Star Citizen (for position queries)

3  User Interface Overview

The window is divided into three main areas:

Side Panel Tabs

The Menu Bar

4  The Map – Basic Operation

Moving and Zooming

The map repeats seamlessly in the horizontal direction – you can scroll infinitely left or right, just like a real world map.

Map Layers

Under Map in the menu bar you can switch between two map views:

• Daymar Primary – Primary map view
• Daymar Secondary – Secondary map view

Map Grid

Via Map → Show Map Grid you can toggle a latitude/longitude grid. The coordinates are labeled on the edges of the map.

Reading Coordinates

The current mouse position is shown in the bottom left as coordinates. Right-click on the map to copy the coordinates to the clipboard.

5  Points of Interest (POIs)

POIs are predefined landmarks on Daymar (settlements, outposts, notable locations). They are loaded from a CSV file.

Using the POI List

• Switch to the POIs tab in the side panel
• Use the search field at the top to filter POIs by name
• With Enable all / Disable all you control the visibility of all POIs on the map
• Use the checkbox to show/hide individual POIs

POI Columns

POI as Navigation Target

Click on a POI in the list to highlight it on the map. An activated POI can be used as a navigation target (see Chapter 8). A double-click on an empty area on the map deselects a waypoint.

6  Routes – Loading, Creating and Editing

The Nav Tool supports up to 10 simultaneously loaded routes. Each route has its own color and can be edited independently.

Load a Route

1. Select File → Load Route
2. Choose a .route file
3. The route appears in the Routes tab and on the map

Create a New Route

1. Select File → New Route
2. An empty route is created
3. Unlock the route (Context menu → Unlock)
4. Add waypoints by right-clicking on the map

Edit a Route (Unlock Mode)

A route must be unlocked to be editable. Right-click on the route in the tree → Unlock.

In unlocked mode you can:

• Rename waypoints – Double-click on the ID column
• Reorder waypoints – Right-click drag in the route tree
• Move waypoints on the map – Right-click drag on a waypoint marker
• Insert waypoints – Right-click on waypoint → New waypoint above/below
• Insert waypoints from the map – Right-click on the map → Create new waypoint
• Remove waypoints – Right-click on waypoint → Remove waypoint

Save a Route

Right-click on the route in the tree → Save or Save as. Routes are saved as .route files in JSON format and can be edited with any suitable editor at any time.

Context Menu Overview

7  The Official Route

Independent of your own routes, you can load and display the official route. The official route is not shown in the route window. Loading an official route is necessary to calculate the distances to the next stage and to the finish in the Official Route Progress section of the Nav area.

Loading and Displaying

• Map → Load Official Route – Select a .route file
• Map → Show Official Route – Toggle On/Off

Rendering

The official route is rendered with special styling:

• Wide, semi-transparent corridor along the track
• Direction arrows indicating the driving direction
• Start flag (pennant) at the beginning
• Finish flag (checkered pattern) at the end
• Labels at all waypoints (if available)

Navigation Along the Official Route

The Nav tab shows additional information about the official route:

• Direction and distance to the next stage target
• Remaining total distance to the finish

8  Navigation

The Nav tab provides a full navigation display with bearing, distance and ETA.

Activating Navigation

Prerequisites:

• A route must be set as navigation route (Context menu → Use for Navigation) or a POI must be selected
• Position data must be received

Navigation Modes

Navigation Display

In the Nav tab you can see:

• Next Target – Name of the current waypoint/POI
• Bearing – Direction to target in degrees
• Heading – Your current driving direction
• Distance – Distance to the target
• ETA – Estimated time of arrival

Map Visualization

With active navigation, the map shows:

• A position marker at your current location
• A target line from your position to the next waypoint
• A compass ring with degree markings and heading line

9  Tracking – Route Recording

Tracking records your drive on Daymar as a series of points.

Starting Tracking

• In the Track tab, set the Tracking switch to On
• Or use the configured hotkey

When activated, a new track file is automatically created. Each received position point is recorded with a timestamp.

Track Points

In the Track tab you can see all recorded points with:

• Point number (TP1, TP2, …)
• Latitude / Longitude
• Timestamp

Editing and Saving Tracks

Via the context menu in the Track tab you can:

• Remove individual points
• Rename the track file
• Save the track file (as .track file)
• Save as route (converts track to route)

Track Rendering

• Show tracking – Toggle the recording on/off on the map
• Choose tracking color – Adjust the color of the tracking line

The tracking trail is displayed as a dashed line with high contrast (black base + colored dashes).

10  Day/Night Rendering

The Nav Tool calculates the current illumination on Daymar based on the position of the sun in the Star Citizen universe.

Settings

Via Map → Day/Night Rendering you can open the configuration dialog:

How It Works

The day/night calculation uses the astronomical position of the sun in the game universe. The transition between day and night is smooth (no hard cut) to realistically represent the twilight zone.

11  The Status Overlay

The Status Overlay is a semi-transparent, freely movable panel that always floats in front of the map. It can be toggled via Map → Overlay.

Displayed Information

The overlay shows the status of all important systems at a glance:

Additional Displays

• Mini compass with direction and bearing to target
• Countdown until next position query (large red display in the last 10 s)
• Navigation values (target, direction, distance) – when navigation is active

12  Progress Tab – Performance Analysis

The Progress tab shows real-time performance data during driving.

Key Metrics

• Current average speed – Moving average of the latest measurement points
• Overall average speed – Across the entire distance driven so far

Charts

• Speed over Distance – Shows your speed along the distance covered. Newer data points receive more space on the X axis.
• Route Speed Profile – Shows your speed across the entire route distance with waypoint markers.

13  Team and Transponder Settings

Team Tab

In the Team tab you enter your identification data:

This data is automatically saved in the transponder configuration and used for race registrations.

Race Controls in the Team Tab

• Share Route – Shares your navigation route with the race server (only active when a navigation route is set)
• Team Ready – Signals the race server that your team is ready to start

Position System (Integrated Transponder)

The transponder is fully integrated into the Nav Tool. Via Settings → Position System you configure the automatic position query:

In the Team tab, the transponder can be turned on and off at any time via the Transponder switch (On/Off).

14  Race Participation from the Nav Tool

You can participate in races directly from the Nav Tool that were created in the Race Tool.

Registering for a Race

1. Open Race → Manage Participation
2. Select a race from the list of scheduled races
3. Click Register
4. Wait for the race director to approve your registration

Joining a Race

After approval, the race appears in the list of approved races. Click Join.

When joining, the following is automatically adopted from the server:

• The official race route
• The position update interval
• The transponder requirement (if activated by the race director)

Race Start and Countdown

When the race director starts the race, a countdown overlay with large font display appears on your screen. At race start, Transponder and Position Update are automatically activated.

Ending a Race

Via Race → End Race you leave the active race. Your previously loaded official route is restored.

15  Hotkeys

Via Settings → Hotkeys you configure system-wide keyboard shortcuts:

The hotkeys work system-wide – even when the Nav Tool is in the background.

16  File Formats

Route (.route)

JSON file with header data and a list of waypoints:

• name – Name of the route
• date – Creation date
• driver – Creator
• comment – Comment
• WPoints – List of waypoints (longitude, latitude, height, name, id)

Track (.track)

Like a route, but additionally with timestamps per point. Can be converted to a route via the context menu.

Configuration (.json)

The main configuration is located at Nav-Tool\config\config.json and contains all map, network and display settings.

17  Troubleshooting

Log files can be found under Nav-Tool\logs\.