WindrosePlus Live Map

The Windrose+ Live Map (Sea Chart) displays real-time player positions and creature locations on an interactive map of the game world. It runs inside the Windrose+ Dashboard and requires no client-side mods or additional software.

What the Live Map Shows

The Sea Chart renders the game world terrain as a tiled map and overlays live entity data on top of it:

• Player positions - Shown as gold/white circle markers with player names displayed next to each marker.
• Creature positions - Shown as small red circle markers. Hover over a marker to see the creature type.

The map uses the Leaflet mapping library and supports standard map interactions including zoom, pan, and click-to-inspect.

How to Access the Live Map

There are two ways to reach the Sea Chart:

From the Dashboard

1. Open the Windrose+ Dashboard URL shown on your game server page in the control panel.
2. Log in with your RCON password.
3. Click the Sea Chart tab in the dashboard navigation.

Direct URL

The live map is also available at a direct URL by appending /livemap to your dashboard address. For example, if your dashboard is at http://your-server-ip:8780, the live map is at http://your-server-ip:8780/livemap.

Authentication is required. If you are not logged in, you will be redirected to the login page first.

How Map Data Is Generated

The terrain map tiles must be generated before the Sea Chart can display the world. This happens in two steps:

1. Automatic generation - Map coordinate data is created automatically the first time a player connects to the server while Windrose+ is running.
2. Terrain export - For the full tiled terrain view, run the wp.mapexport command via the RCON console. This exports the heightmap as image tiles that the Sea Chart renders.

If no map data exists yet, the Sea Chart will display the message: "No map data. Export terrain first with wp.mapexport."

The wp.mapgen command generates heightmap data for coordinate mapping, while wp.mapexport creates the visual terrain tiles. Both only need to be run once per world.

Marker Types

Marker	Color	Size	Represents
Player	Gold/white circle with name label.	14px diameter.	A connected player's current position.
Creature	Red circle.	8px diameter.	A spawned mob or creature in the world.

Player markers include a text label showing the player's name. Creature markers show the creature type name on hover.

Refresh Intervals

The live map polls the server API for updated entity positions at regular intervals:

Data	Refresh Rate	Notes
Players and creatures	Every 5 seconds.	Both player and mob positions are fetched in a single API call.
Terrain tiles	Static (cached).	Tiles are generated once and cached for 24 hours. Run wp.mapexport again if the world terrain changes significantly.

All position data comes from the /api/livemap endpoint on the Windrose+ HTTP server. The server collects position data from the game engine and writes it to a JSON file that the API serves.

Map Controls

The Sea Chart supports standard interactive map controls:

• Zoom - Use the scroll wheel or the + / - buttons in the top left corner.
• Pan - Click and drag to move around the map.
• Zoom to fit - The map automatically fits to the island bounds when first loaded.

The map constrains panning to the world boundaries so you cannot scroll into empty space.

Troubleshooting

Problem	Solution
"No map data" message.	Run wp.mapexport from the RCON console to generate terrain tiles.
Map loads but no players shown.	Verify at least one player is connected. Player data updates every 5 seconds.
Map tiles are blank or missing.	Run wp.mapexport again. The export may have been interrupted.
Cannot access the live map URL.	Make sure Windrose+ is enabled and the server is running. Check that the RCON password is set.
Login page keeps appearing.	Sessions expire after 24 hours. Log in again with your RCON password.

See Also

• Windrose+ Setup Guide
• Windrose+ RCON Console
• Windrose: Server Configuration
• Windrose: Server Setup Guide
• Windrose: Admin Commands
• Windrose server hosting