Live Map Tracking

Visualize player positions on a 2D map image in real time, with calibration controls for camera height, FOV, rotation, scale, and pixel offsets.

Overview

The Live Map Tracking tab lets you visualize player positions on a 2D map image. Players broadcast their world coordinates to the dashboard, and the server projects those coordinates onto your map image using camera and calibration settings.

Setup

• Map Image URL — a publicly accessible image of your map. Discord and Imgur direct links work.
• Live Map API Key — generated automatically. Your in-game script sends this key along with player positions.
• Camera Preset — choose Small, Medium, Large, or X-Large based on your map size. You can also create custom presets by entering a map size in studs.
• Image Dimensions — use Auto-Detect or enter the pixel width and height of your map image manually.

Calibration

After uploading your map, use the Fine-Tune controls to align player dots:

• Move Up / Down / Left / Right — shifts the map center in 10-stud increments to center your spawn point.
• Rotate Left / Rotate Right — rotates the map view in 15-degree increments if North in-game does not match North on the map.
• Map Scale — a multiplier applied to the final pixel offset. Use this if distances look wrong (players too spread out or too close together).
• Map Offset X / Y — pixel-level nudge for the entire map when the whole image is shifted.

Always click Save Calibration Settings after adjusting. Changes are not saved automatically.

How Polling Works

• The dashboard only polls for positions while the Live Map Tracking tab is active. Switching tabs stops the requests.
• Positions are fetched every 2 seconds by default.
• Browser/Next.js caching means you will often see 304 responses. This is normal and reduces database load.
• If the game server closes and stops broadcasting, the dashboard automatically clears all player dots after 15 seconds of no updates.