Godot est un moteur de jeu libre et gratuit (licence MIT), créé par Juan Linietsky et Ariel Manzur et ouvert au public en 2014. Il est aujourd'hui l'un des moteurs les plus utilisés par les studios indépendants et les amateurs : des milliers de jeux 2D et 3D en sont sortis, du petit jeu de game jam gratuit au succès commercial comme Brotato ou Dome Keeper.
Un jeu Godot se compose de deux parties : le moteur, qui est un exécutable, et les données du jeu — niveaux, images, sons, scripts — réunies dans un paquet appelé .pck. Ces données ne contiennent aucun code propre à une machine : Recalbox les lance avec son propre moteur, compilé pour votre carte. C'est ce qui permet de jouer sur Raspberry Pi à un jeu publié uniquement pour Windows.
| Projet | Godot Engine |
| Auteurs | Juan Linietsky, Ariel Manzur, puis la communauté Godot |
| Première version publique | 2014 |
| Type de jeux | Tous genres, 2D et 3D |
| Licence | MIT |
| Manette | Obligatoire |
| Clavier, souris | Facultatifs — certains jeux les exigent |
Les moteurs livrés avec Recalbox sont les gabarits d'export officiels du projet Godot : le même binaire que celui qui fait tourner le jeu chez son auteur. Rien n'est réécrit, rien n'est émulé. Seule exception, sur Raspberry Pi : le moteur de la branche 4 y est recompilé par Recalbox, parce que le processeur graphique du Pi refuse les images de plus de 4096 pixels — que le moteur officiel laisse noires, alors que celui-ci les réduit à la limite.
Nouveau en Recalbox 11.0 : le système Godot Engine fait son entrée.
Disponibilité des émulateurs par board :
| Émulateur | RPI3/RPI02W | RPI4/400 | RPI5/500 | OGA/OGS/RG351 | PC | RG353 |
|---|---|---|---|---|---|---|
| godot | ❌ | ✅ | ✅ | ❌ | ✅ | ❌ |
Recalbox embarque un moteur par branche : Godot 4.7.2 et Godot 3.6.3. Le bon est choisi tout seul, d'après la version inscrite dans le fichier du jeu.
Il n'y a rien à paramétrer : plein écran, manettes, son et résolution sont réglés à chaque lancement. Deux optimisations sont appliquées au passage, posées à côté du moteur et jamais dans le fichier du jeu : le rendu à la résolution de conception du jeu, et un plafond sur la finesse des ombres des jeux 3D.
Le netplay n'est pas disponible sur ce système et les RetroAchievements ne sont pas pris en charge. L'affichage CRT est géré.
Placez vos jeux dans :
/recalbox/share/roms/godot/
Extensions acceptées : .pck .exe .x86_64
Un jeu Godot téléchargé se présente en général sous la forme d'un dossier contenant un exécutable, parfois accompagné d'un fichier .pck. Copiez un seul fichier par jeu :
.pck s'il y en a un, c'est le meilleur choix ;.exe de la version Windows ou le .x86_64 de la version Linux. Les données du jeu sont rangées à la fin de ce fichier, et Recalbox sait les en extraire.Les fichiers .dll, .so et autres livrés à côté ne servent à rien.
/recalbox/share/roms/godot/
├── Gizmoduck.pck
├── Tiny Crate.pck
└── Super Mario 127.exe
Vous pouvez ranger vos jeux dans des sous-dossiers.

Pas besoin de scraper. ScreenScraper ne connaît presque aucun jeu Godot : Recalbox lit donc le nom et la description dans le jeu lui-même, et en prend une image. Tant que le jeu n'a jamais été lancé, c'est son écran de démarrage ou son icône ; à la première partie, Recalbox fait plusieurs captures entre 20 secondes et une minute et demie de jeu, garde la plus colorée, et la préfère ensuite à tout le reste.

