Description
Dynmap Radar
Display Dynmap players and markers directly on Xaero's World Map and Xaero's Minimap.
Features
Player Tracking
- Shows all online players from a Dynmap server on Xaero's World Map and Minimap
- Renders player heads using real Minecraft skins (vanilla
PlayerFaceRenderer) - Displays player names below heads (supports NAME / ACCOUNT display mode)
- Configurable head size, scale, and update interval
- Automatically excludes locally-loaded (nearby) players
- Minimap distance culling — hides players beyond configurable radius (default 200 blocks)
Marker Rendering
- Full support for four Dynmap marker types:
- Area — filled polygons with outline
- Circle — filled circles with outline
- Polyline — multi-segment lines (thick line via vertex quads)
- Point — custom icons downloaded from Dynmap with labels
- Icons auto-downloaded asynchronously and cached to disk
- Configurable marker scale, point icon scale, and follow-zoom behavior
- Separate layer visibility for world map and minimap — show/hide individual marker sets independently
- Minimap distance culling — hides distant markers beyond configurable radius (default 200 blocks)
Right-Click Menu (World Map)
- Copy Name — copy marker/player name to clipboard
- Copy Coordinates — copy
x y zto clipboard - Copy Full Info — copy name + coordinates + description (markers only)
- Teleport — teleport to the marker/player using Xaero's built-in teleporter (respects Xaero's teleport command settings)
- Create Waypoint — instantly create a Xaero Minimap waypoint at the marker/player location (configurable color)
Minimap Support
- Optional rendering of markers and player heads on Xaero's Minimap
- Shape rendering on minimap (area/circle/polyline) can be toggled separately
- Configurable distance culling radius to keep minimap clean
Dependencies
- Xaero's World Map
- Xaero's Minimap
- A server running Dynmap
Quick Start
- Install the mod and dependencies
- Join a server that has Dynmap running
- Set the Dynmap URL:
/dradar settings url set http://yourserver.com:8123 - Open Xaero's World Map — players and markers will appear
- Right-click any marker or player for options (copy, teleport, create waypoint)
Important Notes
- Rendering non-point markers in minimap is buggy, use with caution (toggle
minimapShapessetting) - Currently only supports servers which can see online map without authentication. Support for auth-protected servers may be added in the future.
Commands
All commands use /dradar
Settings
| Command | Description |
|---|---|
/dradar status |
Show current config |
/dradar settings <key> get |
Read a setting value |
/dradar settings <key> set <value> |
Write a setting value |
/dradar reload |
Reload the config file |
/dradar clearCache |
Clear all cached data and re-fetch |
Available settings keys:
| Key | Type | Default | Range | Description |
|---|---|---|---|---|
url |
string | "" |
— | Dynmap server base URL (e.g. http://example.com:8123) |
mode |
string | NAME |
NAME / ACCOUNT |
Player display mode |
headSize |
int | 24 |
8–64 | Player head icon size |
markerScale |
double | 2.0 |
0.1–10 | Overall marker render scale |
pointScale |
double | 1.0 |
0.25–10 | Point icon scale multiplier |
pointFollowZoom |
bool | true |
— | Point icon size follows map zoom |
headFollowZoom |
bool | false |
— | Head icon size follows map zoom |
showInMinimap |
bool | false |
— | Show markers/players on minimap |
minimapShapes |
bool | false |
— | Render area/circle/polyline shapes on minimap |
minimapCullRadius |
double | 200 |
10–10000 | Hide minimap elements beyond this radius (blocks) |
waypointColor |
int | 0xFFFFFF |
0–0xFFFFFF | Color of created waypoints (hex RGB, e.g. 0xFF5555) |
interval |
int | 1000 |
100–60000 | Data fetch interval in ms |
Layer Management
Layer visibility is managed separately for world map and minimap.
| Command | Description |
|---|---|
/dradar layer world list |
List all marker sets with world map visibility |
/dradar layer world show <setId> |
Show a marker set on world map |
/dradar layer world hide <setId> |
Hide a marker set on world map |
/dradar layer world showAll |
Show all marker sets on world map |
/dradar layer minimap list |
List all marker sets with minimap visibility |
/dradar layer minimap show <setId> |
Show a marker set on minimap |
/dradar layer minimap hide <setId> |
Hide a marker set on minimap |
/dradar layer minimap showAll |
Show all marker sets on minimap |
/dradar layer reset <setId> |
Reset layer to Dynmap server defaults |
Dimension Mapping
| Command | Description |
|---|---|
/dradar dim list |
Show current dimension mappings |
/dradar dim map <dynmapWorld> <xaeroDim> |
Map a Dynmap world to a dimension |
/dradar dim unmap <dynmapWorld> |
Remove a dimension mapping |
/dradar dim mapCurrent |
Map Dynmap "world" to current dimension |