Pro Zoom Instagib

=========================================================================

Professional Zoom Instagib

Author: [LGUT]TBone
Date:  02/13/2003 (mm/dd/ccyy)
Version: 1.3.0 BETA
Package: ProZoomInstagibV130
Mutator: ProZoomInstagib
Fully Qualified Name:  ProZoomInstagibV130.ProZoomInstagib

Email: [email protected]
Website: www.LowGravUT.com
Test Server:  199.240.91.45

Included Files:  ProZoomInstagibV130.u, ProZoomInstagib.int, README_PLEASE.txt (this file)

=========================================================================

1.  Version History
2.  Compatible Gametypes
3.  Features
4.  Installation (client)
5.  Installation (server)
6.  Planned Future Enhancements
7.  Comments and Suggestions
8.  Credits

=========================================================================

It's long, but necessary... please read through this THOROUGHLY before sending any feedback ;)

1.  Version History

Changes in version 1.3.0 from 1.2.2
	
- NEW HUD!  Custom HUD removes the usage of unecessary weapon slots, due to the fact that PZIG only uses 3 weapons.  HUD is compatible with DM, TDM, CTF, BR, and DDOM.  If you have a custom gametype that you would like to use PZIG with, let me know and I will add compatibility.
- Beam effects of the Core Shock and Zoom Shock rifles have been finalized.
- Allowed the xLoc to be enabled/disabled by other mutators.
- Headshot radius of the Zoom Shock Rifle and the Combo Shock Rifle has been made slightly smaller to make them more difficult to achieve.  It is now the same radius as the PZIGLG.
- A TON of code cleanup!

Changes in version 1.2.2 from 1.2.1
	
- Bug where impact effects of shock beams was not replicating has been fixed.
- Took out all karma modifications due to performance loads.
- Added console/log output which signifies a successful load.

Changes in version 1.2.1 from 1.2.0

- (Courtesy of 'Rozz', creator of the Lz3Weapons mutators) Fixed beam location as a result of patch 2186 (Epic shifted the aim away from the crosshair).
- Changed the 'switch-to' sound of the Core Instagib Rifle to the Flak Cannon switch-to sound so that the two rifles have different switch-to sounds.
- Increased velocity of Karma Ragdoll Physics (affects corpses only, no gameplay affected).
- Enhanced the impact effect of both Shock Rifles.
- Removed references to redundant defaultproperties declarations.

Changes in version 1.2.0 from 1.1.0 and 1.0.0

- The Instagib Combo Shock Rifle now uses the Ion Painter model to differentiate it from the Instagib Zoom Shock Rifle.  We have plans to replace this with a custom model down the road.
- All three rifles are now capable of headshots (it won't kill them any faster since it's already instagib, but it sure is good for the glory!)
- The combo radius (beam + plasma ball) has been increased about 2% (seems small, but it's better)
- The red beam effect isn't "fuzzy"... it's more like the blue beam effect.
- The Instagib Lightening Gun's rate of fire has been slowed down slightly to help offset the advantage it has from its arcs.

2.  Compatible Gametypes
Because of PZIG's custom HUD and custom scoring, there are minor compatibility issues when it comes to non-standard gametypes.  The mutator will still work, however the custom HUD.  Below are compatible gametypes.
	
If you would like to see a custom gametype added, please have the author contact me with the source code to his/her gametype.
	
PZIG Compatibility:
- Deathmatch (DM)
- Team Deathmatch (TDM)
- Capture the Flag (CTF)
- Bombing Run (BR)
- Double Domination (DOM)
- Compatibility with Last Man Standing, Mutant, and Invasion will be 
evaluated when Epic's Bonus Pack is released.  If there are compatibility 
problems with those gametypes, it will be fixed in PZIG v2.0.1.
	
3.  Features
	
*** ALL OF THE INCLUDED WEAPONS ARE 1-HIT KILL WEAPONS, AND ALL HAVE UNLIMITED AMMO.

Standard Instagib and Zoom Instagib can REALLY get boring sometimes, or maybe the Zoom feature isn't the end-all-be-all to you, but maybe you also don't enjoy Normal Weapons play... so what't the answer?
	
Professional Zoom Instagib.
	
PZIG, for short, provides some flexibility to as many players as possible when it comes to the game of Instagib.  NOW, before you gawk at the thought of having THREE Instagib 	weapons in your inventory, PLEASE read their descriptions below, which lists their advantages and disadvantes.
	
	>>> "Instagib Zoom Shock Rifle" 
	
This is basically the same as the default Instagib rifle, except that the beam looks cooler ;)
		
		PROS:  
- Rate of fire is 1.1, which is the default for regular instagib (rate 
of fire, or ROF, means it can fire a shot every 1.1 seconds).  The lower 
the number is for ROF, the faster the weapon can shoot.
			
 Secondary fire is still the ZOOM function.
		
		CONS:
- You are not anonymous when you fire the weapon: meaning that if you're on the red team, then you fire a red-tinted beam, and if you're on blue, then you fire a blue-tinted beams.  NOTE: these are not the same beams that are used in regular Instagib.  They act the same, but appear a little more up-to-date.
			
	>>> "Instagib Combo Shock Rifle"
	
