DOSBox

From eXo Wiki
Jump to navigation Jump to search

Current Included DOSBox builds

This is a list of the current versions of DOSBox being used by the eXo projects.

DOSBox is an MS-DOS emulator that emulates both the hardware and software for for the system. It is capable of emulating several different machine types including PCjr, Tandy, and an IBM compatible. As an open source project, there are many variants of DOSBox, which is important as there is no single version of DOSBox that can run every game. The eXo projects use a variety of DOSBox builds in order to achieve maximum compatibility. The following is a list of DOSBox builds currently used by the project as well as a list of games that are assigned to the build.

Please note that games are not randomly assigned. If a game is not using one of the default builds (#DOSBox 0.74 or #DOSBox ECE r4230), then it has been specifically assigned to a different build. We will attempt to link each game to a relevant github ticket and/or reason for the assignment.

As the project evolves and new DOSBox builds are created, this list will change and games will be re-assigned as needed.

DOSBox Keys

ALT+ENTER = Full Screen.
ALT+PAUSE = Pause emulation.
CTRL+F1 = Show the keymapper configuration screen
CTRL+F4 = Update cached information about mounted drives. Useful if you changed something on a mounted drive outside of DOSBox. Also cycles through disk images mounted using IMGMOUNT.
CTRL+F5 = Save a screenshot (goes to capture folder).
CTRL+ALT+F5 = Start/Stop recording of AVI video. NOTE: You may well have some problems with this, please see Recording Video for more information.
CTRL+F6 = Start/Stop recording sound output to a wave file (goes to capture folder).
CTRL+ALT+F7 = Start/Stop recording of OPL commands.
CTRL+ALT+F8 = Start/Stop the recording of raw MIDI commands.
CTRL+F7 = Decreases frameskip
CTRL+F8 = Increases Frameskip
CTRL+F9 = Kill (close) DOSBox.
CTRL+F10 = Capture/Release the mouse (if you need to use the mouse within DOSBox).
CTRL+F11 = Slows down the game
CTRL+F12 = Speeds up the game
ALT+F12 = Unlock speed (turbo button).

DOSBox 0.63 (Special Build)

Description

An patched build of DOSBox 0.63 designed to handle segment limits, which is not emulated by standard DOSBox due to performance reasons.

Games

Games List  
Game Name Reason
Viper (1998) Segment Limits \ VESA Bank Switching

DOSBox 0.73

Description

An official build of DOSBox originally released on May 27th, 2009.

Games

Games List  
Game Name Reason
Millionaire - The Stock Market Simulation (1982) Refuses to boot in any other tested version

DOSBox 0.74

Description

The last official full release stable build (three revisions with minor fixes have since been released). This version of DOSBox was released May 12th, 2010. It is the most commonly seen version of DOSBox as it is packed in with most MS-DOS GOG and Steam games.

Games

A full list has not been provided as this and ECE 4230 are the default builds we test with.

DOSBox DWD

Description

A custom DOSBox build by David Walters. The primary addition to this build is Game Link, which allows external applications to communicate with the emulated game. This is most commonly used with real time mappers. It does however have some other features, such as custom window titles, fixes for audio popping in Wizardry 6 & 7, and a fix for reversed audio in Terra Nova: Strike Force Centauri.

Games

Games List  
Game Name Reason
Wizardry VI - Bane of the Cosmic Forge (1990) Fixes audio popping

DOSBox ECE r4230

Description

ECE (Enhanced Community Edition) adds several patches to the vanilla DOSBox build that greatly enhance the potential of the emulator. One of the primary reasons it is used in eXoDOS is for it's Roland MT-32 (Munt) and fluidsynth sound font capabilities. It also has improved 3Dfx emulation, enhanced OPL3 & PC speaker emulation, a increased VRAM (which assist in reducing flicking in Build engine games).

Another primary enhancement that is included in this version is the pixel perfect patch. The Alternate Launcher gives users the option to try and launch any game with this patch.

Games

This is one of the default DOSBox builds for the projects, which means hundreds of games (just under 2,000 in eXoDOS alone) are set to this build. This includes nearly all games with MT-32, Sound Canvas 55, and 3Dfx support.

DOSBox ECE r4460

Description

The r4460 version includes several patches that improve game compatibility above and beyond the r4230 release. Unfortunately, the pixel perfect patch was dropped shortly after the r4230 release. As we do not shift games to a new version of DOSBox without extension testing, the r4460 version was added to the pack as an alternative option. It specificlaly includes kcroft's CD-audio patch, which solves several CD audio issues.

Games

Games List  
Game Name Reason
A320 Airbus (Edition Europa) (1992) https://github.com/exoscoriae/eXoDOS/issues/3233
A320 Airbus (Edition USA) (1993) https://github.com/exoscoriae/eXoDOS/issues/3233
Armored Fist (1994) https://github.com/exoscoriae/eXoDOS/issues/3253
Cover Girl Strip Poker (1991) https://github.com/exoscoriae/eXoDOS/issues/3351
Magic Candle 2, The - The Four and Forty (1991) https://github.com/exoscoriae/eXoDOS/issues/2940
Mino's Adventure (1997)
Mixed-Up Mother Goose (1991) https://github.com/exoscoriae/eXoDOS/issues/2431
Oxyd magnum! Gold (1998) https://github.com/exoscoriae/eXoDOS/issues/3246
Pinball Wizard 2000 (1995) https://github.com/exoscoriae/eXoDOS/issues/1167
Project Paradise (1997) https://github.com/exoscoriae/eXoDOS/issues/2489
Seasons of the Sakura (1997) https://github.com/exoscoriae/eXoDOS/issues/2771
Secret of Monkey Island, The (1990) https://github.com/exoscoriae/eXoDOS/issues/2990
Soldiers of Fortune (1994)
Theme Park (1994) Fixes crashes after the game has been running a while
Theme Park Mystery (1990)
Toy Shop, The (1986)
Wolf (1994)
Zombie Dinos From Planet Zeltoid (1995)

DOSBox mpu

Description

An patched build of DOSBox with mpu timing fixes related to ready the audio track length with disc image mounts.

Games

Games List  
Game Name Reason
Casino Tournament of Champions (1995) Fixes sound that was being cut off in other builds

DOSBox-TC

Description

TC stands for TransCopy. DOSBox-TC allows the emulator to directly mount and use TransCopy images. TransCopy was popular as a method of capturing a floppy disk image with all sectors present, including tricky ones which were often used as copy protection.

Games

Games List  
Game Name Reason
Boppie's Great Word Chase (1985) TC image file

DOSBox-X 0.82.18

Description

DOSBox-X is a heavily patched enhanced build of the base DOSBox. Many enhancements and extra features exist, including enhanced support for Windows installations.

Games

Games List  
Game Name Reason
Archer Maclean's Pool (1992)
Bargon Attack (1992)
Best of the Best Championship Karate (1992)
Big Business (1990)
Bill and Ted's Excellent Adventure (1990)
Boston Bomb Club (1991)
Bunny Bricks (1993)
Colorado (1990) DAC through PC Speaker
Crystals of Arborea (1990)
Cyber Riders (1992)
D-Day (1992)
Deep Red (1996)
Dr Wong's Jacks and Video Poker (1992)
Dvorak on Typing (1991)
Eddy and Co (1995)
Elder Scrolls Legend, An - Battlespire (1997)
Exobius (1995)
Fetiche Maya, Le (1989)
Golden Eagle (1991)
Ishar - Legend of the Fortress (1992)
Ishar 2 - Messengers of Doom (1993)
Journey to the Center of the Earth (1988)
Life and Death 2 - The Brain (1990)
Metal Mutant (1991)
Metropolis (1987)
NCAA - Road to the Final Four (1991)
Player Manager 2 (1995)
Pro Pinball - Big Race USA (1998)
Pro Pinball - Timeshock! (1997)
Purple Saturn Day (1989)
Rosemary West's House of Fortunes (1993)
Star Trek Borg (1996)
StarBlade (1990)
StarFight III - Within the Darkness (1997)
StarFight IV - Legacy (1998)
StarFight V - Hell's Gate (1999)
Storm Master (1992)
Super Jeopardy! (1991)
Touchdown Football (1984)
Windsurf Willy (1989)
Wizardry VII - Crusaders of the Dark Savant (1992)

GunStick DOSBox

Description

An patched build of DOSBox that adds support for the Opera Soft Gun Stick, a light gun developed for the PC. This build of DOSBox maps the mouse cursor to the aiming target, allowing the user to use the cursor in place of the Gun Stick peripheral.

Games

Games List  
Game Name Reason
Cosmic Sheriff (1989) GunStick Support
Mike Gunner (1988) GunStick Support
Pack Regalo Gun Stick (1989) GunStick Support

PCjr Composite DOSBox

Description

A special build of DOSBox with a patch to enable composite mode in certain PCjr titles

Games

Games List  
Agent USA (1984)
Below the Root (1984)
Seven Cities of Gold, The (1985)
Wilderness - A Survival Adventure (1986)

SVN Daum

Description

ykhwong's SVN Daum, last updated on January 25th, 2015, is an enhanced SVN build that incorporates several patches not found in other DOSBox builds. It is generally not considered super stable and it often experiences slowdown due to unoptimized emulation of several core systems. Despite all of this, there are several games which require the use of Daum for various reasons. A list of special patches from the SVN Builds wiki includes: The Windows build incorporates Direct3D with pixelshaders, OpenglHQ, Innovation, Glide, zip/7z mount, Beep, NE2000 Ethernet, Graphis user interface (menu), Save/Load states, Vertical sync, CPU flags optimization, Various DOS commands (PROMPT, VOL, LABEL, MOUSE, etc) and CONFIG.SYS commands (DEVICE, BUFFERS, FILES, etc), Continuous turbo key, Core-switch key, Show details (from menu bar), Nice DOSBox icon, Font patch (cp437), MAKEIMG command, INTRO, Ctrl-break patch, DBCS support patch, Automatic mount, Printer output, MT-32 emulation (MUNT), MP3CUE, Overscan border, Stereo-swap, SDL_Resize, MemSize128, Internal 3dfx voodoo chip emulation, etc.

The Daum build is also used by the Alternate Launcher when the No-Scan Lines filter is selected. This is primarily for FMV games with immoveable scan lines.

Games

Games List  
Game Name Reason
Abaron (1995)
Airball (1987)
Airline Simulator (1996)
Arrakis (2000)
Backroad Racers (1993)
Brany Skeldalu (1998)
Chickens (1996)
City (1989)
Corncob 3-D The Other Worlds Campaign (1992)
Corncob Deluxe (1994)
Crazy Brix (1999)
Dactylus (1997)
Davis Cup Complete Tennis (1996)
Descent to Undermountain (1998)
Dismal Passages - Part I - The Wicked Curse (1995)
EXP - The Excellent Potato (1996)
Elkinloor (1995)
European Racers (1993)
Eye of Typhoon, The (1996)
Falcon A.T. (1988)
Fourth Generation, The (1996)
Frankenstein (1994)
Frontier - First Encounters (1995)
Haunted Childhood (2003)
Hopang Man (1993)
Hostage Rescue Mission (1989)
Hound of the Baskervilles (1993)
Hugo (1994)
Ice Kiss (1997)
James Bond 007 - The Stealth Affair (1990)
Karkoth's Keep (1983)
Katapult (1996)
Kingdom of Syree III, The - The Depths of Hell (1998)
Legend of the Purple Tit, The (1994)
Matter of Time, A (1995)
Molefest (2002)
Monmallineun Tarokbeom (1996)
Operation AirStorm (1994)
P-47 Freedom Fighter (1993)
PC Futbol 3.0 (1994)
PC Futbol 5.0 (1996)
Pac Man (1982)
Paddle, The (2002)
Palace of Deceit - The Secret of Castle Lockemoer, The (1991)
Panic! (2002)
PaybackTime 2 (1997)
Pilgrim Quest (1991)
Pirate Island, The (1998)
Psycho Killer (1993)
Puzzle Bobble (1994)
RS-2 (1990)
Realms of Arkania - Blade of Destiny (1992)
Rocks (1997)
Sea War - Entscheidungsschlacht im Pazifik (1996)
Shooting Langrisser 2 (1998)
Sooty and Sweep (1992)
Spear End of Destiny (2004)
Speedway Manager '96 (1996)
Spong (1993)
Street Count 2 Plus (1994)
Super Dog Story (1997)
Town With No Name (1993)
Up Periscope! (1988)
Video Blakjak (1991)
Virtual Pool (1995)
Virtual Snooker (1996)
Vroom (1994)
WarWizard (1994)

Unused DOSBox builds

DOSBox Pure

Pure is a basic version of DOSBox aimed at RetroArch. That is great for some specific use case scenarios.
Unfortunately, pure makes a lot of assumptions. For example, it forces aspect ratio on. We have lists of games that are broken and distorted by this setting. We have custom scripts in place to ensure games like this are run properly, no matter what settings outside conf files try to set.
Pure wants to treat dos games like rom files. Console games are preinstalled games with a very low amount of variation. They do not have setup utilities that are capable of thousands of combinations of sound, video, network, and game play options. It can't handle an eXoDOS zip file that has the games bin/cue in one folder and the installed game in another.
Arguably, DOSBox Pure hurts game preservation by preferring rips over original media.
Pure is also missing several features that the eXo projects rely on. Extended features like ipx/null modem, composite cga, mt-32, sound fonts, Tandy 3 voice, pixel perfect, scalers and shaders, 3Dfx, IDE pass through, etc... are not supported in Pure currently.
Pure is most suitable for someone who wants to play a copy of DOOM they aquired online on their retropie without any setup options. It is not the bets route, but it is possibly one of the easier ones.