Как запустить порт Minecraft Java из PortMaster на Anbernic RG40XXH (muOS)

В PortMaster есть порт Minecraft Java (minecraftjava), который работает на консолях с muOS, например на Anbernic RG40XXH. Установка выглядит простой, но на нашей RG40XXH он сначала не запускался, потом зависал, и чтобы в него можно было играть, понадобилось несколько исправлений. Здесь всё собрано в одном месте.

Проверено на: Anbernic RG40XXH (1 ГБ ОЗУ) · muOS 2601.0 Jacaranda · порт Minecraft из PortMaster · Minecraft Java 1.12.2.

Сначала главное: порт — это только лаунчер

Порт из PortMaster не содержит Minecraft. В нём есть меню лаунчера, скрипты запуска, раскладка кнопок и ARM-компоненты, нужные Minecraft на портативной консоли. Саму игру (файлы Minecraft Java Edition) нужно взять из своей копии.

Это значит:

У вас должна быть Minecraft: Java Edition (покупается на minecraft.net, входит в набор Java & Bedrock). Файлы берутся из официального Minecraft Launcher на вашем ПК.
Порт запускает игру офлайн, без входа в аккаунт. Вы играете как локальный игрок со стандартным скином, а серверы в онлайн-режиме вас не пустят. LAN-серверы и серверы в офлайн-режиме работают (впишите адрес в server.txt в папке порта).

Работают только две версии Minecraft

Порт поддерживает ровно:

Версия	Vanilla	Forge
1.7.10	✅ (самая быстрая)	✅
1.12.2	✅	✅

Наша первая ошибка — мы скопировали 1.12.1. Вроде бы близко, но меню лаунчера ищет только 1.7.10 и 1.12.2, поэтому в нём был лишь пункт Exit. Переименовывать другую версию в 1.12.2 тоже нельзя. Нужна настоящая 1.12.2.

Шаг 1: установите 1.12.2 на ПК

Откройте официальный Minecraft Launcher и войдите в аккаунт, которому принадлежит Java Edition.
Перейдите в Installations → New installation, выберите release 1.12.2 и нажмите Create.
Один раз нажмите Play и дождитесь главного меню. Так скачаются библиотеки и ресурсы звуков и текстур, нужные 1.12.2. Затем выйдите.

Теперь папка Minecraft полная:

Система	Папка
Windows	`%APPDATA%\.minecraft`
macOS	`~/Library/Application Support/minecraft`
Linux	`~/.minecraft`

Шаг 2: скопируйте нужные папки в нужное место

Проще всего — доверить это скрипту. Наш бесплатный скрипт для ПК собирает ровно те файлы 1.12.2, что нужны порту, и копирует их на карту, не заменяя собственные файлы порта. Скачайте PortBridge-1.0.0-stock.zip, вставьте SD-карту 1 в компьютер и выполните в папке PC: python3 collect-minecraft.py --to <SD>/ports/minecraftjava (macOS, Linux; <SD> — это карта) или .\collect-minecraft.ps1 -To E:\ports\minecraftjava в PowerShell (Windows; подставьте букву диска карты). Подробнее — в руководстве для стоковой системы. Чтобы сделать всё вручную, читайте дальше.

Это была наша вторая ошибка. Файлы версии кладутся не в ports/minecraftjava/versions/. Скрипт запуска загружает их из скрытой папки .minecraft внутри порта:

SD-карта 1 (muOS: /mnt/mmc)
└── ports/minecraftjava/.minecraft/
    ├── versions/1.12.2/   ← 1.12.2.jar и 1.12.2.json
    ├── libraries/         ← папка .minecraft/libraries с вашего ПК (объединить)
    └── assets/            ← папка .minecraft/assets с вашего ПК (объединить)

Скопировать только .jar и .json недостаточно. Minecraft 1.12.2 также нужны около 30 библиотек и ресурсы (звуки, языковые файлы, текстуры) — всего около 200 МБ. Без них игра не запустится.

Что значит «папка целиком»: в папке Minecraft на компьютере (см. таблицу выше) есть папка libraries с множеством подпапок (com, org, net…) с файлами .jar и папка assets. Скопируйте каждую со всем содержимым в ports/minecraftjava/.minecraft/ на SD-карте.

Объединяйте, а не заменяйте. У порта уже есть своя папка libraries с ARM-версией LWJGL, благодаря которой Minecraft работает на консоли. Когда компьютер спросит, выберите Объединить (macOS) или копируйте в существующую папку и пропускайте уже существующие файлы (Windows). Если выбрать Заменить, файлы порта удалятся и Minecraft не запустится. То же касается versions и assets.

Если вы играете на ПК во много версий Minecraft, эти папки могут быть большими: в них файлы всех версий. Это не страшно — консоль использует только то, что нужно 1.12.2.

Копируйте картридером или по Wi-Fi через SFTP-сервер muOS (в SFTP-приложении путь выглядит как /SD1 (mmc)/ports/minecraftjava/.minecraft/). Порт сохраняет свою ARM-сборку LWJGL, поэтому копирование папки libraries с ПК ничего не сломает.

Если .minecraft на компьютере скрыта: в macOS нажмите ⌘ Shift . в Finder; в Windows включите Вид → Скрытые элементы.

Шаг 3: запустите

На консоли откройте Ports → Minecraft Launcher. Теперь в меню должен появиться Vanilla v1.12.2.

