Anbernic RG40XXH(muOS)에서 Minecraft Java: PortMaster 포트 실행하기

PortMaster에는 Anbernic RG40XXH 같은 muOS 휴대용 게임기에서 돌아가는 Minecraft Java 포트(minecraftjava)가 있습니다. 설치는 간단해 보이지만, 저희 RG40XXH에서는 처음엔 실행되지 않았고, 그다음엔 멈췄으며, 제대로 플레이하기까지 여러 번 고쳐야 했습니다. 이 글에 그 모든 것을 모았습니다.

테스트 환경: Anbernic RG40XXH(RAM 1 GB) · muOS 2601.0 Jacaranda · PortMaster Minecraft 포트 · Minecraft Java 1.12.2.

먼저: 포트는 런처일 뿐입니다

PortMaster 포트에는 Minecraft가 들어 있지 않습니다. 런처 메뉴, 시작 스크립트, 컨트롤러 매핑, 그리고 휴대용 게임기에서 Minecraft를 돌리는 데 필요한 ARM 부품이 들어 있습니다. 게임 자체(Minecraft Java Edition 파일)는 본인이 가진 사본에서 가져와야 합니다.

즉:

Minecraft: Java Edition을 보유해야 합니다(minecraft.net에서 구매, Java & Bedrock 번들에 포함). 파일은 PC의 공식 Minecraft Launcher에서 가져옵니다.
포트는 로그인 없이 오프라인으로 게임을 시작합니다. 기본 스킨의 로컬 플레이어로 플레이하게 되며, 온라인 모드 서버에는 접속할 수 없습니다. LAN이나 오프라인 모드 서버는 됩니다(포트 폴더의 server.txt에 주소를 적으세요).

되는 Minecraft 버전은 두 가지뿐

포트가 지원하는 버전은 정확히 다음과 같습니다:

버전	바닐라	Forge
1.7.10	✅(가장 빠름)	✅
1.12.2	✅	✅

첫 번째 실수는 1.12.1을 복사한 것이었습니다. 비슷해 보이지만 런처 메뉴는 1.7.10과 1.12.2만 확인하기 때문에 메뉴에 Exit밖에 나오지 않았습니다. 다른 버전의 이름을 1.12.2로 바꾸는 것도 안 됩니다. 진짜 1.12.2여야 합니다.

1단계: PC에 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단계: 올바른 폴더를 올바른 위치에 복사하기

가장 쉬운 방법: 스크립트에 맡기기. 무료 PC 스크립트가 포트에 필요한 1.12.2 파일만 정확히 모아 포트 자체 파일을 바꾸지 않고 카드에 복사합니다. PortBridge-1.0.0-stock.zip을 다운로드하고 SD 카드 1을 컴퓨터에 넣은 뒤, PC 폴더에서 python3 collect-minecraft.py --to <SD>/ports/minecraftjava(macOS, Linux; <SD>는 카드) 또는 PowerShell에서 .\collect-minecraft.ps1 -To E:\ports\minecraftjava(Windows; 카드의 드라이브 문자로 바꾸세요)를 실행하세요. 자세한 내용은 순정 OS 가이드를 참고하세요. 직접 하려면 계속 읽으세요.

이것이 두 번째 실수였습니다. 버전 파일은 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/         ← PC의 .minecraft/libraries 폴더(병합)
    └── assets/            ← PC의 .minecraft/assets 폴더(병합)

.jar와 .json만 복사하면 부족합니다. Minecraft 1.12.2에는 약 30개의 라이브러리와 에셋(소리, 언어 파일, 텍스처)도 필요하며, 합계 약 200 MB입니다. 이것들이 없으면 시작되지 않습니다.

’폴더 전체’의 의미: 컴퓨터의 Minecraft 폴더(위 표 참고) 안에는 .jar 파일로 가득한 하위 폴더(com, org, net…)가 많은 libraries 폴더와 assets 폴더가 있습니다. 각각을 안의 내용 전부와 함께 SD 카드의 ports/minecraftjava/.minecraft/에 복사하세요.

바꾸지 말고 병합하세요. 포트에는 이미 휴대용 게임기에서 Minecraft를 돌리는 ARM 버전 LWJGL이 든 자체 libraries 폴더가 있습니다. 컴퓨터가 물으면 병합(macOS)을 고르거나, 기존 폴더에 복사하면서 이미 있는 파일은 건너뛰기하세요(Windows). 대치를 고르면 포트의 파일이 지워져 Minecraft가 시작되지 않습니다. versions와 assets도 마찬가지입니다.

PC에서 여러 Minecraft 버전을 플레이했다면 이 폴더들은 모든 버전의 파일을 담고 있어 클 수 있습니다. 괜찮습니다. 휴대용 게임기는 1.12.2에 필요한 것만 씁니다.

카드 리더로 복사하거나, Wi-Fi로 muOS의 SFTP 서버를 이용하세요(SFTP 앱에서 경로는 /SD1 (mmc)/ports/minecraftjava/.minecraft/로 보입니다). 포트는 자체 ARM 빌드 LWJGL을 유지하므로 PC의 libraries 폴더를 복사해도 아무것도 망가지지 않습니다.

컴퓨터에서 .minecraft가 숨겨져 있다면: macOS에서는 Finder에서 **⌘ Shift .**를 누르고, 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초에 1프레임으로 떨어졌습니다. 충돌이 아니라 그냥 과부하였습니다.

원인

RG40XXH는 RAM이 1 GB이고 칩은 휴대폰급입니다. 포트는 Java에 384 MB만 줍니다. PC에서 설정을 복사했다면 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)	블록마다 CPU 절약
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 GB 기기에서는 XMX=384M). 448M으로 올리면 끊김이 줄 수 있지만, muOS, 디스플레이 레이어, 게임이 같은 1 GB를 나눠 씁니다. 더 올리면 시스템이 게임을 강제로 종료할 수도 있습니다. 위 단계로 부족할 때만 바꾸고, 원본 파일의 사본은 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과 관련이 없습니다.