<!DOCTYPE article PUBLIC "-//Davenport//DTD DocBook V3.0//EN">

<!-- This is the dosemu tweaks SGML source -->

<article>

<artheader>

<title>Known tweaks needed to run programs under dosemu</title>

<abstract>

<para>
This file lists programs that needs specific tweaks in order to
run them under dosemu2.
</para>

</abstract>

</artheader>

<sect1>
<title>Millenium</title>

<sect2>
<title>
Millenium game fails to detect Sound Blaster, unless the SB IRQ is 5
</title>
<para>
Solution: set $_sb_irq=(5). Fortunately this is a default setting, so
in most cases you won't care.
</para>
</sect2>
<sect2>
<title>
Millenium game crashes when entering space combat
</title>
<para>
Solution: to the file 2200gx.exe apply the following patch:
<screen>
000030B2: AA 47
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Need For Speed Special Edition</title>
<sect2>
<title>
Wrong colors in video clips.
</title>
<para>
Solution: to file nfs.exe apply the following patch:
<screen>
000607E6: 00 08
</screen>
<ulink url="http://www.os2museum.com/wp/need-for-speed-se-video-glitch/">
see here for details
</ulink>
</para>
</sect2>
<sect2>
<title>
Hangs or glitches in video clips.
</title>
<para>
Solution: to file nfs.exe apply the following patch:
<screen>
000B8E5A: 78 EB
000B8E72: 78 EB
</screen>
</para>
</sect2>
<sect2>
<title>
Installer crashes or unstable.
</title>
<para>
Solution: to file infsd.exe apply the following patch:
<screen>
0002873E: 7C EB
</screen>
<ulink url="https://github.com/stsp/dosemu2/issues/26#issuecomment-98486498">
see here for details
</ulink>
</para>
</sect2>
</sect1>

<sect1>
<title>Gobliiins</title>
<sect2>
<title>
Goblins halts at startup with "Divide Error" message
</title>
<para>
Solution: apply the following patch to gobega.exe:
<screen>
00004A19: F7 90
00004A1A: F3 90
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Prehistorik 2</title>
<sect2>
<title>
Game freezes or crashes shortly after start.
</title>
<para>
Solution: set
<screen>
$_umb_f0 = (off)
</screen>
in your dosemu.conf or .dosemurc.
<ulink url="https://www.vogons.org/viewtopic.php?t=4182">
see here for details
</ulink>
</para>
</sect2>
<sect2>
<title>
Sound is crackling.
</title>
<para>
Solution: set
<screen>
$_dos_up = (off)
</screen>
in your dosemu.conf or .dosemurc.
The only "explanation" we can provide, is a conspiracy theory that
prehistoric is trying to slander third-party DOSes that put LoL/SDA
to UMB.
</para>
</sect2>
</sect1>

