----------------------------------------------------\
Liandri Hacker v2 - http://fraghouse.beyondunreal.com
----------------------------------------------------/

1. What's this then?

Designed as a reinstatement of a blade-based melee weapon for the Tournament, the Liandri Hacker is a durable tarydium-powered mining tool that can cut through tough materials with little to no resistance, including flesh. Primary fire initialises the high-speed circular saw, whereas secondary fire engages the rubble-clearing electrical discharge, which is powerful enough to launch vehicles around and destroy them in two or three hits. The resulting recoil will also propel the user backwards, and so can be used to "hop" across great distances.

The main features of the weapon are:

* Primary fire blade attack - can slice heads off and eviscerate corpses.
* Secondary fire shock blast - very effective for destroying vehicles (and enemies on foot), can propel the player firing it backwards.
* Mutator that replaces the Impact Hammer with this Hacker weapon.
* Configurable secondary fire throwback - see below for more details!
---

And here's a changelog for version 2 (adding more features of course!):

* Secondary fire ragdolls enemies (tip: ragdoll opponents then chop them up with primary fire whilst they're recovering).
* Secondary fire can now knock powerups off players (like the Impact Hammer secondary).
* Primary fire sound altered - it's now a looped cue that fixes the problem with custom music (the music would restart after firing).
* Muzzle flashes added for both fire modes - more eye candy!
* More graphical detail for the hit effects (when hitting walls/players/vehicles).
* Server upk reference bug fixed (servers will now push the HackerResources.upk file as well as the code package).
* Damage values are configurable in UTHacker.ini (in the Config folder).
* Various "under the bonnet" tweaks that have no visual effect.


----------------\
2. Configurable throwback? Explain!

When I was coding the weapon, I originally set the throwback value for the secondary fire to some insane amount, and quite enjoyed throwing myself around the maps! If you want to play with the weapon as intended, then you don't need to touch anything, but if you want to send your player flying into the stratosphere (or even restrain the effect), then you can use either of the following methods:

---
I. With the weapon equipped, type "setthrust -value" into the console (without quotes) and then press return. So, for example:

setthrust -5000

The default value is -1200. Don't forget to put the minus in, otherwise the weapon won't have much of an effect...

To reset the thrust, simply type "resetthrust" into the console and hit return.

---
II. Open up UTHacker.ini in your Config folder (found in My Games/Unreal Tournament 3/UTGame) and look for the heading [Hacker.UTWeap_Hacker]

You will see the following:

[Hacker.UTWeap_Hacker]
BackwardsThrust=-1200.000000

Simply change this value to whatever you want to use, and again, don't forget the minus!


----------------\
3. How do I use this thing then?

Well, there is a mutator provided called "Hacker - Replace Impact Hammer" that will work just fine, as the Hacker was more or less designed as a replacement for the Hammer.

You can also choose to use Epic's "Weapon Replacement Mutator" to replace any weapon you want with the Hacker, if you have a certain longing for the old Hammer...

Alternatively, you can use the console command "giveweapon" - here's the correct syntax for the weapon:

giveweapon hacker.utweap_hacker - Will give you the Hacker


CONFIGURABLE DAMAGE: Some will undoubtedly feel that the weapon is way too overpowered (even though it's a gas-powered chainsaw..!), so in UTHacker.ini file you will find four entries underneath [Hacker.UTWeap_Hacker]:

PrimaryDamage=15.000000
PrimaryDamageHS=30.000000
SecondaryDamage=55.000000
SecondaryDamageHS=75.000000

The HS denotes headshot damage (when the weapon hits the "head" area of an enemy). Feel free to tweak these values as you see fit!

----------------\
4. Server support?

You don't need to mess around with ServerPackages! Woo! All you need to do is run a server with the mutator in the command line! So your syntax will be something like the following:

ut3 server DM-Mapname?mutator=Hacker.UTMutator_Hacker

PLEASE NOTE: SetThrust doesn't work online for clients, this is intentional and is not a bug. If you'd like to alter the thrust value for a server game, simply change the value in the UTHacker.ini file as illustrated above.


----------------\
5. Who's the author behind this terrible excuse for a mod!?

Parser did the coding and messing about with models - you can find him at http://fraghouse.beyondunreal.com


----------------\
6. Finally...

If you want to use any assets/code/whatever from this mutator, just drop us a line at the forums (link above) and let us know about it!

Enjoy!