Faire fonctionner le portage Minecraft Java de PortMaster sur l’Anbernic RG40XXH (muOS)
PortMaster propose un portage de Minecraft Java (minecraftjava) qui tourne sur les consoles muOS comme l’Anbernic RG40XXH. L’installation semble simple, mais sur notre RG40XXH il ne démarrait pas, puis il se figeait, et il a fallu plusieurs corrections pour obtenir un jeu jouable. Cet article rassemble tout au même endroit.
Testé sur : Anbernic RG40XXH (1 Go de RAM) · muOS 2601.0 Jacaranda · portage Minecraft de PortMaster · Minecraft Java 1.12.2.
D’abord : le portage n’est qu’un lanceur
Le portage PortMaster ne contient pas Minecraft. Il contient un menu de lancement, des scripts de démarrage, la configuration de la manette et les composants ARM dont Minecraft a besoin sur une console portable. Le jeu lui-même (les fichiers de Minecraft Java Edition) doit venir de votre propre copie.
Autrement dit :
- Vous devez posséder Minecraft: Java Edition (acheté sur minecraft.net, inclus dans le pack Java & Bedrock). Les fichiers viennent du Minecraft Launcher officiel sur votre PC.
- Le portage lance le jeu hors ligne, sans connexion au compte. Vous jouez en joueur local avec le skin par défaut, et les serveurs en mode en ligne refuseront votre connexion. Les serveurs LAN ou en mode hors ligne fonctionnent (mettez l’adresse dans
server.txtdans le dossier du portage).
Seules deux versions de Minecraft fonctionnent
Le portage prend en charge exactement :
| Version | Vanilla | Forge |
|---|---|---|
| 1.7.10 | ✅ (la plus rapide) | ✅ |
| 1.12.2 | ✅ | ✅ |
Notre première erreur a été de copier la 1.12.1. Elle semble assez proche, mais le menu du lanceur ne cherche que 1.7.10 et 1.12.2, et il n’affichait donc que Exit. Ne renommez pas non plus une autre version en 1.12.2 : il faut la vraie 1.12.2.
Étape 1 : obtenir la 1.12.2 sur votre PC
- Ouvrez le Minecraft Launcher officiel et connectez-vous avec le compte qui possède Java Edition.
- Allez dans Installations → New installation, choisissez release 1.12.2 et cliquez sur Create.
- Cliquez une fois sur Play et attendez l’écran principal. Cela télécharge les bibliothèques et les ressources sonores et graphiques dont la 1.12.2 a besoin. Puis quittez.
Votre dossier Minecraft est maintenant complet :
| Système | Dossier |
|---|---|
| Windows | %APPDATA%\.minecraft |
| macOS | ~/Library/Application Support/minecraft |
| Linux | ~/.minecraft |
Étape 2 : copier les bons dossiers au bon endroit
Le plus simple : laisser faire un script. Notre script gratuit pour PC rassemble exactement les fichiers de la 1.12.2 dont le portage a besoin et les copie sur la carte sans remplacer les fichiers du portage. Téléchargez PortBridge-1.0.0-stock.zip, mettez la carte SD 1 dans votre ordinateur et lancez, dans son dossier PC : python3 collect-minecraft.py --to <SD>/ports/minecraftjava (macOS, Linux ; <SD> est la carte) ou .\collect-minecraft.ps1 -To E:\ports\minecraftjava dans PowerShell (Windows ; utilisez la lettre de lecteur de votre carte). Plus de détails dans le guide du système d’origine. Pour le faire à la main, lisez la suite.
C’était notre deuxième erreur. Les fichiers de version ne vont pas dans ports/minecraftjava/versions/. Le script de démarrage les charge depuis le dossier caché .minecraft à l’intérieur du portage :
Carte SD 1 (muOS : /mnt/mmc)
└── ports/minecraftjava/.minecraft/
├── versions/1.12.2/ ← 1.12.2.jar et 1.12.2.json
├── libraries/ ← le dossier .minecraft/libraries de votre PC (fusionner)
└── assets/ ← le dossier .minecraft/assets de votre PC (fusionner)Copier seulement le .jar et le .json ne suffit pas. Minecraft 1.12.2 a aussi besoin d’une trentaine de bibliothèques et des assets (sons, fichiers de langue, textures), environ 200 Mo au total. Sans eux, il ne démarre pas.
Ce que « le dossier entier » veut dire : dans le dossier Minecraft de votre ordinateur (voir le tableau ci-dessus), il y a un dossier libraries avec de nombreux sous-dossiers (com, org, net…) remplis de fichiers .jar, et un dossier assets. Copiez chacun avec tout son contenu dans ports/minecraftjava/.minecraft/ sur la carte SD.
Fusionnez, ne remplacez pas. Le portage a déjà son propre dossier
librariesavec la version ARM de LWJGL qui fait fonctionner Minecraft sur la console. Quand l’ordinateur le demande, choisissez Fusionner (macOS), ou copiez dans le dossier existant en ignorant les fichiers déjà présents (Windows). Choisir Remplacer supprime les fichiers du portage et Minecraft ne démarrera pas. Même chose pourversionsetassets.
Si vous jouez à de nombreuses versions de Minecraft sur votre PC, ces dossiers peuvent être volumineux, car ils contiennent les fichiers de toutes les versions. Ce n’est pas grave : la console n’utilise que ce dont la 1.12.2 a besoin.
Copiez-les avec un lecteur de cartes, ou par Wi-Fi avec le serveur SFTP de muOS (dans une app SFTP, le chemin apparaît comme /SD1 (mmc)/ports/minecraftjava/.minecraft/). Le portage garde sa propre version ARM de LWJGL, donc copier le dossier libraries de votre PC ne casse rien.
Si .minecraft est caché sur votre ordinateur : sur macOS, appuyez sur ⌘ Maj . dans le Finder ; sur Windows, activez Affichage → Éléments masqués.
Étape 3 : le lancer
Sur la console, ouvrez Ports → Minecraft Launcher. Le menu devrait maintenant afficher Vanilla v1.12.2.
S’il n’affiche toujours que Exit, consultez ports/minecraftjava/Launcherlog.txt. Une erreur comme
versions/1.12.1/1.12.1.json: line 1: {assetIndex:: command not found signifie que le script de lancement ROMS/Ports/Minecraft Launcher.sh a été modifié à la main. Réinstallez le portage depuis PortMaster pour retrouver le script d’origine.
Ne laissez pas de copies de sauvegarde dans ROMS/Ports. Nous y avions enregistré l’ancien script sous Minecraft Launcher.sh.bak, et muOS l’a affiché comme un deuxième jeu appelé « Minecraft Launcher.sh ». Le lancer relançait l’ancien script cassé. Gardez vos sauvegardes ailleurs.
Solution : saccades, gel ou blocage
C’est le problème le plus fréquent, et il vient presque toujours des réglages, pas d’une installation cassée.
Les symptômes
- Au début tout va bien, puis ça ralentit de plus en plus, et au bout de quelques minutes le jeu semble figé.
- Les boutons réagissent avec plusieurs secondes de retard.
- Toute la console ne répond plus, même le serveur SFTP, jusqu’au redémarrage.
Dans notre cas, ports/minecraftjava/log.txt affichait Can't keep up! Did the system time change, or is the server overloaded? Running 2227ms behind, skipping 44 tick(s) et le jeu est passé de 30 images par seconde à une image toutes les 8 à 12 secondes. Ce n’était pas un plantage, juste une surcharge.
Pourquoi
La RG40XXH a 1 Go de RAM et une puce de niveau smartphone. Le portage ne donne que 384 Mo à Java. Si vous avez copié vos réglages depuis un PC, Minecraft essaie de charger une distance d’affichage de 12 chunks avec des graphismes détaillés et un éclairage doux. La console ne suit pas, la mémoire s’épuise, et Java passe l’essentiel de son temps à nettoyer la mémoire au lieu de faire tourner le jeu.
Les réglages qui règlent le problème
Changez-les dans Options → Video Settings, ou modifiez ports/minecraftjava/.minecraft/options.txt (jeu fermé) :
| Réglage (en jeu) | options.txt |
Valeur | Pourquoi |
|---|---|---|---|
| Render Distance | renderDistance |
4 (essayez 5–6 ensuite) | De loin le plus gros effet sur la vitesse et la mémoire |
| Graphics | fancyGraphics |
false (Fast) | Feuilles, eau et ombres simplifiées |
| Smooth Lighting | ao |
0 (Off) | Économise le processeur sur chaque bloc |
| Clouds | renderClouds |
false | Moins à dessiner |
| Mipmap Levels | mipmapLevels |
0 | Moins de mémoire pour les textures |
| Max Framerate | maxFps |
30 | 30 stables au lieu de viser plus |
| VSync | enableVsync |
false | Évite les attentes supplémentaires entre les images |
| Particles | particles |
2 (Minimal) | Moins d’effets en combat et sous la pluie |
| Entity Shadows | entityShadows |
false | Moins à dessiner |
Dans options.txt, ces lignes ressemblent à ceci :
renderDistance:4
fancyGraphics:false
ao:0
renderClouds:false
mipmapLevels:0
maxFps:30
enableVsync:false
particles:2
entityShadows:falseAprès ce changement, notre RG40XXH tournait de façon fluide.
Si ça saccade encore
Essayez ceci, une chose à la fois :
- Baissez la distance d’affichage à 3, voire 2 dans les grands mondes très chargés.
- Commencez un nouveau monde ou jouez près du point d’apparition. Les mondes immenses avec beaucoup de chunks chargés, de fermes ou d’animaux consomment plus de mémoire.
- Redémarrez le jeu après de longues sessions. La mémoire s’accumule avec le temps.
- Passez à la 1.7.10. C’est la version la plus légère prise en charge par le portage, et les notes du portage la recommandent pour les meilleures performances.
- Avancé : plus de mémoire pour Java. La limite est fixée dans
ports/minecraftjava/1.12.2.start(il choisitXMX=384Msur les appareils à 1 Go). La monter à448Mpeut réduire les saccades, mais muOS, la couche d’affichage et le jeu se partagent le même 1 Go. Au-delà, le système risque de fermer le jeu. Ne la modifiez que si les étapes ci-dessus ne suffisent pas, et gardez une copie du fichier d’origine en dehors deROMS/Ports.
Figé en ce moment ?
Appuyez sur R2 + SELECT + B (fermeture forcée de muOS). Si rien ne répond, maintenez POWER environ 10 secondes. Votre monde est conservé, mais vous perdez ce qui a été fait depuis la dernière sauvegarde automatique. Baissez ensuite les réglages avant de rejouer.
Sans gravité : log.txt se remplit de GL ERROR 1282 @ Post render. Cela vient de la couche de compatibilité graphique du portage et ne cause pas le ralentissement.
Commandes
| Bouton | Action |
|---|---|
| Stick gauche | Se déplacer |
| Stick droit | Regarder autour, et pointeur de souris dans les menus |
| A | Sauter |
| B | Lâcher l’objet |
| X / Y | Inventaire |
| R2 | Casser / attaquer (clic gauche) |
| L2 | Poser / utiliser (clic droit) |
| L1 / R1 | Barre d’accès rapide |
| L3 / R3 | Sprinter / s’accroupir |
| START | Menu pause |
Pour quitter quand le jeu ne vous laisse pas faire : R2 + SELECT + B est la fermeture forcée de muOS. Mettez d’abord en pause pour que le monde soit sauvegardé.
En résumé
- Possédez Minecraft Java Edition et installez une fois la 1.12.2 (ou la 1.7.10) avec le lanceur officiel.
- Copiez
versions/1.12.2,librariesetassetsdansports/minecraftjava/.minecraft/. - Gardez
ROMS/Portspropre, sans scripts.bak. - Utilisez des réglages vidéo bas (distance d’affichage 4, graphismes rapides, 30 FPS). Si ça saccade encore, voir les étapes de dépannage ci-dessus.
Des questions ? Écrivez à feedback@pocketkode.com.
Minecraft est une marque de Mojang Synergies AB. PocketKode n’est affilié ni à Mojang, ni à Microsoft, ni à PortMaster, ni à muOS, ni à Anbernic.