===================================================================== README.TXT 11/15/98 ===================================================================== PRBOOM v2.02 --- an official port to WIN32 of the released BOOM source -This port is based upon BOOM v2.02 -This port was written by Florian "Proff" Schulze, member of TeamTNT http://www.teamtnt.com -DOOM is copyright ID software (www.idsoftware.com) -This port is not endorsed by id software, so don't bug them about it -I am not responsible for any damage that may be done by this program ===================================================================== Contents Section 1. Installing PRBOOM Section 2. Configuring PRBOOM Section 3. Playing PRBOOM in Single Player mode Section 4. Playing PRBOOM in Serial/Network mode Section 5. Editing for PRBOOM Section 6. Differences between PRBOOM and BOOM Section 7. Files and Directories in the PRBOOM Distribution Section 8. How to report bugs in PRBOOM Section 9. Appendix ===================================================================== ----------------------------- Section 1. Installing PRBOOM ----------------------------- Requirements: ------------- PRBOOM requires a minimum of a 486DX/33 with 16M of RAM running Windows 95 / 98 / Windows NT 4.0 (+SP3 or better). PRBOOM requires a copy of DOOM, DOOM II, Ultimate DOOM, or Final DOOM already installed on your system. In the installation instructions below we use C:\DOOM2 to denote the directory it is installed in. Substitute the path to DOOM on your system wherever that appears. PRBOOM requires a sound card, it will not play sounds over the PC speaker. If you do not have a sound card you should run it with the -nosound option on the command line. It requires DirectX 2.0 or better if you want to use sound and fullscreen-drawing. If you want to run PRBOOM in a window you need 32768 (15 bit) or more to get a playable view. To run it fullscreen you need 256 colors. No other color-modes are supported. Suggested installation procedure: --------------------------------- 1) Unzip the download archive in a new directory, which we will call \PRBOOM. 2) Type PRBOOM -iwad C:\DOOM2, the game will start as usual. To avoid having to type -iwad C:\DOOM2, add the line below to your AUTOEXEC.BAT and reboot: SET DOOMWADDIR=C:\DOOM2 Alternately you can unzip the PRBOOM archive in your DOOM directory and avoid needing -iwad or the change to your AUTOEXEC.BAT file. You can also simply copy DOOM1.WAD, DOOM.WAD, or DOOM2.WAD to the PRBOOM directory. 3) PRBOOM provides support for mouse, but in the current release the mouse is sometimes choppy if you use it in the window-mode, I had no problems in fullscreen-mode. If you don`t use the mouse you should set use_mouse to 0 in the CFG-File, because the game runs a little bit faster. 4) PRBOOM supports different ways to play music. You can choose it with the mus_card variable in the cfg-file. You have the following options: 0 No Music 1 MCI-Midi, this uses the mci-interface and needs a temporary file called prboom.mid 2 Stream-Midi, this uses the streaming midi-interface and needs no more temp-file, but it could make problems. Stream-Midi is used by default. You can't set the volume of the Midi-Music with the option in the game, with it you can only turn the music on and off. You have to set the volume of the Midi-Music with the windows-mixer. I had some problems with my PCI-Soundcard. I have solved them by setting the hardware acceleration to one tick lower than 100%. I have found this setting in the control panel under multimedia settings. Under Windows 98 I had to install the newest driver for my PCI-Soundcard to get MIDI-Music. You can change the sampling parameters in the CFG-File. snd_channels : This is the number of sound-channels used. A higher value means you can hear more sounds at once, but it also uses more CPU-Power. snd_frequency: The sampling-rate, useful values are 11025, 22050 and 44100. snd_bits : The bitdepth, allowed values are 8 and 16. snd_stereo : If you have a mono-soundcard you can set this to 0. 5) If sound and music sound ok, and the mouse behaves properly, you're done! ------------------------------ Section 2. Configuring PRBOOM ------------------------------ It's the same as in original BOOM, see boom.txt in the txts/boom directory. ------------------------------------------------ Section 3. Playing PRBOOM in Single Player mode ------------------------------------------------ It's the same as in original BOOM, see boom.txt in the txts/boom directory. In the game 'ALT-ENTER' switches to fullscreen-mode and all window-keys like 'ALT-TAB' work the same way as in any other windows-program. Command line parameters ------------------------ *Configuration Options I have added the following command line parameters: -condump This dumps the output to the files disp.txt and error.txt -2 In window mode: The gamescreen is stretched by 2 with StretchDIBits In fullscreen mode: If your display driver is only able to display 640x480 like in the most NT drivers, you can use this option to stretch it up to fullscreen. -m2 In window mode: The gamescreen is stretched by 2 with my own routine (this is normally faster on NT) In fullscreen mode: If your display driver is only able to display 640x480 like in most NT drivers, you can use this option to stretch it up to fullscreen. -fullscr Forces fullscreen-mode at startup if it's available -nofullscr Forces window-mode at startup -width -height Specifies the resolution for the display. The maximum is 1600x1200. Usefull values are: width x height -------------------- 320 x 200 320 x 240 400 x 300 512 x 384 640 x 400 640 x 480 800 x 600 960 x 720 1024 x 768 1280 x 1024 1600 x 1200 Default is 320x200. If you go higher than 640x480 the game will be much slower on most Systems, this has to do with the size of the L1-Cache and the L2-Cache. -noddraw Don't use DirectDraw. You will not be able to use fullscreen with this option. ------------------------------------------------- Section 4. Playing PRBOOM in Serial/Network mode ------------------------------------------------- This is completely different to the original BOOM version, but its similar to the Linux version of DOOM. The following command line parameters are for use in netgames: -net After this comes the player number of the machine. Then comes a list of host addresses or IP addresses. If you use IP addresses they have to begin with a ".". If one of the other machines has another portnumber, you can add " :PORTNUMBER" after the address (note that there MUST be a blank between the address and the colon). -port If you want to use another port for a machine you can specify it with this command. Here are some samples: 2 Players: 1. Machine: -net 1 .192.168.1.2 2. Machine: -net 2 .192.168.1.1 3 Players with changed port on the 2. Machine: 1. Machine: -net 1 .192.168.1.2 :26001 .192.168.1.3 2. Machine: -net 2 .192.168.1.1 .192.168.1.3 -port 26001 3. Machine: -net 3 .192.168.1.1 .192.168.1.2 :26001 The -port command is also useful if you want to run a net game on ONE machine: 2 Players: 1. Command: -net 1 .192.168.1.1 :26001 -port 26000 2. Command: -net 2 .192.168.1.1 :26000 -port 26001 *Multiplayer Options It's the same as in original BOOM, see boom.txt in the txts/boom directory. ------------------------------ Section 5. Editing for PRBOOM ------------------------------ It's the same as in original BOOM, see boom.txt in the txts/boom directory. ----------------------------------------------- Section 6. Differences between PRBOOM and BOOM ----------------------------------------------- Whats implemented: -mouse -keyboard -graphics (using StretchDIBits and DirectDraw) -sound fx (using DirectSound) -music (using Windows-MIDI-Functions) -networking (using TCP/IP) Whats not implemented: -joystick Whats new: High-resolutions ----------------------------------------------------------- Section 7. Files and Directories in the PRBOOM Distribution ----------------------------------------------------------- PRBOOM executable archive PRBOOM202.ZIP prboom.exe The executable for Windows 95 / 98 / NT 4.0 txts Docs and infos txts/boom Docs and infos of the original BOOM distribution prbstuff Progs for the Win32-Version. These are from me PRBOOM source archive PRBOOM202S.ZIP prboom.dsp VC50 Project File prboom.dsw VC50 Workspace File src All the source files txts Docs and infos txts/boom Docs and infos of the original BOOM distribution txts/doom Docs and infos of the original DOOM source distribution makfiles/makefile.dos The DJGPP makefile makfiles/makefile.c32 The CYGWIN32 makefile makfiles/makefile.m32 The MINGW32 makefile boomstuf Progs for the DOS-Version. These are from BOOM ---------------------------------------- Section 8. How to report bugs in PRBOOM ---------------------------------------- If you find a bug in PRBOOM you should visit http://www.teamtnt.com and follow the directions there for reporting it. For more information on reporting a bug, see boom.txt in the same section. -------------------- Section 9. Appendix -------------------- You can get the PRBOOM source at: http://www.teamtnt.com You can get the original linux-doom source at: ftp://ftp.idsoftware.com/source/doomsrc.zip You can get the BOOM source at: http://www.teamtnt.com Thanks go to (in no particular order): ID Software for the release of LinuxDOOM TeamTNT for BOOM Andy Bay for ATBDOOM The DOSDOOM-Team for DOSDOOM Randy Heit for ZDOOM -------------------------------------------------------------------------