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 z to 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

1. Install the mod and dependencies
2. Join a server that has Dynmap running
3. Set the Dynmap URL: /dradar settings url set http://yourserver.com:8123
4. Open Xaero's World Map — players and markers will appear
5. 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 minimapShapes setting)
• 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