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