McHttp for Bedrock Dedicated Server

McHttp is the recommended integration mode for BDS.

Requirements

1. Running VoiceCraft.Server with McHttpConfig.Enabled: true.
2. VoiceCraft.Addon.Core.McHttp.zip addon from releases.
3. BDS server with beta/script API enabled (depends on Bedrock version).

Addon Installation

1. Extract VoiceCraft.Addon.Core.McHttp.zip.
2. Put RP into <MCServer>/resource_packs/.
3. Put BP into <MCServer>/behavior_packs/.

Module Permissions

Open <MCServer>/config/default/permissions.json and ensure it contains:

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

Connect Packs to World

In <MCServer>/worlds/<YourWorld>/world_behavior_packs.json, add:

{
  "pack_id": "71ebb3ba-e9db-4546-9520-05f20b17dcb6",
  "version": [1, 5, 1]
}

In world_resource_packs.json, add:

{
  "pack_id": "30b512be-77d1-4a61-bdb7-6c2f4062f889",
  "version": [1, 5, 1]
}

Connect in Game

In world, run:

/voicecraft:vcconnect "http://<VOICECRAFT_HOST>:<PORT>" <LOGIN_TOKEN>

Example:

/voicecraft:vcconnect "http://127.0.0.1:9050" e4ad1f7e-4f90-4b21-bc15-6febe580bf1c

Use LOGIN_TOKEN from McHttpConfig.LoginToken in ServerProperties.json.

If your Bedrock build supports a short alias, /vcconnect may also work, but the safe/default form is voicecraft:vcconnect.

Common Issues

• HttpListenerException on Windows: you may need netsh http add iplisten 127.0.0.1.
• In containers/VMs, use Hostname like http://0.0.0.0:9050/.
• Verify port availability and conflicts.