Мод для Майнкрафт на Fabric, который открывает WebSocket-сервер в клиенте игры и позволяет внешней программе управлять персонажем. Он передаёт состояние мира и игрока в JSON, поэтому подходит для собственных программ и автоматизации на любом языке.
Возможности
- Передаёт состояние игрока с заданным интервалом: здоровье, голод, насыщение, координаты, поворот камеры, положение на земле, бег, приседание, плавание, полёт, воду и огонь.
- Сообщает выбранный слот, предметы в основной и второй руках, их идентификаторы, количество, прочность и категорию. Распознаются мечи, луки, арбалеты, топоры, кирки, лопаты, мотыги, трезубцы, щиты, еда, блоки, бросаемые предметы и удочки.
- Передаёт боевой контекст: использование предмета, блок щитом, активную руку и цель под прицелом — моба, блок или пустоту.
- Принимает команды для ходьбы, поворота камеры, прыжка, атаки, использования и выбрасывания предметов, переключения слотов, приседания, бега, выброса предмета, обмена рук и открытия инвентаря.
- Добавляет круговой индикатор панели быстрого доступа со всеми девятью слотами; его можно включать клавишей
Vили командой.
Как пользоваться
После входа в мир сервер доступен по адресу ws://<хост>:8765/mcctp; при выходе из мира он останавливается. Подключиться могут несколько клиентов одновременно, авторизация не предусмотрена.
Состояние приходит сообщением game_state, а действие отправляется в виде {"action":"<имя>","params":{...}}.
move— движение: параметрыdirection(forward,backward,left,right) иstate(startилиstop).look— поворот камеры:yaw,pitch,relative; приtrueуглы прибавляются к текущим, приfalseзадаются точно.jump,attack,throw_item,swap_hands,open_inventory,toggle_wheel— действия без параметров.use_item,sneak,sprint— параметрstateсо значениемstartилиstop.select_slot— параметрslotот0до8.drop_item— параметрfull_stack:trueвыбрасывает всю стопку.
Настройки
Файл .minecraft/config/mcctp.json создаётся при первом запуске.
port— порт WebSocket-сервера, по умолчанию8765.tickInterval— отправка состояния раз в указанное число тиков;20тиков соответствуют одной секунде.
Требования и совместимость
Нужны Fabric Loader, Fabric API и Java 21 или новее.