Si un jeu réclame un fichier d'origine — par exemple Super Mario Bros. Remastered, qui demande la ROM NES de Super Mario Bros. — posez ce fichier dans le même dossier que le jeu. Recalbox le trouve seul, aux extensions habituelles : .nes .sfc .smc .gb .gbc .gba.
.pck ou l'exécutable depuis le dossier d'installation du jeu.Les petits jeux écrits en GDScript, le langage de Godot, passent presque tous. Les gros jeux commerciaux sont plus exigeants : voir Ce qui ne peut pas tourner.
| Manette | Effet |
|---|---|
| Hotkey + Start, ou Select + Start | Quitter le jeu |
| Appui long sur Start, 2 secondes | Quitter le jeu, sur une manette qui n'a ni hotkey ni Select |
| Hotkey + L1, ou Select + L1 | Afficher ou cacher les images par seconde |
| R3 | Afficher ou cacher le clavier à l'écran |
| Stick droit | Déplacer le pointeur de souris |
| X, Y | Clic gauche, clic droit |
Les commandes du jeu lui-même dépendent de chaque jeu. Certains se jouent au clavier et à la souris uniquement : branchez-les.
Un petit jeu tourne sur le moteur le plus récent de sa branche ; un gros, souvent, exige celui avec lequel il a été fait. Rien, dans le fichier du jeu, ne permet de le prévoir : Recalbox le lance d'abord sur le moteur de l'image, et regarde ce qui se passe.
Si le jeu ne démarre pas, un écran l'explique et donne la version qu'il lui faut. Ces moteurs supplémentaires se téléchargent depuis :
MENU PRINCIPAL → TÉLÉCHARGEMENT DE CONTENUS → Télécharger du contenu pour Godot Engine
Cette entrée ne télécharge pas tout, et malgré son nom elle ne télécharge pas de jeux : elle prend d'un coup les moteurs qui ont manqué à vos jeux, et rien d'autre. Un jeu qui tourne n'y laisse jamais de trace.

Les moteurs ainsi récupérés sont rangés sur le partage, dans /recalbox/share/system/.cache/godot/engines, et survivent aux mises à jour de Recalbox. Une connexion Internet est nécessaire pour les télécharger.
Les versions disponibles ne sont pas les mêmes partout, parce que le projet Godot ne publie pas de moteur ARM64 avant la 4.2 :
| Versions téléchargeables | |
|---|---|
| PC | 3.0 à 3.5, et 4.0 à 4.6 |
| Raspberry Pi | 4.2 à 4.6 |
Comme le moteur livré dans l'image, les moteurs de la branche 4 téléchargés sur Raspberry Pi sont ceux recompilés par Recalbox. Sur PC, ce sont les moteurs officiels du projet Godot, inchangés.
Quand un jeu ne peut pas démarrer, un écran le dit au lancement ; Select + Start revient au menu. Ce n'est jamais « c'est du Godot ou non » — les causes sont connues :
| Cas | Pourquoi |
|---|---|
| Jeu écrit en C# (version .NET de Godot) | Aucun moteur C# n'est livré avec Recalbox, sur aucune machine. Ces jeux sont refusés avec un message clair. |
| Jeu qui embarque du code natif — FMOD, Steamworks | Ce code est compilé pour PC : il n'existe pas en ARM, donc jamais sur Raspberry Pi. |
| Jeu fait avec un moteur plus récent que ceux disponibles | Aucun moteur ne sait l'ouvrir, et il n'y en a pas à télécharger. |
| Jeu fait avec Godot 2 | Le plus ancien moteur disponible est un 3.0. |
Deux remarques :
Sur Raspberry Pi, un jeu 3D aux effets avancés peut par ailleurs être trop lent pour être agréable, sans être pour autant refusé.
recalbox.conf| Clé | Valeurs | Effet |
|---|---|---|
godot.showfps |
0 / 1 |
Affiche les images par seconde dès le lancement. Par défaut, suit le réglage global du frontend. |
godot.shadows |
low, medium (défaut), high, max |
Finesse des ombres des jeux 3D. Plus bas, c'est plus rapide ; max retrouve les ombres voulues par l'auteur, au prix des images par seconde. |
godot.cursor.timeout |
secondes, 0 = jamais |
Délai avant que le pointeur de souris disparaisse. |
Les sauvegardes et les réglages de chaque jeu sont dans :
/recalbox/share/saves/godot/
Quand vous supprimez un jeu depuis Recalbox, il vous propose aussi de supprimer ses sauvegardes, comme pour les autres systèmes.
Un jeu Godot range tout ce qui vient du joueur — sauvegardes, réglages, packs de ressources ou de textures, mods, niveaux faits maison — dans son dossier de données, jamais à côté du jeu. Sur Recalbox, ce dossier est dans /recalbox/share/saves/godot/, sous l'une de ces deux formes :
/recalbox/share/saves/godot/<Jeu>/
/recalbox/share/saves/godot/godot/app_userdata/<Jeu>/
Lancez le jeu une fois pour que son dossier soit créé, puis copiez-y le pack ou le mod, dans le sous-dossier que le jeu attend.
Par exemple, un pack de ressources pour Super Mario Bros. Remastered se copie dans /recalbox/share/saves/godot/SMB1R/resource_packs/, à côté du dossier BaseAssets que le jeu y crée lui-même. On l'active ensuite dans le jeu : Paramètres, puis flèche droite deux fois jusqu'à Packs de Ressources, choisir le pack et valider.
Seuls les jeux prévus pour accueillir des packs ou des mods en acceptent.