McWss для одиночных миров

McWss это websocket / command-tunnel transport, который в основном используется для локальных миров и легких Bedrock-сценариев.

Когда использовать

Используйте McWss, если:

• вы играете в локальном Bedrock-мире
• нужен быстрый singleplayer setup
• вы тестируете addon-логику без отдельного BDS

Важные ограничения

• обычно менее стабилен, чем McHttp
• сильно зависит от command throughput и размера payload
• не является основным выбором для больших публичных прод-серверов

Требования

1. VoiceCraft.Server с McWssConfig.Enabled = true
2. VoiceCraft.Addon.Core.McWss.zip
3. Bedrock-версия с поддержкой нужной websocket / script-функциональности

Полезные ссылки:

• Страница скачивания для сырого Core.McWss release package
• Конфигуратор аддона для готового архива под мир

Конфиг VoiceCraft сервера

Типовой пример:

{
  "McWssConfig": {
    "Enabled": true,
    "LoginToken": "replace-with-token",
    "Hostname": "ws://127.0.0.1:9051/",
    "MaxClients": 1,
    "MaxTimeoutMs": 10000,
    "DataTunnelCommand": "voicecraft:data_tunnel",
    "CommandsPerTick": 3,
    "MaxByteLengthPerCommand": 300,
    "DisabledPacketTypes": []
  }
}

Установка

Вариант 1: импорт как .mcaddon

1. Переименуйте архив в VoiceCraft.Addon.Core.McWss.mcaddon.
2. Откройте его, чтобы Minecraft импортировал addon.
3. Включите behavior pack и resource pack в нужном мире.

Вариант 2: ручное копирование

1. Распакуйте архив.
2. Скопируйте RP и BP в директории Bedrock.
3. Включите оба пака в целевом мире.

Схема подключения

Шаг 1: подключить websocket мира

/connect <VOICECRAFT_HOST>:<MCWSS_PORT>

Пример:

/connect 127.0.0.1:9051

Шаг 2: авторизовать addon

/voicecraft:vcconnect <LOGIN_TOKEN>

Используйте McWssConfig.LoginToken.

Data tunnel

Addon использует:

• voicecraft:data_tunnel

Имя должно совпадать с McWssConfig.DataTunnelCommand.

Если изменить только одну сторону, мост перестанет работать.

Сейчас команда передает:

• опциональный аргумент max string length
• аргумент с упакованным payload

Тюнинг

Если видите лаги или нестабильность пакетов:

• снижайте CommandsPerTick
• проверяйте MaxByteLengthPerCommand
• избегайте больших burst-обновлений
• тестируйте на меньшем числе активных сущностей

Когда лучше перейти на другой transport

Переходите на McHttp, если:

• вы используете реальный Bedrock Dedicated Server
• нужна более чистая production-схема
• command tunnel становится узким местом

Тогда продолжайте со страницы McHttp для BDS.