How to install the Java Premium Plugin

Before you begin, ensure you meet these requirements:

• BedrockMap Premium subscription (required)
• Java Edition server running one of the following:
  • Paper or Spigot version 1.21.4 or later
  • Fabric version 1.21.4 or later (with Fabric API mod installed)
• Java 21 or later installed on your server
• Server must be accessible from the internet (for API calls)

Download the plugin from your BedrockMap dashboard:

1. Go to your world's management page in the BedrockMap dashboard
2. Click the Premium Addon tab
3. Click Generate API Key if you haven't already
4. Choose your server platform:
   • Click Download Paper/Spigot Plugin (.jar) for Paper or Spigot servers
   • Click Download Fabric Mod (.jar) for Fabric servers
5. Save the .jar file to a location you can access

Installation depends on your server platform:

Paper / Spigot

1. Stop your server
2. Place the downloaded .jar file into your server's plugins/ folder
3. Start your server

Fabric

1. Stop your server
2. Ensure you have the Fabric API mod installed in your mods/ folder
3. Place the downloaded .jar file into your server's mods/ folder
4. Start your server

The plugin will auto-configure itself on startup using the embedded API key. You should see BedrockMap Premium Addon - Loaded! in your server console.

Configure how the plugin behaves from the BedrockMap dashboard:

• Live Player Tracking: Toggle on/off to show player positions on the map in real-time
• Marker Permissions: Choose who can add markers from in-game:
  • Owner Only: Only you can add markers
  • Anyone: All players can add markers
  • Whitelist: Only approved players (comma-separated list)

These settings take effect immediately without requiring a server restart.

On Java Edition, player head images are handled automatically:

• The plugin automatically fetches each player's Minecraft skin using their UUID
• Player head icons on the map are generated from their actual in-game skins
• No manual image uploads are needed
• Skin updates are reflected automatically

Verify the plugin is working correctly:

1. Start your Java Edition server
2. Join the server in Minecraft
3. Type /bedrockmap marker in chat
4. An inventory GUI should open allowing you to add or remove markers
5. Open your map at bedrockmap.net/map/your-world-slug
6. You should see your player marker appear within 5 seconds

If the marker command opens the GUI and your player appears on the map, the plugin is installed correctly!

If the plugin isn't working as expected:

• Plugin not loading:
  • Verify you're running Java 21 or later (java -version)
  • Check your server console for error messages on startup
  • Verify the .jar is in the correct folder (plugins/ for Paper/Spigot, mods/ for Fabric)
  • For Fabric, ensure Fabric API is also installed
• Players not appearing on map:
  • Verify player tracking is enabled in addon settings on the dashboard
  • Ensure your server has internet access to reach the BedrockMap API
  • Check server console for API connection errors
• Marker command not working:
  • Run /plugins (Paper/Spigot) to verify the plugin is loaded
  • Check that the player has permission (Owner/Whitelist/Anyone setting)
  • Restart the server if the plugin was just installed
• API key errors:
  • Ensure your Premium subscription is active
  • Try regenerating the API key on the dashboard
  • Re-download the plugin after regenerating the key