Cette page concerne l'émulateur DOSBox standalone, celui qui fonctionne avec des dossiers .pc. Si vos jeux sont des archives .zip que vous lancez directement, vous utilisez plutôt DOSBox Pure et n'avez rien de tout cela à faire — voyez le guide DOS.
L'émulation DOS n'est pas « plug and play » : chaque jeu a ses spécificités. Mais dans les grandes lignes, la marche à suivre est toujours la même — et une fois le jeu configuré, vous n'y touchez plus jamais.
/recalbox/share/roms/dos, décompressés : ce sont des dossiers, pas des archives..pc — c'est ce qui permet à EmulationStation de le repérer comme un jeu. La partie avant le point doit faire 8 caractères maximum, sans espace, sans accent ni caractère spécial.C: au lancement. Pour DOSBox, rien d'autre n'existe.dosbox.bat contient les commandes DOS à exécuter. Il s'édite avec n'importe quel éditeur de texte simple..bat en priorité, puis ceux en .exe.CTRL + F9.Après chaque modification du dosbox.bat, mettez à jour la liste des jeux si le jeu n'apparaît pas encore, puis relancez-le.
Le cas le plus simple. Prenons Alley Cat :
AlleyCat.pc dans /recalbox/share/roms/dos.dosbox.bat contenant :c:
CAT.EXE
Si le jeu comporte un fichier setup ou install servant à configurer le son, faites-le tourner d'abord. Écrivez temporairement :
setup
pause
L'instruction pause fige l'écran avant le retour à EmulationStation : c'est votre seul moyen de lire les messages d'erreur. Dans le programme de configuration, choisissez Sound Blaster 100 % compatible pour la musique et pour les effets, avec le paramétrage automatique. Remplacez ensuite setup par l'exécutable du jeu.
Créez un sous-dossier source dans votre dossier .pc et placez-y les fichiers d'origine du jeu, pour éviter toute confusion. Puis :
cd source
install
pause
Lors de l'installation, le programme vous demandera un chemin de destination : indiquez c:\cible (le nom est libre). Une fois l'installation et la configuration du son terminées, votre dosbox.bat final devient :
cd cible
s2
pause
(en remplaçant s2 par l'exécutable de votre jeu.)
Le dossier
sourcen'est souvent plus utile après l'installation — ce type d'installation ne faisait que recopier les disquettes sur le disque dur. Testez avant de le supprimer.
Deux différences par rapport au cas précédent : il faut monter l'image CD sur un lecteur virtuel, et généralement la garder montée pendant le jeu (cinématiques, musiques).
Créez un dossier source_cd à la racine de votre dossier .pc et placez-y l'image CD. Ajoutez ensuite la ligne de montage en tout début de dosbox.bat, selon le format :
| Format | Commande |
|---|---|
| BIN/CUE | imgmount D "C:\source~1\settle~1.cue" -t iso -fs iso |
| ISO | imgmount D "C:\source~1\settle~1.iso" -t iso -fs iso |
| IMG | imgmount D "C:\source~1\settle~1.img" |
| Fichiers en clair | mount D "C:\source~1" |
Le reste est identique au cas 2 : cd source_cd pour l'installation, puis cd cible pour le lancement.
Les noms de fichiers doivent respecter la convention DOS : 8 caractères maximum, les noms plus longs étant tronqués avec
~1,~2… Le plus simple reste de renommer vos fichiers avec des noms courts.
Pour les CD mixtes (données + pistes audio), l'image doit tenir dans un seul fichier
.imgou.bin: DOSBox ne gère pas les images découpées en plusieurs.bin. Le montage doit alors impérativement se faire via le fichier.cuepour que les pistes audio soient chargées.
dosbox.cfgPlacé à côté de dosbox.bat, un fichier dosbox.cfg permet de définir une configuration DOS spécifique au jeu. Partez du fichier de référence /recalbox/share/system/configs/dosbox/dosbox.conf.
L'extension doit bien être
.cfgdans le dossier du jeu, et non.conf.
La ligne mapperfile=mapper.map permet d'associer n'importe quelle touche du clavier — ou la souris — à un bouton de votre manette. Le fichier mapper.map se génère en cours de jeu avec CTRL + F1, et est enregistré à côté de vos dosbox.bat et dosbox.cfg.
Certains paramètres du dosbox.cfg peuvent aussi être placés en tête du dosbox.bat. Tout ce qui touche à l'affichage fonctionne ; mapperfile, en revanche, ne fonctionne que dans le .cfg.
Si vous récupérez un jeu déjà préparé pour DOSBox sur PC, ne copiez pas son dosbox.cfg tel quel : cela provoque des bugs difficiles à diagnostiquer. Repartez du fichier de référence de Recalbox, et récupérez seulement ce qui compte : la section [autoexec] du fichier d'origine.
Exemple avec Wacky Wheels. Le [autoexec] d'origine :
[autoexec]
cd ..
cd ..
mount c .\games\WackyWhe
imgmount d .\games\WackyWhe\cd\wackywheels.iso -t cdrom
c:
cd wacky
cls
@ww
exit
Devient, dans votre dosbox.bat :
imgmount d .\cd\wackyw~1.iso -t cdrom
c:
cd WACKY
pause
WW.EXE
Ce qui a changé et pourquoi :
mount c disparaît — C: est déjà monté sur le dossier du jeu ;exit disparaît — la sortie est gérée par Recalbox ;imgmount est raccourci au format DOS (wackyw~1.iso) ; mieux vaut de toute façon renommer le fichier ;pause est ajouté temporairement pour vérifier que le montage fonctionne — à retirer ensuite (ne le mettez jamais après l'appel du jeu, vous ne verriez rien) ;@ww devient WW.EXE, l'appel de l'exécutable.Si le jeu utilise un lanceur .bat, recopiez ses instructions à la suite et adaptez-les de la même façon.
Les noms longs ne sont pas non plus acceptés dans les fichiers
.cue: vous devrez peut-être renommer les.binet corriger la référence dans le.cue.
Le clavier virtuel s'ouvre par défaut avec CTRL + F2. Un bouton dédié est également disponible dans le mapper (CTRL + F1 > Virt Keyb) pour l'associer à une autre touche, à la souris ou au joystick.
Une fois ouvert, sélectionnez les touches à la souris ou au joystick :
Cela permet de composer des combinaisons avec Shift, Ctrl ou Alt. Le bouton V vert ferme le clavier et envoie les événements à DOSBox ; la croix rouge annule.
Si vous utilisez un fichier de mapping existant, la combinaison
CTRL+F2n'y sera pas configurée. Et si vous quittez le clavier virtuel avec une touche maintenue, elle restera envoyée en continu à DOSBox jusqu'à ce que vous rouvriez le clavier. Enfin, les mappings joystick et souris sont ignorés tant que le clavier virtuel est ouvert.
L'image est déformée — passez aspect=false à aspect=true dans dosbox.cfg pour obtenir un 4/3. Attention : sur des jeux plus récents, cela peut coûter cher en performances.
Le joystick bouge tout seul — essayez timed=false → timed=true. Cela peut aussi venir de la zone morte du joystick, que DOSBox ne permet malheureusement pas de régler.
Le mapper efface mon fichier ou mélange mes boutons — c'est le paramètre buttonwrap. À true, il réattribue les boutons dont l'identifiant dépasse le nombre de boutons du joystick émulé, en repartant de zéro. Mettez-le à false.
CD Not Found / CD Driver not present — vos fichiers CD sont mal nommés (ou le .cue mal édité), ou les noms ne respectent pas la convention DOS.
mount a ou mount d ne fonctionne pas — contrairement à imgmount, la commande mount ne comprend pas les chemins internes à la machine DOSBox. Elle exige un chemin absolu réel du système de fichiers Recalbox.
Le D-pad d'une manette Xbox n'est pas mappable — le mapper DOSBox permet de le configurer, mais cela ne fonctionne pas en jeu. Essayez de changer le type de joystick.
Si vous restez bloqué, exposez votre problème sur le Discord Recalbox en précisant les messages d'erreur relevés.