HGL
xenial-black
How do You Launch DOS GOG Games?
All of the GOG DOS games do the same thing: Opens up DOSBox and then closes. I think it's because it's trying to open the Windows version of DOSBox that comes with the game. Anyway of making the game grab the Linux version of DOSBox instead?
107 Replies
Yup, it's documented on our Wiki
xenial-blackOP•2y ago
Sweet, thanks!
I think something is missing on that wiki page.
foreign-sapphire•2y ago
What makes you say that?
xenial-blackOP•2y ago
Doesn't tell me what to change in the launch arguments for DOSBox, only scummvm.
Well it's the same process for dosbox
Launch your system dosbox with the args from the launch option
xenial-blackOP•2y ago
You're taking to someone who's been using Linux for less than a month.
It's a little late where I'm at, I can get you some more detailed instructions tomorrow
xenial-blackOP•2y ago
ok, thank you
eager-peach•2y ago
Also, depending on the game, it may be less hassle to use ScummVM.
xenial-blackOP•2y ago
Able to make it work in Steam (without CD-ROM audio because of the lack of MSCDEX), but the same command doesn't work in HGL.
Arg, sorry, forgot about this:
First of all, make sure DOSBox is installed (
dosbox
package on most major distros)
Look at the primary play task in the goggame-<numbers>.info
file in the game directory. I'll be using "Bio Menace" as an example here
This is the relevant play task:
From this, you can tell that
- The game is indeed launched with DOSBox
- DOSBox should be launched in the working directory <path to game install>/DOSBOX
- These start parameters should be passed to it: -conf "../dosbox_biomenace.conf" -conf "../dosbox_biomenace_single.conf" -noconsole -c "exit"
So, to launch this game with your system DOSBox, you'd
1. cd
into <path to game install>/DOSBOX
2. Run dosbox -conf "../dosbox_biomenace.conf" -conf "../dosbox_biomenace_single.conf" -noconsole -c "exit"
xenial-blackOP•2y ago
Will the flatpak verison of DOSBox work?
Sure, you'd just have to modify the final command a bit (replacing the initial
dosbox
with flatpak launch com.dosbox.DOSBox
)xenial-blackOP•2y ago
Taking Rayman Forever as my example, would it be this?
"name": "Rayman Forever",
"path": "flatpak launch com.dosbox.DOSBox",
"type": "FileTask",
"workingDir": "DOSBOX"
Don't change anything in the .info file; that won't work at all
You're supposed to just look at what's there and then build a launch command yourself from that
xenial-blackOP•2y ago
oh, well that part on the Wiki was not clear
Rayman Forever has an additional configuration in it's info file:
"name": "Graphic Mode Setup",
"path": "DOSBOX\GOGDOSConfig.exe",
"type": "FileTask",
"workingDir": "DOSBOX"
Yup that's normal, you don't have to worry about that one (it's not the primary task)
xenial-blackOP•2y ago
ok, here goes nothing
Didn't work, what I've done wrong?
xenial-blackOP•2y ago
Screenshot

You don't do anything inside Heroic, you just run that command you've built (in a terminal window)
(I guess you could add a sideloaded game for this, assuming you're not using the Heroic Flatpak, but one thing at a time)
xenial-blackOP•2y ago
Oh, I guess there was a misunderstanding. My whole purpose for asking here was to launch it via HGL.
I see. If you're using the Flatpak version of Heroic, this is sadly a limitation of Flatpak (Flatpak sandboxes applications, meaning Flatpak Heroic can't launch your system's DOSBox, or any other application on your system for that matter)
If you aren't using the Flatpak, this is perfectly doable, it's just easier to experiment with a "simple" shell command first (all Heroic does in the end is running that command, so making sure it's correct would be my first step)
xenial-blackOP•2y ago
I'm sure I could get the non-flat pack version to install if I have to. So you want me to run this from a terminal?
flatpak run com.dosbox.DOSBox /run/media/nickg/sda1/GOG/Rayman Forever/RayFan/RAYFAN.bat "-conf "..\dosboxRayman.conf" -conf "..\dosboxRayman_single.conf" -noconsole -c "exit"
You might have to replace the
\
in paths with /
, but other than that yesxenial-blackOP•2y ago
If I run the entire command, it's not doing anything. If I remove the arguments, it just launches DOSBox.
Could you send in the
.info
file you're looking at?xenial-blackOP•2y ago
OK, I modified the command by adding quotes to the game path and it now launches: flatpak run com.dosbox.DOSBox "/run/media/nickg/sda1/GOG/Rayman Forever/RayFan/RAYFAN.bat"
That being said, can't get the arguments to work.
You seem to have an extra
"
at the start of the arguments ("-conf
-> -conf
)xenial-blackOP•2y ago
Indeed there was. It's working now, mind you, I'll get no music since this version of DOSBox (flatpak) doesn't seem to come with MSCDEX:

It doesn't look like you're in the right working directory there
xenial-blackOP•2y ago
What do you mean?
Quoting my original instructions:
So, to launch this game with your system DOSBox, you'd 1.This is important, since the config file paths in the arguments are relative, so DOSBox can't load them if you're not in the correct directorycd
into<path to game install>/DOSBOX
xenial-blackOP•2y ago
So it should start like this: cd into /run/media/nickg/sda1/GOG/Rayman Forever/DOSBOX flatpak run com.dosbox.DOSBox
cd "/run/media/nickg/sda1/GOG/Rayman Forever/DOSBOX" && flatpak run ...
(replacing the ...
with the rest of the command of course)xenial-blackOP•2y ago

xenial-blackOP•2y ago
No, still get the MSCDEX error.
xenial-blackOP•2y ago
At the end of the day, if it's running my DOSBox flatpak and it doesn't have MSCDEX, it's not gonna play music:

Oh, I see now; should've been more clear, replace instances of just one
\
with nothing at all (they were originally there to escape the "
that followed them, but this isn't needed outside of the .info file), replace instances of two \
(\\
) with a /
The second part of the command should be
flatpak run com.dosbox.DOSBox /run/media/nickg/sda1/GOG/Rayman Forever/RayFan/RAYFAN.bat "-conf "../dosboxRayman.conf" -conf "../dosboxRayman_single.conf" -noconsole -c "exit"
I can also only recommend to use code blocks when sending in commands like this. If you scroll up a bit, you can see that the command you sent in does not match with what you ran now (since Discord also uses \
to escape characters, so it used a similar strategy of simply removing \
and replacing \\
with \
)
To create a code block in a message, add 3 backticks ( ` ) on a new line in your message, followed by your message content, followed by another 3 backticks:
```
your content here
```
creates
xenial-blackOP•2y ago
The arguments didn't work. I tried fixing it, but it CD Audio still didn't work:
-conf /"..//dosboxRayman.conf" -conf /"..//dosboxRayman_single.conf"
This is what I just referencing; I assume you got to that from something like this in the .info file:
-conf \"..\\dosboxRayman.conf\" -conf \"..\\dosboxRayman_single.conf\"
Now applying what I mentioned
- Replace any \\
sequences with /
- Remove any "single" \
should leave you with this:
-conf "../dosboxRayman.conf" -conf "../dosboxRayman_single.conf"
So the full command should be:
xenial-blackOP•2y ago
It opens and closes DOSBox. I removed "exit" at the end and it stayed open, but still the same message, so no music.
Is there anything interesting in the output (what's printed to the Terminal after you run the command)?
xenial-blackOP•2y ago
xenial-blackOP•2y ago
That's the game I own alright. When I ran it in Windows via the GOG Galaxy launcher, the music was playing.
Right, gimme a moment

xenial-blackOP•2y ago
😅 You didn't have to buy it, I could "lent" the setup file.
Heroic's GOG downloads aren't just the offline setups actually, so this wouldn't have worked (other than that, the legality of that is a little questionable)
Seems like the config files DOSBox is looking for just... aren't there?
This is what the Bio Menace folder I've tested with looks like. I've highlighted the .conf files in red

Rayman Forever on the other hand just doesn't have any?

xenial-blackOP•2y ago
look in the RayFan folder
No I'm looking for the files referenced in the arguments
We run the command in
DOSBOX
, so ../dosboxRayman.conf
evaluates to just <game install>/dosboxRayman.conf
, but that just doesn't exist?xenial-blackOP•2y ago
I need to go make supper now, but after that, I'll boot back in Windows, install it from GOG Galaxy and see how it's structured. I'll keep you posted. Thank you very much for your help.
@Linguin (late night ping woo) Checking the Depots for this game on https://www.gogdb.org/product/1207658919/build/52095557858882770, it seems GOGDL doesn't download the 2nd-to-last one (which contains the
.conf
files, albeit in a suspicious app
sub-directory)?xenial-blackOP•2y ago
Hey there, I know you're probably sleeping, so when you wake up, I have a few things for you to look at:
1- Here's the zipped folder of Rayman Forever that was installed via GOG Galaxy on my Windows partition (file will automatically be deleted after 6 days):
https://filebin.net/prhdb4ly0olbz3zq/Rayman_Forever.zip
2- Here's a gameplay recording showing the differences when booting and you can hear the music playing:
https://www.youtube.com/watch?v=3kAOcvetWVw
3- The Windows shortcut has arguments in it:
automatic-azure•2y ago
it does, it's in support directory
requires setup to complete and as it is now it's broken on windows
CONFIG_DIR/heroic/gogdlConfig/heroic_gogdl/support
xenial-blackOP•2y ago
Hi there, you may want to look at the reply I made to CommandMC.
@Linguin I'm not quite sure what "setup" means here, but the files are indeed there (
support
folder is named gog-support
though)
@Waifu4Life So as per @Linguin's instructions, copy the contents of ~/.var/app/com.heroicgameslauncher.hgl/config/heroic/gogdlConfig/heroic_gogdl/gog-support/1207658919/app
into your game directory. Assuming that's still at /run/media/nickg/sda1/GOG/Rayman Forever
, a command for this would be:
cp ~/.var/app/com.heroicgameslauncher.hgl/config/heroic/gogdlConfig/heroic_gogdl/gog-support/1207658919/app/* "/run/media/nickg/sda1/GOG/Rayman Forever"
After copying those files into the game directory, seems like we have some more problems:
- Paths in the .conf
files use \
as a path separator
- As you mentioned, installing MSCDEX doesn't work
To solve the first issue, simply edit dosboxRayman_single.conf
(the one in the game directory) and replace all \
with /
2nd one is a little more tricky. Still in dosboxRayman_single.conf
, the 7th line should have a command like this: imgmount d "../game.ins" -t iso -fs iso
. Now I've googled a bit here, and imgmount
should mount the disk image you give it, which may be on your real hard drive, into DOXBos. In this case the image is ../game.ins
(which should be fine). However, it seems that DOSBox for Linux's imgmount command doesn't understand relative paths for some reason (the command always gives me a "Failed to mount" error)
We can work around this though, by simply mounting the game directory as a whole with MOUNT
first (which mounts a folder on your hard drive), and then telling IMGMOUNT to go from there. Replace the imgmount line with this:
automatic-azure•2y ago
setup is the process of calling script interpreter on game install, on Windows it's broken currently. I've merged a patch for it already though
Oh was that the getWinePath one?
automatic-azure•2y ago
yep
Well we're on Linux here
automatic-azure•2y ago
that should be moved automatically on the first game launch then
🤷 Didn't happen for me, and evidently didn't happen for OP either
automatic-azure•2y ago
:Ohno:
got the Heroic log of the first launch?
I'd test myself but I don't own that game in particular and I'd rather wait for next sale
I think I do; brb though, lunch first
So turns out I didn't launch the game in Heroic
But after re-installing and doing that now, the files still don't appear
In the logs I see this:
This also looks interesting (in the game install dir)
automatic-azure•2y ago
yeah that's the log of what was changed in registry etc...
Sooo, any idea why the interpreter didn't copy the support dir?
automatic-azure•2y ago
it didn't?
Nope, files are still missing from the game dir
automatic-azure•2y ago
hmm
They're in the config folder, and it looks like that's passed correctly to SI, but SI then just... doesn't
Does the thing handle spaces in paths correctly?
automatic-azure•2y ago
yeah
We're working with a "Rayman Forever" folder after all
automatic-azure•2y ago
did it create .ico file?
Yup
automatic-azure•2y ago
then it worked

No .conf files though
automatic-azure•2y ago
maybe the support dir is not passed in correctly
although I doubt
I double checked that behavior with Galaxy
what's the .script file
automatic-azure•2y ago
well first instruction is to copy
it also made cloud saves directory
Can I somehow run this interpreter with debug logging or something?
automatic-azure•2y ago
yeah, let's go to dm it's a bit off topic I think
Threads inside threads wen
Alright, update time
@Waifu4Life Scratch everything I've said above, we've got the original issue (why the game doesn't launch in Heroic) resolved now:
1. Download the attached gogdl binary, move it to
~/Games/Heroic/
and make it executable (chmod +x ~/Games/Heroic/gogdl
)
2. In Heroic, head to "Settings" (sidebar) -> "Advanced", click the 📁 icon to the right of the alternative GOGDL binary box and select the gogdl binary you just moved. Should look somewhat like the attached screenshot afterwards (of course with your username)
3. Head to the game's page in Heroic, click the 3-dot menu in the top-right, and hit "Verify and Repair"
4. Delete this folder: ~/Games/Heroic/Prefixes/Rayman Forever
5. Launch the game; should now work finexenial-blackOP•2y ago
Cool, I'll try it tonight (currently working right now using my Windows partition).
deep-jade•2y ago
I had issues playing Settlers 2 (which also uses DOSBox). But following your instructions fixed it. Thanks 🙂
xenial-blackOP•2y ago
Hi there. So 9 DOS on my GOG collection, 6 launched, 3 didn't. Tomb Raider 1, Jill of the Jungle and Jazz JackRabbit 1 did not launch. Wolfenstein 3D, Wolfenstein: Spear of Destiny, Rayman Forever and the Alone in the Dark Trilogy did launch properly, but the gameplay was janky, reminded of playing SNES emulation back on my Pentium 100MHz with frameskip. Is HGL using the DOSBox that came with the game or the native Linux DOSBox?
foreign-sapphire•2y ago
Always using whatever GOG packages.
dependent-tan•2y ago
dont use the linux versions , i never made those work , and the game is soo low powered , that you are good with the windows ones
Heroic is using the DOSBox shipped with the game. You can still follow https://discord.com/channels/812703221789097985/1208593003183210496/1209114981782523934 to launch the game with your system DOSBox
As for the other games, could you send in the
.info
and .script
files in the install directories of one of those games?xenial-blackOP•2y ago
Hey there, sorry for the late reply, crazy week. I decided to take another route. I manually installed DOSBox Staging. I then created an executable SH file with the following:
Finally, I added the SH file in Steam. When I launch it, it's clear that it runs the first configuration file because I go full screen Vs just launching the BAT file via DOSBox Staging itself. That being said, the 2nd conf file (dosboxRayman_single.conf) doesn't seem to load at all. I tried making the modifications you suggested:
and
I still get the infamous message about MSCDEX.
foreign-sapphire•2y ago
imgmount
interprets paths as host paths i.e. it's looking for ./E:/GAME.INS
in the Linux filesystem. Use simply GAME.INS
and it should work.
By the way, you know the dosboxRayman_single
file is being loaded because that's what's running the game, and it's the game which is giving you the misleading MSCDEX message. That message simple suggests that the CD is not mounted properly (DOSBox will load its own MSCDEX implementation automatically when you (successfully) mount a CD).xenial-blackOP•2y ago
You mean like this:
foreign-sapphire•2y ago
Right.
xenial-blackOP•2y ago
Didn't change anything
I get feeling that it's not loading that config file in my argument:
Why do you have
"/run/media/nickg/sdb1/GOG/Rayman Forever/RayFan/RAYFAN.bat"
in that command? The arguments in the info file don't include it, and you won't be launching the right executable with that
Anyways, the script also assumes that your current working directory is <game install dir>/DOSBOX
, so that's likely your issue
Assuming you're in that working directory, the command dosbox -conf "../dosboxRayman.conf" -conf "../dosboxRayman_single.conf" -noconsole -c "exit"
should launch the game (with no further modifications necessary if you're on DOSBox Staging)xenial-blackOP•2y ago
Oh, I only assumed that I needed to launch the actual game in the command. When I remove the BAT file out of the command, I get to the selection menu, but it then quits.
Right, that's what happens when the game can't find MSCDEX
- You are using DOSBox Staging, correct? What does
dosbox --version
say?
- Assuming you are using Staging, undo any modifications you've made to the .conf files (verifying your game files should do the trick)xenial-blackOP•2y ago
Where are the Staging config files located?
Well, at the very least I found a sort of way of playing it in DOSBox by mounting the image, installing the game and playing it that way. It's the OG Rayman, not Rayman Forever, but at least it has music.
The config files are where they always were, in the game install dir
This is incorrect (I mean, I wouldn't have recommended to use those commands if they wouldn't have worked for me)
imagefile Location of the image files to mount in DOSBox. The location can be on a mounted drive inside DOSBox, or on your real disk.- https://www.dosbox.com/wiki/IMGMOUNT
xenial-blackOP•2y ago
Oh OK, I thought you meant the config file located in /home/nickg/.config/dosbox (which I found out later)
I undid the modifications of the config file by restoring it from the zip I created. Now without the BAT file, I get this:
https://i.postimg.cc/5jdcB5kM/Screenshot-20240224-163702.png
xenial-blackOP•2y ago
OK, managed to make everything work, I'll make a short guide later on.
xenial-blackOP•2y ago
@CommandMC Hi there, I made a small GitHub for DOS Games usage in HGL: https://github.com/Waifu4Life/DOS-Games-with-Heroic-Games-Launcher
GitHub
GitHub - Waifu4Life/DOS-Games-with-Heroic-Games-Launcher: To proper...
To properly launch DOS games from GOG.com and other places with Heroic Games Launcher - Waifu4Life/DOS-Games-with-Heroic-Games-Launcher