This is the EXACT same weapon as the Instagib Zoom Shock Rifle, except that it's secondary fire shoots a plasma ball.  MUCH CARE HAS BEEN TAKEN to reduce plasma spamming as much as possible (by reducing the plasma ball's ROF), without making it impossible to to hit a combo.  This was a tricky balance, and we think we did a pretty good job of evening it out.
		
		PROS:
- Rate of fire is 1.1, which is the default for regular instagib (rate 
of fire, or ROF, means it can fire a shot every 1.1 seconds).  The lower 
the number is for ROF, the faster the weapon can shoot.
			
- Ability to shoot a projectile (plasma ball) and do devastating combos.
			
		CONS:
- The ROF for the plasma ball has been slowed down from the original shock rifle to reduce spamming.  Choose your shots carefully when using the secondary fire... you can't fire another plasma ball OR the secondary fire until the ROF for the plasma ball has elapsed.
			
- You are not anonymous when you fire the weapon: meaning that if you're on the red team, then you fire a red-tinted beam, and if you're on blue, then you fire a blue-tinted beams.  NOTE: these are not the same beams that are used in regular Instagib.  They act the same, but appear a little more up-to-date.
			
	>>> "Instagib Lightning Gun"
	
		PROS:
- Zoom on the secondary fire
- Headshots :D  Doesn't really help when you get a headshot, since it's all instant-kill, but some of us love the glory of a head on fire ;)
			
- On rare occassions, you may be able to kill more than one opponent in one shot due to the ILG's arcs.
			
- Firing this gun leaves you somewhat anonymous... that is, you cannot tell which team the player is on by the color of his beam. In Instagib, as any veteran already knows, this can be INVALUEABLE.  In regular Instagib, your beam color often gives you away, because people tend to ignore the beams colors of their team.  With the ILG, you remain anonymous is this regard.  
		
HOWERVER, there is a downside...
			
		CONS:
- Unlike the two Shock Rifles, who have a rate of fire of 1.1, the ILG has 
a much slower rate of fire of 1.8 (one shot every 1.8 seconds).  Doesn't 
sound like a big difference, but wait until you're frantically hitting your 
fire key and nothing happens ;)
			
One small but somewhat popular feature is the "push effect" of a teammate's shock beam.  Many have complained that UT2003's instagib doesn't provide enough push.  This has been "fixed" in this mutator.
		
Looks complicated on paper, but it really isn't.  All we've done is added a new dynamic to the game to make it a little more interesting and flexible.  It's all still one shot kills, but we've added small changes to the weapons to give each its own slight advantages and disadvantages.
		
4.  Installation (client)

Copy ALL FILES in the ProZoomInstagibV130.zip file to your c:\UT2003\System directory (assuming that's where you installed UT2003.  That is the default location.).
	
	These files are:
		ProZoomInstagib.int
		ProZoomInstagibV130.u
	
5.  Installation (server)

Copy ALL FILES in the ProZoomInstagibV130.zip file to your \UT2003\System directory.
	
These files are:
ProZoomInstagib.int
ProZoomInstagibV130.u
		
a. Stop your server
	
b. Open UT2003.ini from the server's \UT2003\System folder and add the following to your server packages list, which is located under [Engine.GameEngine]: 	ServerPackages=ProZoomInstagibV130
		
c. Edit your startup command to include this mutator.  For example:
		
ucc server CTF-Face3.ut2?game=XGame.xCTFGame?mutator=ProZoomInstagibV130.ProZoomInstagib,XGame.MutQuadJump
		
d.  Save the file and close it.
	
f.  Start your server.

6.  Planned Future Enhancements
	
While this may potentially (well, probably) be the final release of PZIG, IF another version is released, it MAY contain the following:
	
- A member of the LGUT Develpment Team ([LGUT]Realm) is experimenting with a fourth weapon to add:
a modified Rocket Launcher.  Now, before you toss your lunch, be open to the idea!  It's in its preliminary stages, but I suspect it will be modified to have a much slower rate of fire, VERY little splash damage, and even possibly limited ammo.  These are just guesses, so who knows.  BUT, I think it can be fun.  Regardless, rest assured that if it is included in the next release, there will be an option to disable it (actually, there will be options to disable any of the weapons... see below).
		
7.  Comments and Suggestions

	EMAIL: [email protected]
	WEB: www.LowGravUT.com

I have heard nothing but positive feedback regarding the rates of fire of all weapons, and have had excellent feedback on the weapon balance in general.  Weapon attributes will not be altered any further.
	
However, if you encounter a bug, please let me know and I will handle it immediately.
	
8.  Credits

All code/content was written and developed by [LGUT]TBone with the following exception:
	
- Aiming fix for weapons subclassed from the ShockRifle class (which include the PZIGZoomShockRifle and the PZIGComboShockRifle) was done by 'Rozz'.  This fix is needed for patched versions after build 2166.  Epic altered beam trajectory to match up with the plasma ball's trajectory.  This resulted in the beam not perfectly targeting your crosshair.  Thanks Rozz!

Read More