Troubleshooting

Server Does Not Start

Check:

1. Port is not already used by another process.
2. ServerProperties.json is valid JSON.
3. Correct McHttpConfig.Hostname format (http://.../) and McWssConfig.Hostname (ws://.../).

Client Cannot Connect

• Confirm server IP/port in client.
• Verify firewall and NAT.
• Ensure PositioningType matches on both client and server.

McHttp Not Working

• Check McHttpConfig.Enabled = true.
• Check LoginToken used in /voicecraft:vcconnect (or /vcconnect if alias is supported).
• Ensure addon is attached to the world and permissions are configured.

McWss Not Working

• Check McWssConfig.Enabled = true.
• Run /connect <host:port> before /voicecraft:vcconnect.
• Verify token.

No Audio

• In client, check Input Device / Output Device.
• Ensure Mute / Deafen are not enabled.
• Check InputVolume, OutputVolume, MicrophoneSensitivity.
• Run Microphone Test and Test Output.

Useful Diagnostics

• Restart both client and server.
• Temporarily revert to default config to narrow down the issue.
• On server, run list --clientsOnly and verify players are visible as clients.