Title    : Shell Eject for Shotguns
Filename : newEjectwp.zip (with progs.dat)
	   newEjectnp.zip (without progs.dat)
Version  : 2.00
Date     : 9/8/96
Author(s): Steve Bond of Quake Command (original-designer, coder)
           Robert Duff (hacker)
Email    : wedge@nuc.net
	   robduff@cco.caltech.edu

Credits  : Quake Command for the original mod.

	   Quake-C specification and HTML version.
 	   by Olivier Montanuy 
           Olivier.Montanuy@wanadoo.fr

   	   ID Software

Type of Mod
-----------
Quake C  : yes
Sound    : yes
MDL      : yes

Format of Quake C
-----------------
unified diff  : yes
context diff  : no
.qc files     : yes
progs.dat     : yes

Description of the Modification
-------------------------------
This mod make shells be ejected from the single and double
shotguns. It includes 

How to use Modification
-------------------------------
Automatically utilized when the shotguns are fired.

How to Install the Modification
-------------------------------

Unzip the archive into your main Quake directory, the one with the
Quake.exe file (registered only please!), with the -D option or 
whatever option will extract with directory information in your
particular program. Now run quake, adding "-game newEject" to the
command line (do not type the quotes). Switch to shotgun and you're
ready to pump some shells.

I changed the sound to be a little less musical, more mechanical.
If you don't like the new sound rename OldShellhit.wav to 
Shellhit.wav. Or if you have a better sound, rename that to 
Shellhit.wav and move it to the newEject\sound folder.

To recompile, copy all Quake-C files from the version 101 collection
to the ejectscript file. DO NOT overwrite any files! You'll find
this collection wherever you got the quake-c compiler, probably in
the same file. Copy quake-c compiler to the ejectscript file.
Execute the compiler. Depending on compiler version and where the
ejectscript file is, you should have a progs.dat file in your
..\quake\newEject\ file which is where it needs to be.

To patch, run "patch -p1 < neweject.pat" for a dos command line
with neweject.pat, the version 101 quake-c files, and the
comand prompt all in the same directory.

Technical Details
-----------------

Features:

	1. Shells eject with shotgun firing.
	2. Double shotgun fires two shell casings.
	3. Casings Sub_Remove time reduced to
	   hopefully preempt slowdown from many
	   shells (now 10 seconds).
	4. Shells eject at 90 degrees right of the
	   direction the player faces.
	5. Shells eject with a true random pattern.
	6. Double shotgun ejects shells with more
	   punch and randomness.
	7. Custom casing model (credit Steve please!)
	8. Custom sound modified from Steve's sound,
	   sound mechanised and mixed with self.
	9. Grunts fire shells too now!

Previously:

	1-2. Same.
	3. Casings disappeared at 20 seconds.
	4. Shells always ejected at about the same
	   direction relative to the world. Roughly
	   right from the info_player_start of start.bsp.
	5. Shells ejected at four randomly chosen static
           locations. Casings had a bad tendency to pile
	   up, defining the law of entropy. 
	6. Double shotgun was the same as single.
	7. Same model (again credit Steve please!)
	8. Sound seemed a little musical so I reworked it.
	9. Poor Grunts couldn't join the fun. :(

Bugs:
	1. None that I know. Please report any to
	   robduff@cco.caltech.edu

Future Enhancements:

	1. Streamline code and make it faster if
	   neccessary, please report any problems
	   in slow down, especially with many
	   players shooting shells.

Author Information
------------------

This is my first Quake C mod. I plan to do some more as time allows.
If you use this code as a basis for another mod, or if you have some
ideas for improvements or other mods, please let me know, I would
be very interested.

E-mail me at: robduff@cco.caltech.edu

Copyright and Distribution Permissions
--------------------------------------

You may distribute this Quake modification in any electronic
format as long as this description file remains intact and unmodified
and is retained along with all of the files in the archive.
This mod may be included in any "collection mods", which take
several mods and combine them, as long as this collection is
freely distributed, the readme files are unchanged excepting
for renaming (or added completely to the collections readme
file), and all modified quake-c is unchanged including modification
indicator tags, "rd mod start".
Profits cannot be made or fees excised upon the user for this
Quake modification without express consent of the authors. 
All rights reserved by the authors.

Availability
------------

The Eject mod can hopefully be found at the following locations:

ftp.cdrom.com/.5/idgames2/* 
* (check incoming, newstuff or quakec/misc or quakec/weapons)
The Quake Stomping Grounds - http://204.73.178.27/ (check files area)
Quake Command - http://www.nuc.net/quake

This file is a modification of the eject mod
created by Steve Bond. Model file and old sound
file are exclusively his. Quake-c files,
progs.dat, any diffs, and new sound are
derivitive works by Robert Duff.

-------------------------------------------
Robert Duff  mailto:robduff@cco.caltech.edu
   http:/www.cco.caltech.edu/~robduff/