home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Doom 2 Explosion
/
Doom2Explosion.bin
/
doom2exp
/
programs
/
du104
/
doomutil.txt
< prev
next >
Wrap
Text File
|
1994-07-31
|
66KB
|
1,690 lines
DOOMUTIL
Version 1.04
David Poole, Jr.
PO Box 747
Pacolet, SC. 29372
david.poole@swcbbs.com
DOOMUTIL 1.04 User's Guide Page 1
Table Of Contents
Introduction and Background................................2
Disclaimer:..............................................2
Warning:.................................................3
Using DOOMUTIL.............................................4
Command Line Parameters..................................4
Interactive Use..........................................4
Invoking Menu Selections................................4
Editing Information.....................................5
Hot Keys................................................6
Menu Selections............................................7
Main Menu................................................7
Begin Doom With Current Configuration...................7
Modify Current Game Configuration.......................7
Modify Serial Server Configuration......................8
Modify Network Server Configuration.....................8
WAD File Functions......................................8
Miscellaneous Functions.................................8
WAD File Functions.......................................9
WAD Functions Menu.......................................9
Selection Menu..........................................9
Force Refresh of WAD list...............................9
Rescan Selected WAD files..............................10
Backup selected WAD file(s)............................10
Restore selected WAD file(s)...........................10
List WAD files.........................................10
Build new WAD from selected PWADs......................10
Episode/Mission MENU...................................11
WAD THING MENU.........................................11
WAD SECTOR MENU........................................11
Selection Menu..........................................11
Select wad files for modification......................11
Select All wad files...................................13
Deselect All wad files.................................14
Invert wad file selection..............................14
Change Sorting Order...................................14
Save Selection To File.................................15
Load Selection From File...............................15
Episode/Mission MENU....................................15
Modify Episode & Level for PWADs.......................15
Globally Modify Episode & Level for PWADs..............16
Incrementally Modify Episode & Level for PWADs.........16
WAD THING MENU..........................................16
Invert selected WAD(s) things Death Match Status.......16
Remove selected WAD(s) THINGs Death Match Status.......16
Randomize selected WAD(s) THINGs with computer seed....16
Replace one thing with another.........................17
WAD SECTOR MENU.........................................17
Highlight (Dim Secret, Pulse Trigger) SECTORs..........17
Maximize Brightness of SECTORs.........................18
Remove Damaging SECTORs................................18
Miscellaneous Functions.................................18
Access Dialing Directory...............................18
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 2
Enable Speaker.........................................18
Disable Speaker........................................18
Edit Program Configuration.............................18
Edit MODEM.CFG.........................................19
Run ID's Setup.........................................20
Register DOOMUTIL......................................20
Files created by DOOMUTIL.................................21
Uses of DOOMUTIL..........................................23
Using DOOMUTIL to automate multi-player sessions........23
Using DOOMUTIL to add life to memorized missions........23
Using DOOMUTIL to assist in using external WAD files....24
Evaluating new WADs....................................24
Developing new composite WADs..........................24
Registering DOOMUTIL......................................26
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 3
Introduction and Background.
DOOMUTIL is a utility to originally designed to
facilitate using ID's DOOM when playing multi-player
mode. The setup program that is supplied with DOOM
requires too much effort on the part of the user,
especially when playing via modem. DOOMUTIL was
created to alleviate this problem. Initially,
DOOMUTIL was used to create batch files, which could
then be repeatedly invoked using a menu system or
command history utility. As my co-players and I
discovered external WAD files, DOOMUTIL was expanded
to support these as well, from both a player and a
developer's stand point.
As DOOMUTIL grew in functionality, it was decided to
share the program with the rest of the DOOMing world.
I hope that you will enjoy using this program. I've
enjoyed writing it. If you enjoy it, please register
it by following the instructions in the registration
section of this document.
Please note that this program and documentation, for
the purposes of multi-player mode, are slanted towards
competitive, versus cooperative play. While
cooperative play is interesting, it's not much more
interesting than single player mode, in my opinion.
Getting another player on the grid (any TRON movie
fans out there?) and taking turns blowing each other's
brains out added much life to a game that was about to
get old (after four months...).
You are also encouraged to send any comments,
criticisms, or complaints regarding this program. I
have other ideas to be added, and based on user
support and feedback, these may be implemented and
released. Since this is the first release of the
program, there are likely to be problems encountered
that were not encountered (or noticed) by any of the
initial testers of the program. Please feel free to
bring these to my attention.
Disclaimer:
IN NO EVENT SHALL DAVID POOLE, JR. BE LIABLE FOR ANY
DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION,
DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION,
LOSS OF INFORMATION, OR OTHER PECUNIARY LOSS) ARISING
OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM.
This program can make modifications to files used by
DOOM if so instructed by the user. ID Software does
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 4
not provide technical support for DOOM if DOOM has
been modified. It is advisable to make a backup of
DOOM and any WAD files you've obtained for use with
DOOM, before using DOOMUTIL.
Warning:
DOOMUTIL creates files with the extension of .WBU to
minimize the amount of time and space required to
recover WAD files from randomization and other
modifications. Deletion of these .WBU files will
require you to obtain the WAD files from their
original source if you wish to have them in their
original state.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 5
Using DOOMUTIL.
DOOMUTIL is an interactive program. However, there
are some command line parameters that speed use of the
program.
Command Line Parameters.
RUN Causes DOOMUTIL to invoke DOOM with
the parameters selected by the user
via the menu system. After DOOM
terminates, DOOMUTIL terminates.
RESUME Effectively like the RUN parameter,
with the exception that the last saved
game (if any) is automatically loaded.
This is handy if you're playing multi-
player via modem, and the other player
forgets to disable their call-waiting.
After DOOM terminates, DOOMUTIL
terminates.
Interactive Use.
All interaction with the program is done through three
simple interfaces: a menuing system, a field editing
system, and a hot key system. Familiarity with each
of these is very helpful.
Invoking Menu Selections.
Desired menu functions can be selected by one of three
methods.
The first and fastest method is to press the key that
corresponds to the highlighted character in the text
describing the functions. Pressing the highlighted
key invokes the function immediately. Pressing the
ESCAPE key will exit the menu.
The second method is to use the mouse. Move the mouse
cursor to the desired option and press the left mouse
button. Pressing the right mouse button, while the
cursor is within the border surrounding the menu, will
act as an ESCAPE key press, and exit the menu.
The third method is to use the up and down arrow keys.
The Home and End keys can be used to move quickly to
the top or bottom of the menu list. Once the desired
function is highlighted, press the Enter key to invoke
it.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 6
Editing Information.
Information that cannot be specified through the use
of the menuing system is communicated through the use
of a field editing system.
For the purpose of this section, an editing session is
the duration of the field editor's continual usage.
For example, an editing session begins when the user
selects "Modify Current Game Configuration" from the
Main Menu, and the session ends when either Control &
Enter, or Escape is pressed, to save or discard
changes, respectively.
Movement from field to field is performed with the up
and down arrow, Page Up, Page Down, and Enter keys.
If invalid input is made in a field, then the editor
will not allow the cursor to leave the current field.
To save the changes made for the current editing
session, press the Control and Enter keys
simultaneously. To abandon the changes made for the
current editing system, press the Escape key.
The insert key toggles between character insert and
character overwrite mode.
The backspace key deletes the character to the left of
the cursor, and places the cursor in that position.
The delete key deletes the character under the cursor.
The tab key is used to advance the cursor to the next
word in a given field. The shift tab key combination
advances the cursor to the previous word.
The Home key moves the cursor to the first character
of the field. The End key moves the cursor to the
last character of a the field.
F2 erases the current contents of the field. Shift F2
erases the contents of all fields.
F3 undoes any changes made to the current field,
restoring the field to it's status at the beginning of
the editing session. Shift F3 restores all fields to
their original status. Control F3 restores the field
to it's contents when the cursor last entered the
selected field.
F1 can be used during editing to display a brief
summary of these keys.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 7
In addition, some fields allow browsing or other
special functions. When the cursor enters one of
these fields, a message is displayed at the bottom of
the current window to inform the user of these
possibilities.
Hot Keys
In addition to the menuing and editing system, there
are "Hot Keys" within DOOMUTIL. These keys can invoke
specific functions when pressed. They are available
any time DOOMUTIL is waiting for keyboard input.
ALT-B Begins DOOM with the current configuration.
Note that if you are editing the current
configuration, and have not yet saved it via
the CNTL-ENTER key sequence, ALT-B will
invoke the last saved configuration.
Naturally, this holds true for all factors
that affect game play, such as Modem Server
Configuration, Network Server Configuration,
or Wad file functions. The best time to use
this function is when you are at a menu, but
you're not limited in this respect.
ALT-C Modify Current Game Configuration. Allows
quick access to the Edit Current Game
Configuration screen.
ALT-D Launch DOS Shell. This invokes the system
shell specified by the COMSPEC environment
variable, which, in most cases, is
COMMAND.COM. In this case, returning to
DOOMUTIL is performed by entering "EXIT" at
the command line.
ALT-M Launch WAD editor. This allows you to invoke
the wad modification utility specified in the
program configuration screen.
ALT-X Exit DOOMUTIL immediately. Note that any
changes not saved (as discussed with the ALT-
B text) are not saved for the next DOOMUTIL
session.
ALT-Z Exit DOOMUTIL immediately, invoking the work
command as specified in the program
configuration.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 8
Menu Selections
Main Menu
Begin Doom With Current Configuration
This begins DOOM with the current configuration, as
specified in the Modify Current Game Configuration.
Selected WADs are automatically loaded.
Modify Current Game Configuration
This allows the user to specify various aspects
regarding the playing of DOOM. Single player, serial
or network play, episode, mission, skill, presence of
monsters, monster respawning, deathmatch, and the game
to load (if any) are specified here.
Selection of a single player, modem, direct connect
(null modem), or network game is performed with this
screen.
If any legitimate changes are made to the value in the
episode field, the mission field is automatically
changed to the first mission for the given episode.
The mission field can be changed to allow skipping the
earlier levels. This is handy if you're playing
deathmatch, and want to skip to where some of the
bigger toys are.
Note that the game slot menu allows entry of values
from 0 to 6, inclusive. Specifying a 0 in this field
indicates that a new game is to be initiated. A 1
selects the game saved in the first slot, etc.
Placing a "?" in the game slot field instructs
DOOMUTIL to find the most recently saved game and use
it, if any. While the cursor is in this field, the
F10 key can be used to browse the saved games. While
browsing the saved games, the episode, mission, skill
level, and frag summary (if a network game) is
displayed. If a saved game is selected, using the F9
key in this field allows the user to display the
statistics of each of the players in the saved
mission. If a loaded game is specified, the episode,
mission, and skill level are updated to reflect the
loaded game.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 9
Modify Serial Server Configuration
This allows specification of the modem communication
port, the direct connection serial port (for use with
null modems), the number to dial, and the serial
driver to use for MODOOMing.
Modify Network Server Configuration.
This screen allows selection of the network socket,
network driver, and number of players for a network
game when a saved game is not being loaded.
For the network driver, IPXSETUP could be specified.
If this method is used, then you must make sure the
network software is loaded before DOOMUTIL is invoked.
However, a much simpler way to play via the network is
to create a batch file that loads the network
software, then the IPX driver, and finally, terminates
he network software. For example, my NETDOOM.BAT for
running under Lantastic follows:
LSL
NE2000
IPXODI
IPXSETUP %1 %2 %3 %4 %5 %6 %7 %8 %9
IPXODI U
NE2000 U
LSL U
I've used both methods for playing DOOM over the
network; I personally prefer the NETDOOM.BAT method.
The NETDOOM.BAT method poses problems, however, when
selecting external WAD files, all of the parameters
can not be accessed through the parameter list.
WAD File Functions
This allows selection of WAD file modification
functions, described in the WAD File Functions menu
section.
Miscellaneous Functions
This allows selection of various functions that didn't
really have a place anywhere else. These functions
are elaborated upon in the Miscellaneous Functions
menu section.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 10
WAD File Functions
These functions allow modification of the WAD files
(both DOOM and others) for various reasons.
Currently, the only thing that DOOMUTIL modifies
regarding the WAD files are SECTORS and THINGS.
SECTORS are basically contiguous areas of floor that
are of the same height, although these areas can be
divided for various reasons. THINGS are various items
in DOOM, such as barrels, keys, player starting
locations, enemies, etc.
When modifying a WAD file, DOOMUTIL will create an
archive file for each WAD file that it modifies, if
the archive does not already exist. These files will
have the extension of WBU (Wad Back Up). NEVER ERASE
A .WBU FILE UNLESS YOU HAVE RESTORED THE CORRESPONDING
WAD FILE TO IT'S ORIGINAL STATUS. Doing so will
result in a WAD file that is not in its state as
shipped, and your only recourse is to reinstall the
WAD file from its original source. Note that DOOMUTIL
looks for files with the extension of ".BAK" to denote
that a given WAD file is a user modified file. In
this case, DOOMUTIL will not allow certain
modifications, as restoring the file could be
catastrophic.
The archive files are typically a fraction of the size
of the original file, so time (as well as disk space)
is saved for restoring large files (like DOOM.WAD) to
their original status, versus extraction from an
archived source.
When modifying wad files for multiple player usage,
it's important that all players involved restore the
desired WAD files to their original status, then make
the same modifications in the same sequence. Failure
to do so will generally result in consistency failures
after DOOM starts.
WAD Functions Menu
Selection Menu
Allows selection of WAD files for use or modification.
This is detailed below.
Force Refresh of WAD list.
In the event that the WAD list becomes invalid
(unlikely, unless WAD files are added or deleted from
the DOOM directory while shelled out of DOOMUTIL),
this option must be used to recreate the WAD file
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 11
list. The previous selection status for WAD files is
discarded. You are asked to confirm this option, as
information DOOMUTIL maintains about the WAD file
that's not part of the WAD file (times used, last
used) will be lost if you perform this option. If you
do not confirm rebuilding the list, then DOOMUTIL will
rescan ALL files the files in the list for updated
information, as if you had selected all of the WAD
files and used the Rescan Selected WAD files option.
If you add or remove WAD files from your directory,
it's best to exit DOOMUTIL and start over. In this
manner, DOOMUTIL's times used and last time used
information is maintained.
Rescan Selected WAD files.
This causes DOOMUTIL to update it's database of
information for each of the WAD files that are
selected. You can perform this option if you've
modified any of the WAD files since the last time
DOOMUTIL scanned it. The last time of use, and the
number of times used for each WAD scanned will be
retained.
Backup selected WAD file(s).
Creates a .WBU file for each of the corresponding WAD
files, if the file does not already exist. Only the
THINGS & SECTORS portion of the WAD are backed up.
Restore selected WAD file(s).
If a selected WAD file has been modified, then the
modifications are removed with this option. Only the
THINGS & SECTORS portion of the WAD are restored.
List WAD files.
This creates a file with the extension "LST" for each
WAD file, containing a dump of the various objects
encountered in the WAD file. Not that this is useful
to your average bear, but during the development of
these functions, this information can sometimes be
handy, so I left the option in due to laziness on my
part. You may or may not find the information useful,
depending on your own level of dementedness and
curiosity.
Build new WAD from selected PWADs.
This function allows you to combine all of the
selected WAD (PWAD or IWAD) files into a new PWAD
file. All directory entries from each selected WAD
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 12
file are copied into the new WAD file specified by the
user. Note that no checking is performed for
duplication of directory entries.
This is handy for linking sound or texture WADs with
custom levels. It's also handy for creation of one WAD
file when you desire to play more wad files than will
fit on the command line due to the 128 character limit
imposed by MS/DOS.
This function will not allow you to overwrite an
existing file.
After the wad file has been created, the WAD file list
will be rebuilt.
Episode/Mission MENU
Allows modification of episodes and missions for
selected WAD files. This is detailed below.
WAD THING MENU
Allows modification of THINGs in selected WAD files.
This is detailed below.
WAD SECTOR MENU
Allows modification of SECTORs in selected WAD files.
This is detailed below.
Selection Menu
Select wad files for modification.
This allows selection of individual WAD files for
manipulation. Selecting the individual WAD files is
done as follows:
The Up and Down arrow keys allow moving from WAD to
WAD. Moving the mouse cursor to a WAD moves the
highlight bar to the corresponding entry.
Pressing the Space bar, or left mouse button while the
mouse cursor is on an entry toggles the selection
status of the highlighted WAD file.
Pressing Enter, or the right mouse button while the
mouse cursor is within the selection window border
exits the selection system, saving the selections
you've made.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 13
Pressing Escape, or the middle mouse button (if
present) while the mouse cursor is within the
selection window border exits the selection system,
discarding selections in changes that you've made.
Page Up, Page Down, Home, and End effect scrolling
through the listing (if it requires more than one
page). Mouse users can scroll the display by moving
the cursor to either the top or bottom border of the
window. Pressing the left mouse button will scroll
the display by one line. Pressing the right mouse
button will scroll the display by one page. Pressing
the middle mouse button, if present, will scroll the
display to the respective end of the list.
Pressing [F10] invokes the configured WAD
viewer/editor on the highlighted WAD, if one has been
configured. See the program configuration section for
details. Pressing [ALT-F10] will perform the same
operation, and automatically launch DOOM with the
current selected WADs. THIS IS VERY HANDY FOR WAD
DEVELOPERS.
Pressing [F9] displays detailed information regarding
the WAD file.
Pressing [F8] displays a summary of the episodes and
missions selected. Using this summary, you can
determine if you have selected WAD files that
conflict; i.e., two WADs contain maps or songs for
E1M1, or the selected WADs are not contiguous, i.e.,
you've selected a WAD for E1M1 & E1M3, but none for
E1M2.
Pressing [F3] displays the current sorting scheme.
Pressing [F2] displays the color scheme, outlined
below.
WADs displayed with a red or brown background have
been modified, and need to be restored in order to be
used in a multi-player game. Wad files with yellow
text have been selected.
For each WAD in the list that contains missions, the
first episode and mission encountered for the wad is
displayed, followed by the number of missions found in
the WAD. Finally, if there are 4 death match starts
for each mission, there will be a "DM", indicating
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 14
that the level is suitable for death match play[1].
This will prevent rude interruptions in your death
matches when a new level is loaded where the developer
overlooked this important THING. If an exclamation
mark is displayed, then DOOMUTIL has found something
about the WAD that may cause problems with playing
multiple player sessions. These factors are: No
exit, not enough (or too many) player starts, or not
enough death match starts FOR EACH MISSION in the
given WAD file.
For each WAD in the list that contains music as
opposed to sound, the episode and mission for which
the music is assigned to is specified. The message
"SONG" to the right of the episode and mission
indicate that this WAD contains music as opposed to a
missions.
If a WAD does not contain missions or music, then no
level or episode information is specified. Text
describing what was found is displayed.
Selected WADs are used when DOOM is invoked. If the
Auto Build WAD file feature is not enabled (described
under Program Configuration), it's possible to select
more WAD files than will fit on the command line.
This is due to the wonderful 128-character limit on
command lines that the folks at Microsoft have imposed
on us. In this event, all of the selected WADs will
not be loaded by DOOM.
NOTE: During the selection process, the currently
displayed selection is considered to be current,
whether or not the user has used ENTER to confirm the
selection. This means that the hot key functions will
work with the currently displayed selection as opposed
to the last confirmed selection. If DOOMUTIL is
terminated via the ALT-X or ALT-Z sequence, the
current selection is stored in the configuration file,
as opposed to the last confirmed selection.
Select All wad files.
Automatically selects all of the WAD files for
manipulation.
1 It amazed me that this had to be included. During
development and playing, er, testing DOOMUTIL with
selected WADs, I was astounded at the number of WADs I
had that could not be played with Death Match. Is it
just me, or is something wrong here?
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 15
Deselect All wad files.
Automatically de-selects all of the WAD files for
manipulation.
Invert wad file selection.
This reverses the order of the selection status of
each WAD file you have installed in your configured
DOOM directory.
Change Sorting Order
Allows selection of the sort method of the listed WAD
files. There are three levels of sorting that may be
specified. Files that are considered equal for the
purposes of the first level of sorting are submitted
to a second test. Files considered equal for the
second test are submitted to a third test. In this
manner, you can usually arrange the WAD file listing
to suit your needs, which may change, depending on
what you're doing with DOOMUTIL.
Sorting options are:
Name: The listing is sorted alphabetically according
to file name.
Episode & Mission: The listing is sorted according to
the first episode and mission in each file. If a WAD
file is found that contains a level, and another
contains a song, and they are for the same episode and
mission, they will appear together, with the WAD
containing the level appearing before the WAD
containing the music.
Times Used: The listing is sorted according to the
number of times each WAD has been used. The most
frequently used WADs are displayed first.
Last Used: The listing is sorted according to the most
recently used files, which appear first.
Modification Date: The most recently modified files
appear first. Note that if you modify a WAD outside
of DOOMUTIL, DOOMUTIL will not be aware of the updated
file date. To make DOOMUTIL aware of the changed file
date, you can either: <1> Select the WAD, and use the
Force Refresh of Selected WAD files option of the WAD
Functions menu, or <2> Use the Force Refresh of all
WADs, and press a key other than F10 at the warning.
Selection Status: Selected WADs are listed first.
Note that the list is not sorted during the selection
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 16
process. To resort the list, exit the selection
process and reenter it.
User Modifying: WADs that are being modified by the
user appear first. NOTE: DOOMUTIL considers a WAD to
be one that is being modified by the user if a file
with the same name as the .WAD file exists, with an
extension of .BAK.
Save Selection To File.
This allows the user to save the names of the
currently selected WADs to disk for later use with the
Load Selection From File option. In this manner,
multiple selections can be maintained easily.
When this option is selected, the user is given the
chance to enter a file name to save the selection
under. During entry of the name, pressing the [F10]
key browses all files in the DOOM directory with an
extension of .SEL. An extension of .SEL is
automatically assigned to the specified file name if
one does not exist.
Load Selection From File.
This allows the user to restore a selection saved
previously with the Save Selection To File option.
When this option is selected, the user is given the
chance to enter a file name to load the selection
from. During entry of the name, pressing the [F10]
key browses all files in the DOOM directory with an
extension of .SEL. An extension of .SEL is
automatically assigned to the specified file name if
one does not exist.
Episode/Mission MENU
Modify Episode & Level for PWADs.
This allows changing the episode and mission for
individual WAD files, so that custom scenarios can be
created. If a given WAD file contains more than one
mission, then the episode and mission numbers are
sequentially assigned. This affects both missions and
music.
NOTE: Episode and Mission number for a WAD file are
not backed up! Changes made to the episode and
mission number are permanent.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 17
Globally Modify Episode & Level for PWADs.
This works as Modify Episode & Level for WADs, with
the exception that the specified episode and mission
is used for the first episode and mission for all of
the selected WAD files.
NOTE: Episode and Mission number for a WAD file are
not backed up! Changes made to the episode and
mission number are permanent.
Incrementally Modify Episode & Level for PWADs.
This works as Globally Modify Episode & Level for
WADs, with the exception that the specified episode
and mission is used for the first episode and mission,
and incremented for the remainder of the selected WAD
files. This allows you to select specified WAD files,
and quickly create a sequential list of missions for
play.
NOTE: Episode and Mission number for a WAD file are
not backed up! Changes made to the episode and
mission number are permanent.
WAD THING MENU
Invert selected WAD(s) things Death Match Status.
This modification causes THINGs that appear in death
match mode ONLY to appear in normal play, and THINGS
that appear in normal play to appear only in
DEATHMATCH. This is handy for newcomers to the
deathmatch arena to learn the location of the weapons.
The status of the key cards, skull keys, and teleport
exits are not modified.
Remove selected WAD(s) THINGs Death Match Status.
This causes all THINGS that appear only in DEATHMATCH
mode to appear in normal play. Typically, this
provides extra ammunition, weapons, and health.
Randomize selected WAD(s) THINGs with computer seed.
This allows for randomization of THINGS in the
selected WADs. This makes playing a WAD a little more
enjoyable, after you've learned the exact location of
everything in a particular WAD the way it's shipped.
The only THINGs that are changed are the locations of
the non-boss enemies, ammo, health, weapons, death-
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 18
match player starts, "passable furniture" (this
includes barrels), and artifacts (super charges,
armor, spheres of invisibility/invulnerability).
There are some drawbacks to this. Some THINGs are
place into locations that can not be accessed, such as
super charges place in areas that are inaccessible, as
well as death match starts where a player is trapped
in a room that is sealed until the other player
activates the trigger event.
Also, I've noticed occasions where E1M8 could not be
finished, as something is being moved that prevents
the walls in the baron area from being opened when the
baron(s) are killed. Still working on this one.
Another problem exists when using randomized THINGs in
a scenario. DOOMUTIL doesn't know the width of the
various THINGs that it's moving around, so it's
possible (actually, highly likely) that a wide enemy
such as a Cacodemon will be placed where something
small (such as shot gun shells) were. This means that
the enemy is significantly handicapped, since it's
usually stuck to the wall. The only time such an
enemy is a threat is when you walk close enough to it
to physically (virtually?) touch it. This problem
will be addressed in a future version, if user support
warrants it.
However, this is still useful, especially when all
players have the weapon locations memorized.
This is also useful when one of the players is a
relative newcomer with respect to another. Since the
weapons and deathmatch starts are in varying places,
each player has a closer to equal chance.
Replace one thing with another.
Non-functional at this time. This feature, if and
when implemented, will allow users to change various
THINGs for other THINGs. This will allow in changing
the ratio of weapons/monsters/ammo/health/etc. for the
particular scenario.
WAD SECTOR MENU
Highlight (Dim Secret, Pulse Trigger) SECTORs
This option travels through the SECTORS in a WAD file,
maximizing the brightness of each sector, so that no
areas are dark. Then, any sector that is found to be
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 19
considered a secret is dimmed to half-brightness.
SECTORs found that trigger events are set to flashing.
Note that there are some SECTORs that appear to be
modified internally at run-time, such as the room
containing the blue key in E1M3, that change when an
event is triggered.
Maximize Brightness of SECTORs.
This maximizes the brightness of all SECTORs in the
WAD file. Read the "Highlight (Dim Secret, Pulse
Trigger) SECTORs" section for information regarding
events that may alter brightness.
Remove Damaging SECTORs.
This removes the aspect of areas that cause damage
when you stand in them, such as areas with "slime".
Miscellaneous Functions
Access Dialing Directory
This allows the user to maintain a list of frequently
dial numbers for quick use when playing DOOM via
modem.
Enable Speaker.
Use this to enable the various beeps that the DOOMUTIL
makes from time to time.
Disable Speaker.
Use this to disable the various beeps that the
DOOMUTIL makes from time to time.
Edit Program Configuration.
This allows for configuration various aspects of
DOOMUTIL.
The text editor entry is used when the Edit Modem
Configuration command is invoked.
The WAD editor entry is used when the Launch WAD
Editor function is invoked.
The Path To Doom entry is used to specify the location
of DOOM. By using this, you can place DOOMUTIL
anywhere in your path, and invoke DOOM without
changing directories to it.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 20
The Swap to EMS/XMS fields tell DOOMUTIL where to swap
itself when it's shelling an external program, such as
DOOM, the WAD editor/viewer, etc. If neither of these
contains a Y, then a temporary file will be created on
disk to store the information. If you have plenty of
available EMS or XMS, you may wish to use this, as
program swapping is much faster with one of these
options enabled.
The Enable BEEPS field enables or disables the
annoying beeps that occurs frequently in the program.
The Boss Mode informs DOOMUTIL to invoke the command
specified by the next field, Boss Command, when one of
the following conditions occurs: Exiting DOOM (press
<F10><y>, and you're out of DOOM quickly), exiting
DOOMUTIL, or using one of the boss hot-keys (ALT-Z,
any F11 or F12 combination).
The Auto Build PWAD name field allows you to specify a
WAD file that will be created immediately before DOOM
is invoked. By using this feature, you decrease the
length of the command line that must be passed to DOOM
or the appropriate multi-player driver. If you are
only playing one or two PWAD files, then this is not
usually a problem, but when you add many levels,
sounds, music, and graphics, then this may be
necessary. The built PWAD (the "target") will only be
created under the following circumstances: (1) One or
more of the selected PWADs have a newer modification
date than the target PWAD, (2) The target does not
exist, or (3) The WAD selection has changed. If you
have the memory, specifying a RAM disk as the
destination of the target will greatly speed the
creation process, although the target will have to be
recreated after each system boot.
The View WAD Command field allows you to specify the
command to be used to view a WAD file while selecting
WADs in the WAD selection function. You must supply a
"%s" (omit the quotes, and the "s" must be lowercase)
in the command line. For example, I use DEU to view
my wad files, so my command is "deu -file %s.wad"
(again, quotes are to be omitted).
Edit MODEM.CFG
This invokes the user specified editor on the
MODEM.CFG file. The editor is specified in the
program configuration option of the miscellaneous
functions menu.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 21
Run ID's Setup.
No matter what, there are still times when you have to
run this thing. That's why this function is here.
Register DOOMUTIL
This is described in detail in the section for
DOOMUTIL registration at the end of this document.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 22
Files created by DOOMUTIL.
DOOMUTIL creates and uses files for various functions.
These files, and the functions that create or use them
are described below.
.WBU Wad Backup File. These files contain the
directory entries for the THINGs & SECTORs found
in the corresponding .WAD file, if 1 or more
levels exist. These files are created when ever
you select WAD files that contain levels, and
either select the BACKUP function, or select a
function that modifies the THINGs & SECTORs in a
WAD. These files are typically a small percentage
of the size of the entire WAD file, and allow
DOOMUTIL to quickly restore a WAD file to it's
original status.
Due to the dynamics of user modified WAD files,
WAD backup files are not created for these files.
This is not a problem, as DOOMUTIL will not allow
modification of THINGs & SECTORs in a user wad,
anyway.
These files are stored in the same directory with
the WAD files.
.BAK Backup of WAD file. DOOMUTIL checks for the
existence of a file with the extension of .BAK for
each .WAD file that it finds. The existence of
such a file informs DOOMUTIL this is a WAD file
that is being modified by the user.
DOOMUTIL will also create a .BAK file when
building a composite WAD from selected WAD files,
if the user specified name of the target already
exists. This allows recovery in the event of a
mistake when building a composite WAD.
These files are stored in the same directory with
the WAD files.
.LST Listing of WAD file. When List Selected WADs is
invoked, the output for each WAD file is created
in a file name with the name of the WAD, and an
extension of .LST.
These files are stored in the same directory with
the WAD files.
.SEL WAD File selection. These files are used to store
the names for selection sets. This allows the
user to save and restore selection sets at will.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 23
.CFG Configuration file for DOOMUTIL. Unless DOOMUTIL
is renamed, or copied, the only file that will be
created is DOOMUTIL.CFG. If DOOMUTIL is renamed,
then DOOMUTIL will use the path and new name of
the program. By copying DOOMUTIL to other
directories, or to other names, then multiple
configurations for DOOMUTIL can be maintained.
This file will always exist in the directory in
which DOOMUTIL is located.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 24
Uses of DOOMUTIL.
If you're just going to play out-of-the-box DOOM, then
there is not much of a reason to use DOOMUTIL.
DOOMUTIL doesn't have much to offer the casual DOOM
player, but then again, I don't know too many casual
DOOM players.
DOOMUTIL is meant for the serious player, who wants a
quick and easy way to make the most of DOOM.
Using DOOMUTIL to automate multi-player sessions.
This is why DOOMUTIL was originally written. I was
tired of having to constantly select the options with
SETUP supplied with DOOM. This was especially
cumbersome in the beginning of my MODOOMing days,
since I was having to fight both the modem
configuration and the SETUP program simultaneously.
That's why there is three separate configuration menus
with DOOMUTIL. Once you have the serial and network
configuration selected, there's no reason you should
ever have to modify it again. Unless you change the
communications port for your modem or null modem, the
number of players in a new network game, or network or
serial drivers, you don't have to modify these
parameters once they are set.
Selection of single player, modem play, direct
connect, or network play is done along with the
selection of the episode, mission, skill, monsters,
and death match is all in one convenient location. My
fellow doomers & I have developed a quick method of
communication of the game parameters. Reading off the
value for the episode, mission, skill, monsters,
respawn, and deathmatch fields is quick: "Hey Ted,
let's 1-1-4-Y-N-Y", and we're on the way.
Using DOOMUTIL to add life to memorized missions.
After you've played a mission a few times, it looses
it's excitement, as you've learned where everything
is. Using the randomization feature of the WAD file
functions breathes a little life into tired old
missions. By randomizing the THINGs in a WAD file,
you change the location of all of the enemies (except
for the bosses), ammunition, weapons, health, and the
like. Keys are left in their original position, as
are "furniture" that can not be circumnavigated, such
as pillars.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 25
This is also handy for death match games.
Randomization of weapons means that neither player
knows the initial locations before hand. This helps
to cut down on the "guard the weapons" problem
encountered when one player dies and the other(s)
guard the weapons that he or she needs. JUST MAKE
SURE THAT ALL PLAYERS ARE USING THE SAME WAD FILES, OR
CONSISTENCY FAILURES WILL OCCUR.
Using DOOMUTIL to assist in using external WAD files.
DOOMUTIL's handling of external WAD files makes
evaluating new WAD files in either single or multiple
player easier. It's also handy for the developer who
is using resources from multiple WAD files that are
being changed frequently.
Evaluating new WADs.
DOOMUTIL makes it easy to track which WAD files have
been evaluated. Upon receipt of new WAD files, copy
them into your DOOM directory and invoke DOOMUTIL.
When you select the WAD functions menu, DOOMUTIL will
scan the new WAD files for the information it
maintains. Then, using the Set Sort Order function of
the WAD functions menu, set the first level of sorting
to sort by times used. The WADs that have not been
loaded into DOOM by you will appear at the bottom of
the list.
Developing new composite WADs.
If you're developing multiple WADs with the goal of
building them into a single composite WAD for
distribution, DOOMUTIL can automate the testing (and
building) process.
During development and testing of each of your
component WADs, use the Set Sort Order function of the
WAD functions menu and set the first level of sorting
to either Sort By Modification Time or Sort By User
Modifying. This will move the WADs you're developing
towards the top of the list. Using the Auto Build WAD
File option described in the program configuration
option will cause DOOMUTIL to create a composite WAD
on the fly when you invoke DOOMUTIL. This composite
WAD is persistent, in that it will not be recreated
unless the time and date of one of the component files
changes, or you modify the selected set of WADs.
Then, from the WAD selection screen, highlight the WAD
you're modifying, and use either the F10 or ALT-F10
key sequence described in the WAD selection section
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 26
when the WAD you wish to edit is highlighted (and
selected). If you use F10, then you can launch DOOM
with the modified files using the <ALT-B> sequence.
If you use ALT-F10, then DOOM is automatically invoked
when the editor/view terminates. This allows for
extremely quick testing of your WAD files, regardless
of how many individual WAD files are being developed.
Since DOOMUTIL stuffs a carriage return into the
keyboard buffer before launching DOOM in single player
mode when using external WAD files, modifying and
testing either single or composite WADs is extremely
fast (of course, depending on the speed of your
machine)[2].
2 I use DEU to create and modify my levels. I've also
created some custom sounds and textures for use with
these levels. While it's possible to use DEU to build
all of these into one WAD for testing, it's much easier
to allow DOOMUTIL to do this, using the Auto Build WAD
function described in the Program Configuration
section. Using a RAM drive as the destination of the
auto-built WAD, I use the ALT-F10 sequence from the WAD
selection menu. When I have to rebuild my nodes,
reject, and blockmap entries due to modifications
(which is lengthy), I type q, press Enter, type q, and
press Enter again, then go for a soda or whatever.
When DEU finishes building the information, it
interprets the commands stuffed into the keyboard
buffer, and exits. Upon return to DOOMUTIL, a new
composite WAD is built for me, and DOOM is invoked for
this WAD. If I am away for too long, DOOM's ready for
testing upon my return. It doesn't get much easier, at
least in my opinion.
David Poole, Jr. 94/7/31 17:01
DOOMUTIL 1.04 User's Guide Page 27
Registering DOOMUTIL
To register DOOMUTIL, select the Miscellaneous
Functions from the Main Menu, and then select the
Register DOOMUTIL function. Enter your name in the
first field, leaving the other fields blank. Save your
changes with the Control-Enter key sequence as
described in the Editor documentation. This will
produce a file called "DOOMUTIL.FRM" in the current
directory, or in the configured DOOM directory if one
exists. Copy the DOOMUTIL.FRM file to your printer
using whatever method you use to print text files.
Mail the printout along with a check or money order
for $15 in US funds to:
David Poole, Jr.
PO Box 747
Pacolet, SC 29372
When the funds have cleared, I will mail to you a
serial number and registration key. Upon receipt of
these, you must re-enter the information supplied
exactly as it as printed. After performing this task,
your copy of DOOMUTIL will be registered.
Thank you for using DOOMUTIL!
David Poole, Jr. 94/7/31 17:01