De PortMaster-port van Minecraft Java aan de praat krijgen op de Anbernic RG40XXH (muOS)

PortMaster heeft een Minecraft Java-port (minecraftjava) die draait op muOS-handhelds zoals de Anbernic RG40XXH. Installeren lijkt simpel, maar op onze RG40XXH startte hij niet, daarna bevroor hij, en er waren meerdere oplossingen nodig voor een speelbare game. Dit artikel zet alles op één plek.

Getest op: Anbernic RG40XXH (1 GB RAM) · muOS 2601.0 Jacaranda · PortMaster Minecraft-port · Minecraft Java 1.12.2.

Eerst: de port is alleen een launcher

De PortMaster-port bevat geen Minecraft. Er zit een launchermenu in, startscripts, de controllerindeling en de ARM-onderdelen die Minecraft op een handheld nodig heeft. De game zelf (de bestanden van Minecraft Java Edition) moet uit je eigen exemplaar komen.

Dat betekent:

Je moet Minecraft: Java Edition bezitten (gekocht op minecraft.net, het zit in de Java & Bedrock-bundel). De bestanden komen uit de officiële Minecraft Launcher op je pc.
De port start de game offline, zonder in te loggen. Je speelt als lokale speler met de standaardskin, en servers in online-modus laten je niet toe. LAN- of offline-modus-servers werken wel (zet het adres in server.txt in de portmap).

Er werken maar twee Minecraft-versies

De port ondersteunt precies:

Versie	Vanilla	Forge
1.7.10	✅ (snelst)	✅
1.12.2	✅	✅

Onze eerste fout was 1.12.1 kopiëren. Dat lijkt dichtbij genoeg, maar het launchermenu controleert alleen op 1.7.10 en 1.12.2, dus het menu toonde niets behalve Exit. Hernoem ook geen andere versie naar 1.12.2. Het moet de echte 1.12.2 zijn.

Stap 1: haal 1.12.2 op je pc

Open de officiële Minecraft Launcher en log in met het account dat Java Edition bezit.
Ga naar Installations → New installation, kies release 1.12.2 en klik op Create.
Klik één keer op Play en wacht tot het hoofdmenu verschijnt. Zo worden de bibliotheken en geluids- en textuurassets gedownload die 1.12.2 nodig heeft. Sluit daarna af.

Je Minecraft-map is nu compleet:

Systeem	Map
Windows	`%APPDATA%\.minecraft`
macOS	`~/Library/Application Support/minecraft`
Linux	`~/.minecraft`

Stap 2: kopieer de juiste mappen naar de juiste plek

Het makkelijkst: laat een script het doen. Ons gratis pc-script verzamelt precies de 1.12.2-bestanden die de port nodig heeft en kopieert ze naar de kaart zonder de eigen bestanden van de port te vervangen. Download PortBridge-1.0.0-stock.zip, stop SD-kaart 1 in je computer en voer in de map PC uit: python3 collect-minecraft.py --to <SD>/ports/minecraftjava (macOS, Linux; <SD> is de kaart) of .\collect-minecraft.ps1 -To E:\ports\minecraftjava in PowerShell (Windows; met de stationsletter van je kaart). Meer in de gids voor het originele systeem. Wil je het met de hand doen, lees dan verder.

Dit was onze tweede fout. De versiebestanden gaan niet in ports/minecraftjava/versions/. Het startscript laadt ze uit de verborgen map .minecraft in de port:

SD-kaart 1 (muOS: /mnt/mmc)
└── ports/minecraftjava/.minecraft/
    ├── versions/1.12.2/   ← 1.12.2.jar en 1.12.2.json
    ├── libraries/         ← de map .minecraft/libraries van je pc (samenvoegen)
    └── assets/            ← de map .minecraft/assets van je pc (samenvoegen)

Alleen de .jar en .json kopiëren is niet genoeg. Minecraft 1.12.2 heeft ook zo’n 30 bibliotheken en de assets (geluiden, taalbestanden, texturen) nodig, samen ongeveer 200 MB. Zonder die bestanden start het niet.

Wat ‘de hele map’ betekent: in de Minecraft-map op je computer (zie de tabel hierboven) staat een map libraries met veel submappen (com, org, net…) vol .jar-bestanden, en een map assets. Kopieer ze allebei met alles erin naar ports/minecraftjava/.minecraft/ op de SD-kaart.

Samenvoegen, niet vervangen. De port heeft al een eigen map libraries met de ARM-versie van LWJGL waardoor Minecraft op de handheld werkt. Als je computer het vraagt, kies dan Voeg samen (macOS), of kopieer naar de bestaande map en sla bestanden die al bestaan over (Windows). Kies je Vervang, dan worden de bestanden van de port verwijderd en start Minecraft niet. Hetzelfde geldt voor versions en assets.

Speel je veel Minecraft-versies op je pc, dan kunnen deze mappen groot zijn, omdat ze bestanden van elke versie bevatten. Dat is prima: de handheld gebruikt alleen wat 1.12.2 nodig heeft.

Kopieer ze met een kaartlezer, of via Wi-Fi met de SFTP-server van muOS (in een SFTP-app verschijnt het pad als /SD1 (mmc)/ports/minecraftjava/.minecraft/). De port houdt zijn eigen ARM-build van LWJGL, dus je libraries-map van de pc kopiëren maakt niets kapot.

Is .minecraft verborgen op je computer? Druk op macOS in de Finder op ⌘ Shift .; zet op Windows Beeld → Verborgen items aan.

Stap 3: starten

Open op de handheld Ports → Minecraft Launcher. Het menu zou nu Vanilla v1.12.2 moeten tonen.