Если по-прежнему есть только Exit, загляните в ports/minecraftjava/Launcherlog.txt. Ошибка вида versions/1.12.1/1.12.1.json: line 1: {assetIndex:: command not found означает, что скрипт запуска ROMS/Ports/Minecraft Launcher.sh редактировали вручную. Переустановите порт из PortMaster, чтобы вернуть исходный скрипт.

Не оставляйте резервные копии в ROMS/Ports. Мы сохранили там старый скрипт как Minecraft Launcher.sh.bak, и muOS показала его как вторую игру «Minecraft Launcher.sh». Её запуск снова выполнял сломанный старый скрипт. Храните копии в другом месте.

Решение: рывки, подвисания и зависания

Это самая частая проблема, и почти всегда дело в настройках, а не в сломанной установке.

Как это выглядит

Сначала всё нормально, потом игра всё сильнее тормозит и через несколько минут словно замирает.
Кнопки срабатывают с задержкой в несколько секунд.
Вся консоль перестаёт отвечать, даже SFTP-сервер, пока её не перезагрузишь.

У нас в ports/minecraftjava/log.txt было Can't keep up! Did the system time change, or is the server overloaded? Running 2227ms behind, skipping 44 tick(s), а игра упала с 30 кадров в секунду до одного кадра раз в 8–12 секунд. Это был не вылет, а просто перегрузка.

Почему так происходит

У RG40XXH 1 ГБ ОЗУ и чип уровня смартфона. Порт выделяет Java всего 384 МБ. Если вы скопировали настройки с ПК, Minecraft пытается загрузить дальность прорисовки 12 чанков с детальной графикой и мягким освещением. Консоль не справляется, память заканчивается, и Java тратит больше времени на очистку памяти, чем на саму игру.

Настройки, которые помогают

Измените их в Options → Video Settings или отредактируйте ports/minecraftjava/.minecraft/options.txt (при закрытой игре):

Настройка (в игре)	`options.txt`	Значение	Зачем
Render Distance	`renderDistance`	4 (позже попробуйте 5–6)	Сильнее всего влияет на скорость и память
Graphics	`fancyGraphics`	false (Fast)	Проще листва, вода и тени
Smooth Lighting	`ao`	0 (Off)	Экономит процессор на каждом блоке
Clouds	`renderClouds`	false	Меньше рисовать
Mipmap Levels	`mipmapLevels`	0	Меньше памяти на текстуры
Max Framerate	`maxFps`	30	Стабильные 30 вместо попыток большего
VSync	`enableVsync`	false	Нет лишнего ожидания между кадрами
Particles	`particles`	2 (Minimal)	Меньше эффектов в бою и под дождём
Entity Shadows	`entityShadows`	false	Меньше рисовать

В options.txt эти строки выглядят так:

renderDistance:4
fancyGraphics:false
ao:0
renderClouds:false
mipmapLevels:0
maxFps:30
enableVsync:false
particles:2
entityShadows:false

После этого наша RG40XXH работала плавно.

Если всё ещё тормозит

Пробуйте по одному:

Уменьшите дальность прорисовки до 3, а в больших и насыщенных мирах даже до 2.
Начните новый мир или играйте рядом с точкой появления. Огромные миры с множеством загруженных чанков, фермами или животными расходуют больше памяти.
Перезапускайте игру после долгих сессий. Память со временем забивается.
Перейдите на 1.7.10. Это самая лёгкая версия из поддерживаемых портом, и в заметках самого порта её рекомендуют для лучшей производительности.
Для опытных: больше памяти для Java. Лимит задаётся в ports/minecraftjava/1.12.2.start (на устройствах с 1 ГБ выбирается XMX=384M). Увеличение до 448M может уменьшить рывки, но muOS, слой вывода изображения и игра делят один и тот же 1 ГБ. Если поднять больше, система может закрыть игру. Меняйте это, только если шагов выше не хватает, и храните копию исходного файла вне ROMS/Ports.

Зависло прямо сейчас?

Нажмите R2 + SELECT + B (принудительный выход в muOS). Если ничего не реагирует, удерживайте POWER около 10 секунд. Мир сохранится, но всё после последнего автосохранения будет потеряно. Перед следующей игрой снизьте настройки.

Безвредно: log.txt заполняется строками GL ERROR 1282 @ Post render. Это сообщения графического слоя совместимости порта, и тормоза вызывают не они.

Управление

Кнопка	Действие
Левый стик	Движение
Правый стик	Осмотреться, а в меню — указатель мыши
A	Прыжок
B	Выбросить предмет
X / Y	Инвентарь
R2	Ломать / атаковать (левый клик)
L2	Поставить / использовать (правый клик)
L1 / R1	Панель быстрого доступа
L3 / R3	Бег / красться
START	Меню паузы

Если игра не даёт выйти: R2 + SELECT + B — принудительный выход в muOS. Сначала поставьте паузу, чтобы мир сохранился.

Кратко

Нужна Minecraft Java Edition; один раз установите 1.12.2 (или 1.7.10) через официальный лаунчер.
Скопируйте versions/1.12.2, libraries и assets в ports/minecraftjava/.minecraft/.
Держите ROMS/Ports в чистоте, без скриптов .bak.
Используйте низкие настройки видео (дальность прорисовки 4, быстрая графика, 30 FPS). Если всё ещё тормозит, смотрите шаги выше.

Вопросы? Пишите на feedback@pocketkode.com.

Minecraft — товарный знак Mojang Synergies AB. PocketKode не связан с Mojang, Microsoft, PortMaster, muOS или Anbernic.