<sect1>
<title>Carmageddon</title>
<sect2>
<title>
Timer is too fast during race
</title>
<para>
<ulink url="http://carmageddon.wikia.com/wiki/Glitch:Sped_up_timer">
see here for details
</ulink>
</para>
<para>
Solution: for hi-res mode, apply the following patch to carma.exe:
<screen>
00083549: 89 83
0008354A: C5 E8
0008354B: 29 04
0008354C: F5 90
0008354D: 89 90
0008354E: 2D A3
</screen>
</para>
<para>
For low-res mode, apply the following patch to carma.exe:
<screen>
00083549: 89 83
0008354A: C5 E8
0008354B: 29 02
0008354C: F5 90
0008354D: 89 90
0008354E: 2D A3
</screen>
</para>
<para>
Unfortunately the timer is still a bit unstable, and runs as slower
as faster you drive your car.
To completely disable the timer, apply the following patch to carma.exe:
<screen>
00083549: 89 83
0008354A: C5 E8
0008354B: 29 00
0008354C: F5 90
0008354D: 89 90
0008354E: 2D A3
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Simon 2</title>
<sect2>
<title>
Game freezes at start.
</title>
<para>
Solution: apply the following patch to runflat.exe:
<screen>
000130FF: 75 90
00013100: F7 90
00013110: 75 90
00013111: F6 90
00013112: D1 90
00013113: E9 90
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Prince of Persia 2</title>
<sect2>
<title>
Game slows down unbearably after some playing.
</title>
<para>
Solution: update to v1.1 of the game or apply the following
patch to prince.exe:
<screen>
00016549: CF CB
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Cosmo game by Apogee Software</title>
<sect2>
<title>
Cosmo's Cosmic Adventure doesn't start
</title>
<para>
Solution: Unpack the cosmo1.exe which is packed with LZEXE.
Then apply the following patch:
<screen>
00011F8F: 75 90
00011F90: F9 90
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Pinball Fantasies</title>
<sect2>
<title>
Long start-up delay (like half a minute)
</title>
<para>
No solution yet.
</para>
</sect2>
<sect2>
<title>
Black screen and hang after choosing the table.
</title>
<para>
Solution: A few driver files needs to be patched.
Or just patch the one that you selected in a sound setup.
</para>
<para>
Apply the following patch to sb16.sdr:
<screen>
00002007: F7 90
00002008: F3 90
</screen>
</para>
<para>
Apply the following patch to sbpro.sdr:
<screen>
000020A4: F7 90
000020A5: F3 90
</screen>
</para>
<para>
Apply the following patch to sb20.sdr:
<screen>
0000206B: F7 90
0000206C: F3 90
</screen>
</para>
<para>
Apply the following patch to sblaster.sdr:
<screen>
00001F25: F7 90
00001F26: F3 90
</screen>
</para>
<sect2>
<title>
Game doesn't see the Fx keys that should start the game.
</title>
<para>
No solution yet, the game is unplayable.
</para>
</sect2>
</sect1>

<sect1>
<title>WordPerfect 6.2</title>
<sect2>
<title>
Hang trying to play the MIDI file embedded in document.
</title>
<para>
Apply the following patch to vmp.com:
<screen>
00002C4B: 72 90
00002C4C: 0D 90
00002C5B: 01 00
</screen>
<ulink url="https://github.com/dosemu2/dosemu2/issues/1189#issuecomment-639217647">
see here for details
</ulink>
</para>
</sect2>
</sect1>

<sect1>
<title>LEXICON 1.2 (mod 8.98)</title>
<sect2>
<title>
dosemu crashes after a few minutes of work.
</title>
<para>
Looking at lexicon code, the crash seems intentional.
Probably some kind of a copy protection.
Apply the following patch to lexicon.exe:
<screen>
0000ED9C: 74 EB
00011DAE: 74 EB
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Test Drive 2</title>
<sect2>
<title>
Game doesn't start, just returns to command prompt.
</title>
<para>
Test Drive 2 only works from drives up to F:. In most dosemu2 setups,
these drive letters are occupied. Solution is to copy the game to C:.
</para>
<title>
Bad music or wrong note at the end.
</title>
<para>
Test Drive 2 is available in 2 versions. Check the VOICES.BIN file, and
if its size is 0 or 2 bytes, this is an old version. Find the newer version
with VOICES.BIN of a size 288 bytes. This version has better music, more
cars and more maps. Note that if your VOICES.BIN is 2 bytes in size, you
can simply "truncate" it to 0 bytes to eliminate the bad note at the
end of the melody. But don't remove the file, or the game won't start.
</para>
</sect2>
</sect1>

<sect1>
<title>Tetris Classic, Super Tetris</title>
<sect2>
<title>
Game is too slow.
</title>
<para>
Solution: set
<screen>
$_timer_tweaks = (on)
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Street Fighter 2</title>
<sect2>
<title>
Game crashes on intro screen.
</title>
<para>
Solution: set
<screen>
$_timer_tweaks = (on)
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Game Wizard (GW)</title>
<sect2>
<title>
Hangs on start.
</title>
<para>
Solution: set
<screen>
$_dos_up = (off)
</screen>
</para>
</sect2>
</sect1>

<sect1>
<title>Seven Cities of Gold</title>
<sect2>
<title>
Game hangs on start-up
</title>
<para>
Apply the following patch to 7cities.exe:
<screen>
000049DE: 72 90
000049DF: D8 90
</screen>
</para>
</sect2>
</sect1>

</article>
