Den PortMaster-Port von Minecraft Java auf dem Anbernic RG40XXH (muOS) zum Laufen bringen
PortMaster hat einen Minecraft-Java-Port (minecraftjava), der auf muOS-Handhelds wie dem Anbernic RG40XXH läuft. Die Installation wirkt einfach, aber auf unserem RG40XXH startete er nicht, dann fror er ein, und es brauchte mehrere Korrekturen bis zu einem spielbaren Spiel. Dieser Beitrag fasst alles an einem Ort zusammen.
Getestet auf: Anbernic RG40XXH (1 GB RAM) · muOS 2601.0 Jacaranda · PortMaster-Minecraft-Port · Minecraft Java 1.12.2.
Zuerst: Der Port ist nur ein Launcher
Der PortMaster-Port enthält kein Minecraft. Er enthält ein Launcher-Menü, Startskripte, die Controller-Belegung und die ARM-Teile, die Minecraft auf einem Handheld braucht. Das Spiel selbst (die Dateien von Minecraft Java Edition) muss aus deiner eigenen Kopie kommen.
Das heißt:
- Du musst Minecraft: Java Edition besitzen (gekauft auf minecraft.net, Teil des Java-&-Bedrock-Pakets). Die Dateien kommen aus dem offiziellen Minecraft Launcher auf deinem PC.
- Der Port startet das Spiel offline, ohne Anmeldung. Du spielst als lokaler Spieler mit dem Standard-Skin, und Server im Online-Modus lassen dich nicht rein. LAN- oder Offline-Modus-Server funktionieren trotzdem (trag die Adresse in
server.txtim Port-Ordner ein).
Nur zwei Minecraft-Versionen funktionieren
Der Port unterstützt genau:
| Version | Vanilla | Forge |
|---|---|---|
| 1.7.10 | ✅ (am schnellsten) | ✅ |
| 1.12.2 | ✅ | ✅ |
Unser erster Fehler war, 1.12.1 zu kopieren. Sieht nah genug aus, aber das Launcher-Menü prüft nur auf 1.7.10 und 1.12.2, also zeigte es nichts außer Exit. Benenn auch keine andere Version in 1.12.2 um. Es muss die echte 1.12.2 sein.
Schritt 1: 1.12.2 auf den PC holen
- Öffne den offiziellen Minecraft Launcher und melde dich mit dem Konto an, dem Java Edition gehört.
- Geh zu Installations → New installation, wähle release 1.12.2 und klick auf Create.
- Klick einmal auf Play und warte, bis das Hauptmenü erscheint. Damit werden die Bibliotheken und Sound-/Textur-Assets geladen, die 1.12.2 braucht. Dann beenden.
Dein Minecraft-Ordner ist jetzt vollständig:
| System | Ordner |
|---|---|
| Windows | %APPDATA%\.minecraft |
| macOS | ~/Library/Application Support/minecraft |
| Linux | ~/.minecraft |
Schritt 2: Die richtigen Ordner an die richtige Stelle kopieren
Am einfachsten: ein Skript macht es. Unser kostenloses PC-Skript sammelt genau die 1.12.2-Dateien, die der Port braucht, und kopiert sie auf die Karte, ohne die Dateien des Ports zu ersetzen. Lade PortBridge-1.0.0-stock.zip herunter, steck SD-Karte 1 in deinen Computer und führe im Ordner PC aus: python3 collect-minecraft.py --to <SD>/ports/minecraftjava (macOS, Linux; <SD> ist die Karte) oder .\collect-minecraft.ps1 -To E:\ports\minecraftjava in PowerShell (Windows; mit dem Laufwerksbuchstaben deiner Karte). Mehr in der Anleitung fürs Stock-OS. Willst du es von Hand machen, lies weiter.
Das war unser zweiter Fehler. Die Versionsdateien kommen nicht nach ports/minecraftjava/versions/. Das Startskript lädt sie aus dem versteckten Ordner .minecraft im Port:
SD-Karte 1 (muOS: /mnt/mmc)
└── ports/minecraftjava/.minecraft/
├── versions/1.12.2/ ← 1.12.2.jar und 1.12.2.json
├── libraries/ ← der Ordner .minecraft/libraries deines PCs (zusammenführen)
└── assets/ ← der Ordner .minecraft/assets deines PCs (zusammenführen)
Nur .jar und .json zu kopieren reicht nicht. Minecraft 1.12.2 braucht außerdem rund 30 Bibliotheken und die Assets (Sounds, Sprachdateien, Texturen), insgesamt etwa 200 MB. Ohne sie startet es nicht.
Was „der ganze Ordner“ heißt: Im Minecraft-Ordner deines Computers (siehe Tabelle oben) gibt es einen Ordner libraries mit vielen Unterordnern (com, org, net…) voller .jar-Dateien und einen Ordner assets. Kopiere beide mit allem Inhalt nach ports/minecraftjava/.minecraft/ auf der SD-Karte.
Zusammenführen, nicht ersetzen. Der Port hat schon einen eigenen Ordner
librariesmit der ARM-Version von LWJGL, die Minecraft auf dem Handheld zum Laufen bringt. Wenn dein Computer fragt, wähle Zusammenführen (macOS) oder kopiere in den vorhandenen Ordner und überspringe bereits vorhandene Dateien (Windows). Mit Ersetzen werden die Dateien des Ports gelöscht und Minecraft startet nicht. Dasselbe gilt fürversionsundassets.
Wenn du auf dem PC viele Minecraft-Versionen spielst, können diese Ordner groß sein, weil sie Dateien für jede Version enthalten. Das ist in Ordnung: Der Handheld nutzt nur, was 1.12.2 braucht.
Kopiere sie mit einem Kartenleser oder per Wi-Fi über den SFTP-Server von muOS (in einer SFTP-App erscheint der Pfad als /SD1 (mmc)/ports/minecraftjava/.minecraft/). Der Port behält seinen eigenen ARM-Build von LWJGL, das Kopieren deines libraries-Ordners macht also nichts kaputt.
Wenn .minecraft auf deinem Computer versteckt ist: Drück unter macOS im Finder ⌘ Umschalt .; unter Windows aktiviere Ansicht → Ausgeblendete Elemente.
Schritt 3: Starten
Öffne auf dem Handheld Ports → Minecraft Launcher. Das Menü sollte jetzt Vanilla v1.12.2 anzeigen.
Zeigt es immer noch nur Exit, sieh in ports/minecraftjava/Launcherlog.txt nach. Ein Fehler wie
versions/1.12.1/1.12.1.json: line 1: {assetIndex:: command not found bedeutet, dass das Startskript ROMS/Ports/Minecraft Launcher.sh von Hand bearbeitet wurde. Installiere den Port über PortMaster neu, um das Originalskript zurückzubekommen.
Lass keine Sicherungskopien in ROMS/Ports liegen. Wir hatten das alte Skript dort als Minecraft Launcher.sh.bak gespeichert, und muOS zeigte es als zweites Spiel namens „Minecraft Launcher.sh“ an. Das zu starten führte wieder das kaputte alte Skript aus. Bewahre Sicherungen woanders auf.
Lösung: Ruckeln, Einfrieren oder Hängen
Das ist das häufigste Problem, und es liegt fast immer an den Einstellungen, nicht an einer kaputten Installation.
So sieht es aus
- Anfangs läuft es gut, dann wird es immer langsamer, und nach ein paar Minuten wirkt es eingefroren.
- Tasten reagieren Sekunden zu spät.
- Der ganze Handheld reagiert nicht mehr, nicht einmal der SFTP-Server, bis du ihn neu startest.
Bei uns stand 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), und das Spiel fiel von 30 Bildern pro Sekunde auf ein Bild alle 8–12 Sekunden. Kein Absturz, nur Überlastung.
Warum das passiert
Der RG40XXH hat 1 GB RAM und einen Chip auf Smartphone-Niveau. Der Port gibt Java nur 384 MB. Wenn du deine Einstellungen vom PC kopiert hast, versucht Minecraft, eine Sichtweite von 12 Chunks mit schöner Grafik und weicher Beleuchtung zu laden. Der Handheld kommt nicht hinterher, der Speicher geht aus, und Java verbringt die meiste Zeit mit Speicheraufräumen statt mit dem Spiel.
Die Einstellungen, die helfen
Ändere sie unter Options → Video Settings oder bearbeite ports/minecraftjava/.minecraft/options.txt (bei geschlossenem Spiel):
| Einstellung (im Spiel) | options.txt |
Wert | Warum |
|---|---|---|---|
| Render Distance | renderDistance |
4 (später 5–6 probieren) | Mit Abstand der größte Effekt auf Tempo und Speicher |
| Graphics | fancyGraphics |
false (Fast) | Einfachere Blätter, Wasser und Schatten |
| Smooth Lighting | ao |
0 (Off) | Spart CPU bei jedem Block |
| Clouds | renderClouds |
false | Weniger zu zeichnen |
| Mipmap Levels | mipmapLevels |
0 | Weniger Speicher für Texturen |
| Max Framerate | maxFps |
30 | Stabile 30 statt mehr zu versuchen |
| VSync | enableVsync |
false | Vermeidet zusätzliches Warten zwischen Bildern |
| Particles | particles |
2 (Minimal) | Weniger Effekte bei Kämpfen und Regen |
| Entity Shadows | entityShadows |
false | Weniger zu zeichnen |
In options.txt sehen die Zeilen so aus:
renderDistance:4
fancyGraphics:false
ao:0
renderClouds:false
mipmapLevels:0
maxFps:30
enableVsync:false
particles:2
entityShadows:false
Danach lief unser RG40XXH flüssig.
Wenn es immer noch ruckelt
Probier Folgendes, eins nach dem anderen:
- Senke die Sichtweite auf 3 oder in großen, belebten Welten sogar auf 2.
- Starte eine neue Welt oder spiel in der Nähe des Spawns. Riesige Welten mit vielen geladenen Chunks, Farmen oder vielen Tieren brauchen mehr Speicher.
- Starte das Spiel nach langen Sessions neu. Der Speicher füllt sich mit der Zeit.
- Wechsle zu 1.7.10. Das ist die leichteste Version, die der Port unterstützt, und die Hinweise des Ports selbst empfehlen sie für die beste Leistung.
- Fortgeschritten: mehr Speicher für Java. Das Limit steht in
ports/minecraftjava/1.12.2.start(auf 1-GB-Geräten wählt esXMX=384M). Eine Erhöhung auf448Mkann das Ruckeln verringern, aber muOS, die Anzeigeschicht und das Spiel teilen sich dasselbe 1 GB. Gehst du höher, beendet das System womöglich das Spiel. Ändere es nur, wenn die Schritte oben nicht reichen, und bewahre eine Kopie der Originaldatei außerhalb vonROMS/Portsauf.
Gerade eingefroren?
Drück R2 + SELECT + B (Zwangsbeenden von muOS). Reagiert nichts, halte POWER etwa 10 Sekunden gedrückt. Deine Welt bleibt erhalten, aber alles seit dem letzten Autosave geht verloren. Senk danach die Einstellungen, bevor du weiterspielst.
Harmlos: log.txt füllt sich mit GL ERROR 1282 @ Post render. Das stammt aus der Grafik-Kompatibilitätsschicht des Ports und verursacht nicht die Verlangsamung.
Steuerung
| Taste | Aktion |
|---|---|
| Linker Stick | Bewegen |
| Rechter Stick | Umsehen, und Mauszeiger in Menüs |
| A | Springen |
| B | Gegenstand fallen lassen |
| X / Y | Inventar |
| R2 | Abbauen / angreifen (Linksklick) |
| L2 | Platzieren / benutzen (Rechtsklick) |
| L1 / R1 | Schnellleiste |
| L3 / R3 | Sprinten / schleichen |
| START | Pausenmenü |
Zum Beenden, wenn das Spiel dich nicht lässt: R2 + SELECT + B ist das Zwangsbeenden von muOS. Pausiere vorher, damit die Welt gespeichert wird.
Zusammenfassung
- Besitze Minecraft Java Edition und installiere 1.12.2 (oder 1.7.10) einmal mit dem offiziellen Launcher.
- Kopiere
versions/1.12.2,librariesundassetsnachports/minecraftjava/.minecraft/. - Halte
ROMS/Portssauber, ohne.bak-Skripte. - Nutze niedrige Videoeinstellungen (Sichtweite 4, schnelle Grafik, 30 FPS). Ruckelt es weiter, sieh dir die Schritte zur Fehlerbehebung oben an.
Fragen? Schreib an feedback@pocketkode.com.
Minecraft ist eine Marke der Mojang Synergies AB. PocketKode steht in keiner Verbindung zu Mojang, Microsoft, PortMaster, muOS oder Anbernic.