Toont het nog steeds alleen Exit, kijk dan in ports/minecraftjava/Launcherlog.txt. Een fout als versions/1.12.1/1.12.1.json: line 1: {assetIndex:: command not found betekent dat het startscript ROMS/Ports/Minecraft Launcher.sh met de hand is aangepast. Installeer de port opnieuw via PortMaster om het originele script terug te krijgen.

Laat geen reservekopieën in ROMS/Ports staan. Wij bewaarden het oude script daar als Minecraft Launcher.sh.bak, en muOS toonde het als een tweede game met de naam ‘Minecraft Launcher.sh’. Die starten voerde het kapotte oude script opnieuw uit. Bewaar reservekopieën ergens anders.

Oplossing: haperen, bevriezen of vastlopen

Dit is het meest voorkomende probleem, en het komt bijna altijd door instellingen, niet door een kapotte installatie.

Hoe het eruitziet

In het begin speelt het prima, daarna wordt het steeds trager en na een paar minuten lijkt het bevroren.
Knoppen reageren seconden te laat.
De hele handheld reageert niet meer, zelfs de SFTP-server niet, tot je hem herstart.

Bij ons stond in 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) en zakte de game van 30 beelden per seconde naar één beeld per 8–12 seconden. Geen crash, gewoon overbelasting.

Waarom het gebeurt

De RG40XXH heeft 1 GB RAM en een chip van telefoonniveau. De port geeft Java maar 384 MB. Heb je je instellingen van een pc gekopieerd, dan probeert Minecraft een kijkafstand van 12 chunks te laden met mooie graphics en vloeiende belichting. De handheld kan het niet bijbenen, het geheugen raakt op, en Java is meer tijd kwijt aan geheugen opruimen dan aan de game.

De instellingen die het oplossen

Pas ze aan in Options → Video Settings, of bewerk ports/minecraftjava/.minecraft/options.txt (met de game gesloten):

Instelling (in de game)	`options.txt`	Waarde	Waarom
Render Distance	`renderDistance`	4 (probeer later 5–6)	Veruit het grootste effect op snelheid en geheugen
Graphics	`fancyGraphics`	false (Fast)	Eenvoudigere bladeren, water en schaduwen
Smooth Lighting	`ao`	0 (Off)	Bespaart CPU bij elk blok
Clouds	`renderClouds`	false	Minder te tekenen
Mipmap Levels	`mipmapLevels`	0	Minder geheugen voor texturen
Max Framerate	`maxFps`	30	Stabiel 30 in plaats van meer proberen
VSync	`enableVsync`	false	Voorkomt extra wachten tussen beelden
Particles	`particles`	2 (Minimal)	Minder effecten bij gevechten en regen
Entity Shadows	`entityShadows`	false	Minder te tekenen

In options.txt zien die regels er zo uit:

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

Na deze wijziging speelde onze RG40XXH soepel.

Hapert het nog steeds?

Probeer deze stappen één voor één:

Verlaag de kijkafstand naar 3, of zelfs 2 in grote, drukke werelden.
Begin een nieuwe wereld of speel dicht bij het spawnpunt. Enorme werelden met veel geladen chunks, boerderijen of veel dieren gebruiken meer geheugen.
Herstart de game na lange sessies. Het geheugen loopt na verloop van tijd vol.
Stap over op 1.7.10. Dat is de lichtste versie die de port ondersteunt, en de eigen notities van de port raden hem aan voor de beste prestaties.
Gevorderd: meer geheugen voor Java. De limiet staat in ports/minecraftjava/1.12.2.start (op apparaten met 1 GB kiest hij XMX=384M). Verhogen naar 448M kan het haperen verminderen, maar muOS, de weergavelaag en de game delen dezelfde 1 GB. Ga je hoger, dan kan het systeem de game afsluiten. Pas het alleen aan als de stappen hierboven niet genoeg zijn, en bewaar een kopie van het originele bestand buiten ROMS/Ports.

Nu bevroren?

Druk op R2 + SELECT + B (geforceerd afsluiten in muOS). Reageert er niets, houd dan POWER ongeveer 10 seconden ingedrukt. Je wereld blijft bewaard, maar je verliest alles sinds de laatste automatische opslag. Verlaag daarna de instellingen voordat je verder speelt.

Onschuldig: log.txt loopt vol met GL ERROR 1282 @ Post render. Dat komt van de grafische compatibiliteitslaag van de port en veroorzaakt de vertraging niet.

Bediening

Knop	Actie
Linkerstick	Bewegen
Rechterstick	Rondkijken, en de muisaanwijzer in menu’s
A	Springen
B	Voorwerp laten vallen
X / Y	Inventaris
R2	Breken / aanvallen (linkerklik)
L2	Plaatsen / gebruiken (rechterklik)
L1 / R1	Hotbar
L3 / R3	Sprinten / sluipen
START	Pauzemenu

Afsluiten als de game dat niet toelaat: R2 + SELECT + B is geforceerd afsluiten in muOS. Pauzeer eerst, zodat de wereld wordt opgeslagen.

Samenvatting

Bezit Minecraft Java Edition en installeer 1.12.2 (of 1.7.10) één keer met de officiële launcher.
Kopieer versions/1.12.2, libraries en assets naar ports/minecraftjava/.minecraft/.
Houd ROMS/Ports schoon, zonder .bak-scripts.
Gebruik lage video-instellingen (kijkafstand 4, snelle graphics, 30 FPS). Hapert het nog, bekijk dan de stappen hierboven.

Vragen? Mail naar feedback@pocketkode.com.

Minecraft is een handelsmerk van Mojang Synergies AB. PocketKode is niet verbonden aan Mojang, Microsoft, PortMaster, muOS of Anbernic.