******************************
* Decapination v1.1.0.2      *
******************************

v1.1.0.2

This is an updated version of Decapination. This new version integrates LDukes excellent Grabber plugin, changes the blood effects over to the OB particle system and.....adds a Wood Chipper! We don't like carrying around those yucky heads and need a way of disposing of them ;)

Since heads can be thrown, there is a simple points system that rewards players for long throws into the Wood Chipper. It is suggested this plugin be run on a PvP knives only server for maximum fun. Just make sure you advertise to players to bind +dcgrab and +dcthrow so they don't get lost. It is also suggested you use a fast http download server for content as the models can be painfully slow when served from srcds.

IMPORTANT: When adding or editing maps to the dc_mapconfig.ini keyvalues file, you MUST make sure the rotation is AXIS ALIGNED. The trigger for detecting heads in the chipper is an Axis Aligned Bounding Box. You must ensure that chippy is not placed on uneven surfaces and is only rotated around the Y axis by 90 degree increments....

!!Please note that the Wood Chipper has been created specifically for this mod, and may be used in any other mod ONLY if you acknowledge me in the credits!!


.robot, 28/11/10

Changes Since 1.1.0.1
---------------------
* catch decaps by world (index 0) and provide better speak spam
* blocked out some debug to console messages


Changes Since 1.1.0.0
---------------------
* Fixed known crashbugs
* made grabber drop items if held distance is too great (150.0 + sm_decap_grabber_distance)
* changed most announcements to be global rather than direct to attacker/victim
* added decap announcements
* code cleanup


Acknowledgements
----------------
.robot(me)                                       Coding, valve model chopping, Wood Chipper model and texture
warfare, kane, munch, sorj, beefy, Hef, Gibbo    Testing and general annoyance
namine                                           Testing and suggestions
LDuke                                            Grabber code and general inspiration
DiscoBBQ                                         Lots of snippets from CSSGore etc
EVERYONE at SourceMod                            You all rock - I stole code from all of you


Convars

Name                             Default   Description
------------------------------------------------------
sm_decap_version                           DecapiNation Version

sm_decapspurtinterval            0.8       time in seconds between neck blood spurts
sm_decap_bloodloss               1         health lost for each blood spurt
sm_decap_aimtolerance            10        tolerance factor for replacing heads
sm_decap_checkinterval           1.0       time in seconds between check head/body positions for re-animation
sm_decap_headshot                1         decapination on headshot
sm_decap_knife                   1         decapination on knifing
sm_decap_he                      1         decapination on grenade
sm_decap_tkenabled               1         can decapinate own team

sm_decap_grabber_speed           10.0      speed at which grabbed object will move with player
sm_decap_grabber_distance        64.0      distance at which grabbed object will hover in front of player
sm_decap_grabber_throwtime       2.0       time to charge up to full throw speed
sm_decap_grabber_throwspeed      1000.0    speed at which an object is thrown
sm_decap_grabber_maxdistance     512.0     maximum distance from which you can grab an object
sm_decap_grabber_steal           1         can objects be 'stolen' from other players (0=no 1=yes)
sm_decap_grabber_droponjump      1         drop objects when jumping (prevents player from flying around level on large objects) (0=no 1=yes)


Binds

Name        Description
-----------------------
+dcgrab     this bind is necessary so you can grab an object
+dcthrow    this bind is for throwing held objects. holding the key down will build up a throw charge for longer throws


Config files

Name                                                    Description
-------------------------------------------------------------------
cstrike\addons\sourcemod\configs\dc_assetconfig.ini     Simple text file list of files that players will download to play decapination.
cstrike\addons\sourcemod\configs\dc_mapconfig.ini       KeyValues file specifying the location to spawn Chippy on each map.