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!

Player head images work differently depending on your edition:

Java Edition (Automatic)

On Java Edition, player head images are fetched automatically from each player's Minecraft skin using their UUID. No manual setup is needed - player heads will appear on the map using their actual in-game skins.

Bedrock Edition (Manual Upload)

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 without a custom head image will display the default player icon.

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

• Bedrock: Type /bedrockmap:marker in chat - a form dialog will appear
• Java: Type /bedrockmap marker in chat - an inventory GUI will open

1. Choose to Add or Remove a marker
2. 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
3. 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:

Bedrock Edition

• 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

Java Edition

• Plugin not loading:
  • Verify you're running Java 21 or later
  • Check that the .jar is in the correct folder (plugins/ for Paper/Spigot, mods/ for Fabric)
  • For Fabric, ensure Fabric API is also installed
  • Run /plugins to check if the plugin is loaded (Paper/Spigot)
• Players not appearing on map:
  • Verify player tracking is enabled in addon settings
  • Ensure the server has internet access to reach the BedrockMap API
  • Check server console for API connection errors

Both Editions

• API key errors:
  • Ensure your Premium subscription is active
  • Try regenerating the API key if it's not working
  • Re-download the addon/plugin after regenerating the key