[ian.cammarata]

Grab+ v1.2.5
Feb 19, 2011
AGPLv3 - "This is a new license; it is based on version 3 of the GNU General Public License (GNU GPLv3), but has an additional term to allow users who interact with the licensed software over a network to receive the source for that program." - http://www.fsf.org/agplv3-pr

Description:
This is a remake from scratch of SpaceDude's Jedi Force Grab plugin. It has many additional features and optimizations, is less spammy, multilingual and requires fewer binds.


Features:
Multilingual
Screenfade to indicate grab activity instead of chat spam.
Can grab players off a ladder.
Automatically choke by holding down +pull while at min distance.
Choke with use key.
Throw with drop.
Can't have mutliple admins grabbing the same object.
Auto drop on death.
Grab entities other than players, such as bombs, weapons, and hostages.


Commands:
+grab : Grab something for as long as you hold down the key.
grab_toggle : Same as +grab but toggles.
amx_grab <name> : Grab client by name or id and teleport them to you. Use +grab or grab_toggle key to release.

+pull/+push : Pulls/pushes the grabbed towards/away from you as you hold the button.

+use : Chokes the grabbed (it damages the grabbed with 5 (cvar: gp_chokedmg) hp per 1.5 (cvar: gp_choketime) seconds)
drop - Throws the grabbed with 1500 velocity. (cvar: gp_throwforce)


Cvars (First value is default):
gp_enabled <1|0> Enables all plugin functionality.
gp_players_only <0|1> Disables admins grabbing entities other than players.

gp_min_dist <90|...> Min distance between the grabber and grabbed.
gp_grab_force <8|...> Sets the amount of force used when grabbing players.
gp_throw_force <1500|...> Sets the power used when throwing players.
gp_speed <5|...> How fast the grabbed moves when using push and pull.

gp_choke_time <1.5|...> Time frequency for choking.
gp_choke_dmg <5|...> Amount of damage done with each choke.
gp_auto_choke <1|0> Enable/disable choking automatically with +pull command.

gp_screen_fade <1|0> Enables/disables screenfade when grabbing.
gp_glow <1|0> Enables/disables glowing for grabbed objects.

gp_glow_r <50|0-255> Sets red amount for glow and screenfade.
gp_glow_g <0|0-255> Sets green amount for glow and screenfade.
gp_glow_b <0|0-255> Sets blue amount for glow and screenfade.
gp_glow_a <0|0-255> Sets alpha for glow and screenfade.


Notes:
Make sure you place the grab_plus.txt file in addons\amxmodx\data\lang


Credits:
Thanks to vittu for contributing code (changed all engine/fun module stuff to fakemeta).

Thanks to all the coders who worked on the original Jedi Force Grab plugin for all their ideas:
SpaceDude
KCE
KRoTaL
BOB_SLAYER
kosmo111


Supported Languages:
1337 (100%) - Thanks to l337newb
Brazilian Portuguese (100%) - Thanks to Arion
Danish (100%) - Thanks to nellerbabz
Dutch (100%) - Thanks to BlackMilk
English (100%)
Finnish (100%) - Thanks to Pro Patria Finland
French (100%) - Thanks to connorr
German (100%) - Thanks to SchlumPF*
Russian (100%) - Thanks to `666
Spanish (100%) - Thanks to RenXO
Swedish (100%) - Thanks to Bend3r


Change Log:
Key (+ added | - removed | c changed | f fixed)

v1.2.5 (Feb 19, 2011)
f: Applied fix mailed to me on Allied Modders site several years ago. (Maybe I should sign up for new mail notifications.)
Thanks to ConnorMcLeod

v1.2.4 (Feb 18, 2007)
f: Killing player with choke in some mods bugged out really bad.

v1.2.3 (Nov 21, 2007)
c: A few more small optimizations.
f: Bloodstream for choke wasn't aligned with player.
f: Bad message disconnect error when players were choked. ( stupid SVC_DAMAGE define )

v1.2.2 (Nov 16, 2007)
c: A few small code optimizations.

v1.2.1 (Nov 12, 2007)
f: Elimited two run time warnings in the player prethink function.

[M249-M4A1]

Looks good

[Bend3R]

[sv]
COULDNT = Kan inte ta tag i den spelaren.
ALREADY = Nagon annan haller i den redan.

[ian.cammarata]

Originally Posted by Bend3R [sv] COULDNT = Kan inte ta tag i den spelaren. ALREADY = Nagon annan haller i den redan.

Thanks!

[Jheshka]

Looks cool.

[Styles]

ice ill test this 2morow

[nellerbabz]

Danish

[da]
COULDNT = Kunne ikke tage fat i spilleren.
ALREADY = Nogen har allerede fat i spilleren.

Can this grab entities aswell as players?

[BlackMilk]

Call me silly, but I'd prefer the "chat spam" over any other screen/visual effects...

The rest sounds good though, stuff like grabbing players off ladder entities...
But I'm just lazy.

And I don't mind multiple admins performing grab on entities and players xD
(we make sure it doesn't get too chaotic on our own)

GJ, karma, cool plugin

(this can't be too far off from Approval aight?)

EDIT: Just a quick idea, because you've used standard keys so well: how about a cvar (0 | 1 values) that sets the pull and push features depending on value?
For example when the cvar is set to 1, using mouse wheel (invprev and invnext or something?) would push or pull the player (but ONLY while grab is active), and when the cvar is set 0 (default), then the mouse wheel functions normally as switching weapons.
EDIT2: And maybe a value of 3 for doing the same thing but with left and right mouse buttons, again, only when grab is active.
(then people like me can still use mouse3 for grabbing)

^ Because I hate having to use separate binds for it. I've actually just got +grab binded on mouse3 and throw binded on my 'o' key, I never really use push and pull cos of the extra binds needed.

---Since we're already posting translations here in the topic...

[nl]
COULDNT = Kon die speler niet vasthouden.
ALREADY = Iemand anders houdt dat al vast.

[l33tnewb]

[ls]
COULDNT = c0u1d n07 gr48 7h47 p14y3r.
ALREADY = $0m30n3 31$3 !$ 41r34dy gr488!ng 7h47.

[Pro Patria Finland]

[fi]
COULDNT = Tarttuminen pelaajaan epaonnistui.
ALREADY = Joku muu on jo tarttunut tuohon.

Niiice. Gotta test it.