BDS Server Pack Installation

Bedrock Voice Chat requires a server-side behavior pack to relay player positioning data to the BVC Server. Operators must install and configure this pack before any client can connect.

Installation

1. Download the latest behavior pack from the Github Releases page (.zip or .mcpack).
2. Place the pack in your BDS instance's root behavior_packs/ directory. Do not extract.

Never upload the pack to your worlds/ folder — doing so can leak your BVC server URL and access token if the world is shared.

3. If you are not using a pre-baked pack with credentials embedded, create or edit config/default/variables.json:

{
    "bvc_access_token": "<MUST_MATCH_server.minecraft.access_token_FROM_config.hcl>",
    "bvc_server": "https://your.bvc-server.tld",
    "bvc_minimum_players": 1
}

Key	Description
bvc_access_token	Must match server.minecraft.access_token in your BVC server's config.hcl.
bvc_server	Public URL of your BVC server (no trailing slash, include port if non-443).
bvc_minimum_players	Sets the minimum number of players BVC must see to broadcast data. Defaults to 1

4. Update config/default/permissions.json to grant the modules the pack uses:

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

5. Enable Beta APIs for your world.
6. Add the pack to your world's behavior pack list. UUID 6fb24263-357a-407c-aebe-681f50b2de50, version [0, 0, 3].
7. Start (or restart) BDS.

Troubleshooting

• Set content-log-console-output-enabled=true in server.properties. You should see [BVC] Connecting to: <host> on world load — if not, the pack isn't running or bvc_server is unset.
• Whitelist players in BVC before they try to log in (see the CLI guide).
• As a bandwidth-saving measure, BVC may suppress position relays when only one player is online. Set bvc_debug: true to force relays for solo testing.
• GET /api/config should return JSON — confirms the BVC server is reachable.
• GET /api/position with header X-MC-Access-Token: <your_token> shows current player positions. An empty response means BDS isn't relaying.