How to install the Premium BedrockMap addon

Before you begin, ensure you meet these requirements:

• BedrockMap Premium subscription (required)
• Bedrock Dedicated Server (BDS) - Windows or Linux
• Your world must have Beta APIs enabled
• Server must be accessible from the internet (for API calls)
• Server administrator access to modify configuration files

Most users don't have Minecraft installed on their server machine, so you'll need to download your world to your local PC first:

1. Stop your Bedrock Dedicated Server
2. Download your world folder from the server using one of these methods:
   • FTP/SFTP: Use an FTP client like FileZilla to download the world folder
   • Server Control Panel: Many providers (like Aternos) offer file download through their web interface
   • Direct Access: If you have direct server access, copy the world folder to your local machine
3. Locate the downloaded world folder on your local PC

The addon requires Beta APIs to function. Enable them on your local PC:

1. Open the downloaded world folder in Minecraft on your local PC
2. Go to Settings → Experiments
3. Toggle Beta APIs to ON
4. Save the world

Alternatively, you can edit the world's level.dat file directly using an NBT editor.

You must modify your server's permissions file to allow the addon's network module:

1. Stop your Bedrock Dedicated Server
2. Navigate to your server directory
3. Open config/default/permissions.json
4. Add @minecraft/server-net to the allowed_modules array
5. Save the file

Your permissions.json should look like this:

{
  "allowed_modules": [
    "@minecraft/server-gametest",
    "@minecraft/server",
    "@minecraft/server-ui",
    "@minecraft/server-admin",
    "@minecraft/server-editor",
    "@minecraft/server-net"
  ]
}

Generate your unique API key and download the addon from BedrockMap:

1. Go to your world's management page in the BedrockMap dashboard
2. Click the Premium Addon tab
3. Click Generate API Key & Download
4. Your unique API key will be generated and displayed
5. Click Download BedrockMap Addon (.mcpack)
6. Save the file to a location you can access

Install the downloaded .mcpack file on your local PC with Minecraft:

1. Double-click the .mcpack file you downloaded from BedrockMap
2. Minecraft will open and auto-import the behavior pack
3. Close Minecraft
4. Open the world you downloaded from the server in Minecraft
5. Go to Settings → Add-Ons (or Behavior Packs)
6. Find the BedrockMap Premium addon in the available packs
7. Activate it for your world
8. Save the world

Now that Beta APIs are enabled and the addon is installed, transfer the world back to your server:

1. Locate your world folder on your local PC (usually in %appdata%\Minecraft Bedrock\Users\minecraftWorlds\ on Windows)
2. Upload the world folder back to your server using the same method you used to download it:
   • FTP/SFTP: Upload the world folder to replace the old one
   • Server Control Panel: Use your provider's file upload feature
   • Direct Access: Copy the world folder directly to the server
3. Ensure the world folder is in the correct location on your server (usually worlds/[YourWorld]/)

Configure how the addon behaves from the BedrockMap dashboard:

• Live Player Tracking: Toggle on/off to show player positions on the map
• 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.

Customize player markers with custom player head images:

1. Go to the Premium Addon tab in your world management page
2. Scroll to the Player Head Images section
3. Enter the exact player name (case-sensitive)
4. Click Upload Image and select a square image (recommended: 64x64 pixels)
5. The image will appear on the map for that player

Players without a custom head image will display the default player icon.

Start your Bedrock Dedicated Server and verify the addon is working:

1. Start your Bedrock Dedicated Server
2. Join the server in Minecraft
3. Type /bedrockmap:marker in chat
4. A form should appear - if it does, the addon is installed correctly!
5. Open your map at bedrockmap.net/map/your-world-slug
6. You should see your player marker appear within 5 seconds

If player markers don't appear, check your server console for errors and verify that Beta APIs are enabled.