McWss for Singleplayer Worlds

McWss is suitable for local/testing scenarios and singleplayer worlds.

Important

• This mode is less stable than McHttp.
• For public production servers, McHttp is recommended.

Requirements

1. VoiceCraft.Server with McWssConfig.Enabled: true.
2. VoiceCraft.Addon.Core.McWss.zip addon.

Installation

Option 1 (mcaddon import)

1. Rename archive to VoiceCraft.Addon.Core.McWss.mcaddon.
2. Open the file so Minecraft imports the addon.
3. Enable VoiceCraft.Addon.Core.McWss.BP and VoiceCraft.Addon.Core.McWss.RP in world.

Option 2 (manual copy)

1. Extract archive.
2. Copy RP and BP to Minecraft Bedrock directories.
3. Enable both packs in target world.

Connection

1. In world, run the websocket connect command:

/connect <VOICECRAFT_HOST>:<MCWSS_PORT>

Example:

/connect 127.0.0.1:9051

2. Authenticate with token:

/voicecraft:vcconnect <LOGIN_TOKEN>

Use LOGIN_TOKEN from McWssConfig.LoginToken.

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

Tuning

If you see lag/crashes:

• reduce CommandsPerTick,
• check MaxStringLengthPerCommand,
• test disabling selected packet types in DisabledPacketTypes when needed.