MonkeyCraft

🐒 MonkeyCraft

Играй в Minecraft откуда угодно. Реально откуда угодно.

Транслируй и управляй своей игрой в Minecraft с телефона или из браузера

MonkeyCraft Mod 1.4.3 доступен для Minecraft 26.2, 26.1, 1.21.11 и 1.19. Каждый установщик весит примерно 27 МБ и включает веб-клиент на Flutter и опциональный встроенный Tailscale для Windows x64 и Apple Silicon Mac. В этом релизе обновлён мод; клиент в App Store остаётся iOS 1.4.1.

Поддерживаемые версии

Также установи подходящую версию Fabric API. Выбери один JAR для своей версии Minecraft; файлы -sources.jar предназначены для разработчиков.

Встроенный Tailscale поддерживает Windows x64 и Apple Silicon Mac с ARM64 Java. Linux и Intel Mac по-прежнему могут использовать мод через локальную сеть или системный Tailscale. Вспомогательные компоненты включены в JAR; скачивать их отдельно не нужно.

📱 Доступность клиентов

• iOS 1.4.1 — Доступен в Apple App Store.
• Web — Открой веб-клиент. Поддерживает Chrome/Edge на десктопе и Safari на iPhone. Используй Connect with Tailscale, чтобы войти, выбрать свой игровой компьютер и выполнить сопряжение в Minecraft. Видео по прямому адресу в браузере требует HTTPS и доступной защищённой конечной точки WebSocket (wss://); localhost тоже поддерживается для разработки.
• Android — Публичного релиза пока нет. Идёт закрытое тестирование в Google Play и подготовка к релизу; о публичной доступности Android объявят отдельно.

✨ Что можно делать?

MonkeyCraft позволяет играть в Minecraft удалённо из приложения на iOS или поддерживаемого браузера. Подготовка публичного релиза для Android идёт полным ходом.

🎮 Представь такие сценарии:

• 🛋️ Игра на диване — Продолжай играть, пока кто-то другой пользуется компьютером
• 🚇 В дороге — Продолжай свой мир с телефона по пути на работу
• 🏠 Дома — Проверяй ферму или AFK-рыбалку откуда угодно
• 👥 Делись игрой — Дай другу поиграть в твоём мире с его телефона

🎯 Возможности

📹 Прямая видеотрансляция

Смотри свою игру в Minecraft в реальном времени на телефоне с настройками:

🗺️ Режим 2D-карты

Переключитесь на вид сверху на окружающий мир — он транслируется как H.264-видео, прямо как вид от первого лица. Удобно для навигации, планировки базы или слежки за кем-то на сервере.

🕹️ Сенсорное управление

Полный контроль над игрой с интуитивным сенсорным интерфейсом:

💬 Система чата

• 📨 Отправка сообщений — Общайтесь с другими игроками на сервере
• 📥 Приём сообщений — Видьте весь входящий чат с богатым форматированием
• 🔗 Кликабельные ссылки — Нажимайте на ссылки и команды в чате

🔔 Умные уведомления

Будьте в курсе, даже когда не играете активно:

🎵 Пространственный звук

Когда сервер, на котором вы играете, использует OpenAudioMc или аудиосистему MCParks v1, MonkeyCraft может перенаправить аудиосессию на ваш телефон:

• 🎧 Серверный пространственный звук — голос, атмосфера, музыка, воспроизводимые сервером, доходят до вашего телефона
• 🔊 Ползунок громкости — регулируйте громкость воспроизведения MCParks отдельно в настройках
• 🔁 Мягкое обновление при возврате — когда приложение возвращается из фона, аудиосессия переподключается без полного повторного сопряжения

😴 Режим гибернации

Нужно отойти, но остаться на связи?

• ⏸️ Пауза стриминга — Останавливает видео для экономии трафика
• 🔗 Сохранение соединения — Остаётесь в сети на сервере
• 💬 Чат доступен — По-прежнему можно отправлять и получать сообщения
• 📱 Live Activity (iOS) — Видьте обратный отсчёт на экране блокировки

🧭 Удалённое подключение к серверу

Подключайтесь с телефона, пока Minecraft всё ещё на экране заголовка:

• 📋 Список сохранённых серверов — просматривайте серверы для игры по сети, сохранённые на вашем клиенте
• ⌨️ Прямое подключение — введите любой адрес сервера для подключения
• 🚪 Без рук — с включённой опцией Запускать сервер при старте выбирайте и подключайтесь к серверу полностью из приложения

🔐 Безопасное соединение

• 🛡️ Сопряжение и пароли — Подтвердите запрос на сопряжение в Minecraft или подключитесь с паролем мода; iOS 1.4.1 использует пароль или QR-код пароля
• 🔒 HMAC-аутентификация — Криптографический запрос-ответ
• 🌐 Контроль сети — Ограничьте доступ до localhost, локальной сети или где угодно
• 📱 Настройка по QR-коду — Быстрое сканирование для ввода пароля

🎮 Как это работает

1️⃣ Установите мод

Установите мод MonkeyCraft на ваш клиент Minecraft на Fabric (1.19, 1.21.11, 26.1 или 26.2).

2️⃣ Запустите сервер

В Minecraft введите /monkey start, чтобы запустить WebSocket-сервер.

3️⃣ Подключите телефон или браузер

Для живого веб-клиента выберите Подключиться через Tailscale, войдите, выберите свой компьютер и подтвердите запрос на сопряжение в Minecraft. На поддерживаемых компьютерах /monkey tailscale login включает встроенное подключение Tailscale; иначе используйте системный Tailscale.

Для iOS 1.4.1 введите доступный адрес компьютера и порт (по умолчанию: 9600), затем введите пароль мода или отсканируйте его QR-код пароля. Подключения по локальной сети и через системный Tailscale остаются доступными. Обновление мода не добавляет новый интерфейс сопряжения в старое приложение.

Мод также обслуживает встроенный веб-клиент на Flutter. Для видео в браузере нужен защищённый контекст: используйте HTTPS с доступной конечной точкой wss:// для прямых подключений по адресу, например существующий HTTPS-адрес Tailscale Serve. Обычный HTTP по локальной сети не подходит для передачи видео в браузер на другом устройстве. Встроенное подключение Tailscale у размещённого клиента — отдельная опция.

4️⃣ Играем!

Твой вид из Minecraft появляется на телефоне. Используй сенсорное управление, чтобы двигаться, осматриваться, прыгать и взаимодействовать с миром.

⚙️ Настройки

Открой настройки через /monkey config или через ModMenu:

📋 Команды в игре

📱 Экраны приложения

🚀 С чего начать

Шаги установки

1. Установи Fabric — Скачай с fabricmc.net
2. Скачай MonkeyCraft — Выбери подходящий Mod 1.4.3 JAR из поддерживаемых версий выше
3. Установи мод — Помести в папку mods

4. Выбери клиент

   • Веб: Открой MonkeyCraft в браузере
   • iOS: Скачай MonkeyCraft из Apple App Store
   • Android: подготовка к релизу в Google Play и закрытое тестирование скоро; Android пока публично недоступен
5. Подключайся и играй!

Сборка из исходников

Запускай каждую команду из корня репозитория. Сначала установи нужный JDK, Flutter и инструментарий Go. Каждая сборка мода требует общий Flutter-бандл для браузера и вспомогательные артефакты для Windows x64 / Apple Silicon macOS:

# Установи FLUTTER_BIN в путь к твоему исполняемому файлу Flutter, если его нет в PATH.
# Это production веб-бандл, встраиваемый каждым модом, с корнем в /.
(cd flutter/monkeycraft && \
  FLUTTER_BIN=/absolute/path/to/flutter \
  MONKEYCRAFT_PAGES_PROVENANCE=0 \
  bash tool/build_web_release.sh / build/web)

(cd native/tailscale-helper && ./scripts/build-all.sh)
(cd mods/26.2 && ./gradlew build)

# Другие цели модов: байткод Java 25, 21 и 17 соответственно
(cd mods/26.1 && ./gradlew build)
(cd mods/1.21.11 && ./gradlew build)
(cd mods/1.19 && ./gradlew build)

Если Flutter есть в твоём PATH, опусти FLUTTER_BIN=/absolute/path/to/flutter. Исторический TypeScript-клиент в web/ остаётся только как справочный материал и тестовые фикстуры; pnpm --dir web build — это не production-сборка браузерного мода. Чтобы собрать отдельный артефакт для GitHub Pages локально, используй ту же команду с базой /monkeycraft/ и отдельным выводом:

(cd flutter/monkeycraft && \
  FLUTTER_BIN=/absolute/path/to/flutter \
  MONKEYCRAFT_PAGES_PROVENANCE=0 \
  bash tool/build_web_release.sh /monkeycraft/ build/pages)

Эта команда создаёт только локальные файлы; она не разворачивает и не изменяет живой сайт Pages. Лаунчер Gradle 1.19 требует Java 21 или новее, при этом компилирует под Java 17. Смотрите инструкции по сборке вспомогательного компонента для выбора тулчейна Go.

Для Android установите NDK и соберите закреплённые нативные библиотеки перед сборкой приложения. Подробности и проверка APK — в инструкциях по нативным зависимостям Android.

flutter/monkeycraft/android/third_party/libtailscale/build.sh
(cd flutter/monkeycraft && flutter pub get && flutter build apk)

Для iOS используйте macOS с Xcode и закреплённый тулчейн Go, описанный в инструкциях по нативным зависимостям, затем соберите с вашей конфигурацией подписи:

flutter/monkeycraft/ios/third_party/libtailscale/build.sh
(cd flutter/monkeycraft && bash tool/build_ios_device_release.sh)

Эта точка входа для сборки на устройство очищает общие кэши нативных ресурсов и проверяет платформу и команду подписи каждого встроенного фреймворка перед установкой. Сохраните все нужные вам результаты сборки Android или Web перед её шагом очистки.

❓ FAQ

Можно ли играть на сервере?

Да! MonkeyCraft транслирует ваш клиент Minecraft, так что вы можете играть на любом сервере или в одиночном мире.

Есть ли лаги?

Видео кодируется и транслируется в реальном времени. Для лучшего результата:

• Используйте хорошее WiFi-соединение
• Снизьте разрешение/FPS при необходимости
• Держите компьютер поближе к роутеру

Могут ли подключиться несколько клиентов?

Одновременно может подключиться только один управляющий телефон или браузер.

Работает ли это через интернет?

Да. Используйте встроенный Tailscale на Windows x64 или Apple Silicon Mac, либо системный Tailscale на игровом компьютере. Размещённый веб-клиент может войти в Tailscale напрямую. Доступ по прямому адресу по умолчанию остаётся ограниченным вашей локальной сетью.

Какие команды можно выполнять удалённо?

По умолчанию разрешены все команды, кроме op и deop. Настройте белый/чёрный список в настройках.