How to use the Live Player Positions and Markers addon

Live player tracking is a Premium feature that shows real-time player positions on your map:

• Player positions update every 5 seconds automatically
• Works across all three dimensions (Overworld, Nether, End)
• Displays custom player head images or default icons
• Shows online/offline status
• Automatically removes offline players after 30 seconds

Enable live player tracking from your world settings:

1. Go to your world's management page in the BedrockMap dashboard
2. Click the Premium Addon tab
3. Find the Addon Settings section
4. Toggle Live Player Tracking to ON
5. Changes take effect immediately (no server restart needed)

When enabled, player data from your server will be sent to BedrockMap and displayed on your map.

Once enabled, players will appear on your map automatically:

• Open your map at bedrockmap.net/map/your-world-slug
• Player markers appear as head icons with the player's username displayed alongside
• Switch dimensions to see players in the Nether or End

Player positions update every 5 seconds, so you'll see movement in near real-time!

Upload custom player head images to personalize player markers:

1. Go to the Premium Addon tab
2. Scroll to Player Head Images
3. Enter the exact player name (case-sensitive, must match in-game name)
4. Click Upload Image
5. Select a square image file (recommended: 64x64 pixels, PNG format)
6. The custom head will appear on the map within seconds

Players can add and remove markers directly from Minecraft using the addon command:

1. In-game, type /bedrockmap:marker in the chat
2. A form will appear asking if you want to Add or Remove a marker
3. If adding a marker:
   • Title: Name of the marker (e.g., "My Base")
   • Description: Optional details about the location
   • Marker Type: Icon style (house, flag, star, etc.)
   • The marker will appear on your map at your current location
   • Coordinates and dimension are detected automatically
4. If removing a marker:
   • A list of markers you've personally added will appear
   • Select the marker you want to remove
   • Confirm to delete it from the map

Permissions for who can add and remove markers are configured in the addon settings (Owner Only, Anyone, or Whitelist).

Control who can add and remove markers from in-game:

• Owner Only: Only you (the world owner) can add and remove markers via the addon
• Anyone: All players on the server can add and remove markers
• Whitelist: Only specific players you approve can add and remove markers
  • Enter player names in the whitelist field (comma-separated)
  • Names must match exactly (case-sensitive)
  • Changes take effect immediately

Configure this in the Addon Settings section under the In-Game Marker Permissions dropdown.

Markers added via the in-game command can be managed from the dashboard:

• Go to your world management page
• Click the Markers tab
• All markers (dashboard-created and in-game) appear in the list
• In-game markers show the author's username
• Click Edit to modify a marker's details
• Click Delete to remove a marker

You can also customize colors, fonts, and styling for in-game markers after they're created.

If player tracking or in-game markers aren't working:

• Players not appearing on map:
  • Verify player tracking is enabled in addon settings
  • Check that the addon is installed on your server
  • Ensure Beta APIs are enabled in your world
  • Verify @minecraft/server-net is in permissions.json
• Marker command not working:
  • Check that the player has permission (Owner/Whitelist/Anyone setting)
  • Verify the addon is properly installed and loaded
  • Restart the server if the addon was just installed
• API key errors:
  • Ensure your Premium subscription is active
  • Try regenerating the API key if it's not working
  • Re-download the addon after regenerating the key