Multi Theft Auto: Wiki - User contributions [en]

InterpolateBetween

2011-08-01T13:45:52Z

MaddDogg: Typo

__NOTOC__
{{Server client function}}

Interpolates a 3D Vector between a source value and a target value using either linear interpolation or any other [[Easing|easing function]].
It can also be used to interpolate 2D vectors or scalars by only setting some of the x, y, z values and putting 0 to the others.

==Syntax==
<syntaxhighlight lang="lua">
float float float interpolateBetween ( float x1, float y1, float z1,
float x2, float y2, float z2,
float fProgress, string strEasingType,
[ float fEasingPeriod, float fEasingAmplitude, float fEasingOvershoot ] )
</syntaxhighlight>

===Required Arguments===
*'''x1, y1, z1:''' 3D coordinates of source vector/value
*'''x2, y2, z2:''' 3D coordinates of target vector/value
*'''fProgress:''' float between 0 and 1 indicating the interpolation progress (0 at the beginning of the interpolation, 1 at the end).
*'''strEasingType:''' the [[Easing|easing function]] to use for the interpolation

===Optional Arguments===
*'''fEasingPeriod:''' the period of the [[Easing|easing function]] (only some easing functions use this parameter)
*'''fEasingAmplitude:''' the amplitude of the [[Easing|easing function]] (only some easing functions use this parameter)
*'''fEasingOvershoot:''' the overshoot of the [[Easing|easing function]] (only some easing functions use this parameter)

===Returns===
Returns ''x, y, z'' the interpolated 3D vector/value if successful, ''false'' otherwise (error in parameters).
As mentioned before, interpolateBetween can be used on 2D vectors or scalars in which case only some (x, y or just x) of the returned values are to be used (cf. alpha interpolation in marker example or size interpolation in window example).

== Examples ==
The examples below are only clientside examples even though the function can be used on both sides. Indeed it makes more sense to use it with onClientRender/onClientPreRender but the freedom is given to use it in any other context.
<section name="Client" class="client" show="true">
This clientside example uses interpolateBetween to create position and color interpolation(with effect) on a marker.
The command to test it is "/marker".
The position is interpolated with "OutBounce" as strEasingType to make the marker bounce off the ground and "Linear" interpolation for the color.
<syntaxhighlight lang="lua">
local g_Marker = nil
addCommandHandler("marker",
function ()
if g_Marker then return end

local x, y, z = getElementPosition(getLocalPlayer())
z = z - 1

g_Marker = {}
g_Marker.startPos = {x, y, z + 5}
g_Marker.startTime = getTickCount()
g_Marker.startColor = {255, 0, 0, 0}
g_Marker.endPos = {x, y, z}
g_Marker.endTime = g_Marker.startTime + 2000
g_Marker.endColor = {0, 0, 255, 255}

local x, y, z = unpack(g_Marker.startPos)
local r, g, b, a = unpack(g_Marker.startColor)
g_Marker.marker = createMarker(x, y, z, "cylinder", 1, 255, r, g, b, a)

addEventHandler("onClientRender", getRootElement(), popMarkerUp)
end)

function popMarkerUp()
local now = getTickCount()
local elapsedTime = now - g_Marker.startTime
local duration = g_Marker.endTime - g_Marker.startTime
local progress = elapsedTime / duration

local x1, y1, z1 = unpack(g_Marker.startPos)
local x2, y2, z2 = unpack(g_Marker.endPos)
local x, y, z = interpolateBetween (
x1, y1, z1,
x2, y2, z2,
progress, "OutBounce")

setElementPosition(g_Marker.marker, x, y, z)

local r1, g1, b1, a1 = unpack(g_Marker.startColor)
local r2, g2, b2, a2 = unpack(g_Marker.endColor)
local r, g, b = interpolateBetween (
r1, g1, b1,
r2, g2, b2,
progress, "Linear")
local a = interpolateBetween (
a1, 0, 0,
a2, 0, 0,
progress, "Linear")

setMarkerColor(g_Marker.marker , r, g, b, a)

if now >= g_Marker.endTime then
removeEventHandler("onClientRender", getRootElement(), popMarkerUp)
setTimer(
function ()
destroyElement(g_Marker.marker)
g_Marker = nil
end, 3000, 1)
end
end
</syntaxhighlight>
</section>

<section name="Client" class="client" show="true">
This clientside example uses interpolateBetween to create size and position interpolation (with effect) on a gui-window.
The command to test it is "/window".
When the window pops up it uses "OutElastic" as the strEasingType to create the bouncing/elastic effect.
When it fades away, it uses "InQuad" to have an accelerating fading.
<syntaxhighlight lang="lua">
local g_Window = nil
addCommandHandler("window",
function ()
if g_Window then return end

g_Window = {}

local screenWidth, screenHeight = guiGetScreenSize()
g_Window.windowWidth, g_Window.windowHeight = 400, 315
local left = screenWidth/2 - g_Window.windowWidth/2
local top = screenHeight/2 - g_Window.windowHeight/2

g_Window.window = guiCreateWindow(left, top, g_Window.windowWidth, g_Window.windowHeight, "Interpolation on GUI", false)

g_Window.closeBtn = guiCreateButton(320, 285, 75, 23, "Close", false, g_Window.window)

guiWindowSetSizable(g_Window.window, false)
guiWindowSetMovable(g_Window.window, false)
guiSetEnabled(g_Window.window, false)
guiSetVisible(g_Window.window, false)

g_Window.startTime = getTickCount()
g_Window.startSize = {0, 0}
g_Window.endSize = {g_Window.windowWidth, g_Window.windowHeight}
g_Window.endTime = g_Window.startTime + 1000
addEventHandler("onClientRender", getRootElement(), popWindowUp)
end)

function on_closeBtn_clicked(button, state, absoluteX, absoluteY)
if (button ~= "left") or (state ~= "up") then
return
end

if not g_Window then return end

showCursor(false)
guiSetEnabled(g_Window.window, false)
guiWindowSetMovable(g_Window.window, false)

local screenWidth, screenHeight = guiGetScreenSize()
local posX, posY = guiGetPosition(g_Window.window, false)

g_Window.startTime = getTickCount()
g_Window.startSize = {g_Window.windowWidth, g_Window.windowHeight}
g_Window.startCenter =
{
posX + g_Window.windowWidth/2,
posY + g_Window.windowHeight/2,
}

g_Window.endSize = {0, 0}
g_Window.endTime = g_Window.startTime + 1000
g_Window.endCenter =
{
screenWidth,
screenHeight
}

addEventHandler("onClientRender", getRootElement(), popWindowDown)
end

function popWindowUp()
local now = getTickCount()
local elapsedTime = now - g_Window.startTime
local duration = g_Window.endTime - g_Window.startTime
local progress = elapsedTime / duration

local width, height, _ = interpolateBetween (
g_Window.startSize[1], g_Window.startSize[2], 0,
g_Window.endSize[1], g_Window.endSize[2], 0,
progress, "OutElastic")

guiSetSize(g_Window.window, width, height, false)

local screenWidth, screenHeight = guiGetScreenSize()
guiSetPosition(g_Window.window, screenWidth/2 - width/2, screenHeight/2 - height/2, false)

if not guiGetVisible(g_Window.window) then
guiSetVisible(g_Window.window, true)
guiBringToFront(g_Window.window)
end

if now >= g_Window.endTime then
guiSetEnabled(g_Window.window, true)

guiBringToFront(g_Window.window)
removeEventHandler("onClientRender", getRootElement(), popWindowUp)
addEventHandler("onClientGUIClick", g_Window.closeBtn, on_closeBtn_clicked, false)
showCursor(true)
guiWindowSetMovable(g_Window.window, true)
end
end

function popWindowDown()
local now = getTickCount()
local elapsedTime = now - g_Window.startTime
local duration = g_Window.endTime - g_Window.startTime
local progress = elapsedTime / duration

local width, height, _ = interpolateBetween (
g_Window.startSize[1], g_Window.startSize[2], 0,
g_Window.endSize[1], g_Window.endSize[2], 0,
progress, "InQuad")

guiSetSize(g_Window.window, width, height, false)

local centerX, centerY, _ = interpolateBetween (
g_Window.startCenter[1], g_Window.startCenter[2], 0,
g_Window.endCenter[1], g_Window.endCenter[2], 0,
progress, "InQuad")

guiSetPosition(g_Window.window, centerX - width/2, centerY - height/2, false)

if now >= g_Window.endTime then
removeEventHandler("onClientRender", getRootElement(), popWindowDown)
destroyElement(g_Window.window)
g_Window = nil
end
end

</syntaxhighlight>
</section>

==See Also==
{{Utility functions}}

SetHeatHaze

2011-07-17T07:18:09Z

MaddDogg: Added heat haze template

__NOTOC__
{{Server client function}}
This function changes the heat haze effect.

==Syntax==
<syntaxhighlight lang="lua">
bool setHeatHaze ( int intensity, [ int randomShift = 0, int speedMin = 12, int speedMax = 18, int scanSizeX = 75, int scanSizeY = 80, int renderSizeX = 80, int renderSizeY = 85, bool bShowInside = false ] )
</syntaxhighlight>

===Optional Arguments===
{{OptionalArg}}
{{HeatHazeValues}}

===Returns===
Returns ''true'' if the heat haze effect was set correctly, ''false'' if invalid values were passed.

==Example==
'''Example 1:''' This example turns the heat haze effect off:
<syntaxhighlight lang="lua">
setHeatHaze ( 0 )
</syntaxhighlight>

'''Example 2:''' This example will have an interesting effect:
<syntaxhighlight lang="lua">
setHeatHaze ( 50, 20, 0, 500, 200, 100, 50, 20, true )
</syntaxhighlight>

==See Also==
{{World functions}}

GetHeatHaze

2011-07-17T07:17:17Z

MaddDogg: Created a template for heat haze values and added it to 'returns' section

__NOTOC__
{{Server client function}}
This function will return the current heat haze effect settings.

'''Note:''' The server can only return the heat haze settings if it has actually been set by script.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int, int, int, int, int, int, bool getHeatHaze ( )
</syntaxhighlight>

===Returns===
Returns 9 values, which are the same used as arguments in [[SetHeatHaze]]:
{{HeatHazeValues}}

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{World functions}}

[[Category:Needs_Example]]

Template:HeatHazeValues

2011-07-17T07:16:43Z

MaddDogg: Created a heat haze values template for various heat haze functions

*'''intensity:''' The intensity of the effect, from 0 to 255.
*'''randomShift:''' Sets a random jitter, from 0 to 255.
*'''speedMin:''' The slowest effect speed, from 0 to 1000.
*'''speedMax:''' The fastest effect speed, from 0 to 1000.
*'''scanSizeX:''' The X size in pixels of the chunk grabbed from the screen, from -1000 to 1000.
*'''scanSizeY:''' The Y size in pixels of the chunk grabbed from the screen, from -1000 to 1000.
*'''renderSizeX:''' The X size in pixels the chunk will be when rendered back to the screen, from 0 to 1000.
*'''renderSizeY:''' The Y size in pixels the chunk will be when rendered back to the screen, from 0 to 1000.
*'''bShowInside:''' Set to ''true'' to enable the heat haze effect when inside a building.

CreateColRectangle

2011-02-04T11:45:35Z

MaddDogg: west - south mix up | renamed fDepth to fHeight

__NOTOC__
{{Server client function}}
This function creates a collision rectangle. This is a shape that has a position and a width and a depth. See [http://en.wikipedia.org/wiki/Rectangle Rectangle] for a definition of a rectangle. XY marks on the south west corner of the colshape.

==Syntax==
<syntaxhighlight lang="lua">
colshape createColRectangle ( float fX, float fY, float fWidth, float fHeight)
</syntaxhighlight>

===Required Arguments===
*'''fX:''' The X position of the collision rectangle's west side
*'''fY:''' The Y position of the collision rectangle's south side
*'''fWidth:''' The collision rectangle's width
*'''fHeight:''' The collision rectangle's height

===Returns===
Returns a [[colshape]] element if successful, ''false'' if invalid arguments were passed to the function.

==Example==
<section name="Server" class="server" show="true">
This example displays a chat message when a player enters the colshape and allows the colshape to be created using a console function ''set_zone''.
<syntaxhighlight lang="lua">
theZone = false

function shapeHit ( thePlayer )
outputChatBox ( getPlayerName ( thePlayer ) .. " is in the zone!" ) -- display a message in everyone's chat box
end

function setZone ( playerSource, commandName, fX, fY )
if ( fY and fX ) then -- check we've got the 2 args we need
local tempCol = createColRectangle ( fX, fY, 10.0, 10.0 ) -- create a col
if ( tempCol == false ) then -- did the col get created successfully?
outputConsole ( "Syntax is: set_zone <X> <Y>" ) -- inform the user what the valid syntax is
else
if ( theZone ~= false ) then -- did we already have a zone?
destroyElement ( theZone ) -- if so, destroy it
else
addEventHandler ( "onColShapeHit", theZone, shapeHit ) -- add a handler for the onColShapeHit event
end
theZone = tempCol -- and store the new zone we've made
outputChatBox ( "Zone has moved!" ) -- and tell everyone
end
end
end
addCommandHandler ( "set_zone", setZone ) -- add a console function called set_zone that will trigger the function setZone
</syntaxhighlight>
</section>

==See Also==
{{Collision shape functions}}

IsMTAWindowActive

2011-01-30T21:22:23Z

MaddDogg: typo

__NOTOC__
{{Client function}}
This function returns whether any system windows that take focus are active. This includes the chatbox input, console window, main menu and transferbox.
To get the status of the debug view, see [[isDebugViewActive]].

==Syntax==
<syntaxhighlight lang="lua">
bool isMTAWindowActive ()
</syntaxhighlight>

===Returns===
Returns ''true'' if the focus is on the MTA window, ''false'' if it isn't.

==Example==
<section name="Client" class="client" show="true">
This function kill a player if it comes out in the standard menu MTA
<syntaxhighlight lang="lua">
function dontAllowAnyOpenWindow ()
if isMTAWindowActive () then
setElementHealth ( thePlayer, 0.0 )
end
end
setTimer ( dontAllowAnyOpenWindow, 50, 0 )
</syntaxhighlight>
</section>
==See Also==
{{GUI_functions}}

User:MaddDogg

2011-01-23T16:22:46Z

MaddDogg:

Hi!<br>
<br>
<br>
'''Los Santos Stories - Real Life and Role Play Server Project'''<br>
http://www.ls-stories.com

User:MaddDogg

2011-01-23T16:22:28Z

MaddDogg:

Hi!<br>
<br>
<br>
'''Los Santos Stories - Real Life and Role Play Server Project'''<br>
[http://www.ls-stories.com]

User:MaddDogg

2011-01-23T16:22:11Z

MaddDogg:

Hi!<br>
<br>
<br>
'''Los Santos Stories - Real Life and Role Play Server Project'''<br>
[www.ls-stories.com]

User:MaddDogg

2011-01-23T16:21:38Z

MaddDogg: Created page with "Hi! Los Santos Stories - Real Life and Role Play Server Project www.ls-stories.com"

Hi!

Los Santos Stories - Real Life and Role Play Server Project
www.ls-stories.com

OnClientPedWasted

2011-01-23T16:01:34Z

MaddDogg: added info about death reasons

__NOTOC__
{{Client event}}

This event is triggered whenever a ped dies.

==Parameters==
<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart
</syntaxhighlight>

*'''killer''': A [[player]] [[element]] representing the killer.
*'''weapon''': An integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': An integer representing the bodypart the player was damaged.
{{BodyParts}}

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that died.

==Example==

==See Also==
===Client ped events===
{{Client_ped_events}}
===Client event functions===
{{Client_event_functions}}

OnClientPlayerWasted

2011-01-23T16:01:15Z

MaddDogg: added info about death reasons

__NOTOC__
{{Client event}}
This event is triggered whenever a player, including those remote, dies.

==Parameters==
<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart
</syntaxhighlight>

*'''killer''': A [[player]] [[element]] representing the killer.
*'''weapon''': An integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': An integer representing the bodypart the player was damaged.
{{BodyParts}}

==Source==
The [[event system#Event source|source]] of this event is the [[player]] that died.

==Example==
This example outputs a mocking message when the local player dies.
<syntaxhighlight lang="lua">
messages = {
"Better luck next time",
"Don't think you're so cool now, do you?",
"Nice one, pal",
"Your opinion is void"
}

function wastedMessage ( killer, weapon, bodypart )
local randomID = math.random ( 1, #messages ) --get a random ID from the table
local randomMessage = messages[randomID] --use that to retrieve a message
outputChatBox ( randomMessage, 255, 0, 0 ) --output the message
end
addEventHandler ( "onClientPlayerWasted", getLocalPlayer(), wastedMessage ) --add an event for the local player only
</syntaxhighlight>

==See Also==
===Client player events===
{{Client_player_events}}
===Client event functions===
{{Client_event_functions}}

OnPedWasted

2011-01-23T16:00:40Z

MaddDogg: added info about death reasons

__NOTOC__
{{Server event}}
This event is triggered when a ped is killed or dies.

==Parameters==
<syntaxhighlight lang="lua">int totalAmmo, element killer, int killerWeapon, int bodypart [, bool stealth ]
</syntaxhighlight>

*'''totalAmmo''': an integer representing the total ammo the victim had when he died.
*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''.
*'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died.
{{BodyParts}}
*'''stealth''': boolean value representing whether or not this was a stealth kill

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that died or got killed.

==Example==
<syntaxhighlight lang="lua">
-- TODO
</syntaxhighlight>

==See Also==
{{Ped_events}}

OnPlayerWasted

2011-01-23T16:00:04Z

MaddDogg: added info about death reasons

__NOTOC__
{{Server event}}
This event is triggered when a player is killed or dies.

==Parameters==
{{New feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart [, bool stealth ]
</syntaxhighlight>}}

{{Deprecated_feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart
</syntaxhighlight>}}

*'''totalAmmo''': an integer representing the total ammo the victim had when he died.
*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''.
*'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died.
{{BodyParts}}
*{{New feature|3|1.0|'''stealth''': boolean value representing whether or not this was a stealth kill}}

==Source==
The [[event system#Event source|source]] of this event is the [[player]] that died or got killed.

==Example==
This example prints the killer and bodypart to the chat when a player dies.
<syntaxhighlight lang="lua">
-- register player_Wasted as a handler for onPlayerWasted
function player_Wasted ( ammo, attacker, weapon, bodypart )
-- if there was an attacker
if ( attacker ) then
-- we declare our variable outside the following checks
local tempString
-- if the element that killed him was a player,
if ( getElementType ( attacker ) == "player" ) then
-- put the attacker, victim and weapon info in the string
tempString = getPlayerName ( attacker ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
-- else, if it was a vehicle,
elseif ( getElementType ( attacker ) == "vehicle" ) then
-- we'll get the name from the attacker vehicle's driver
local tempString = getPlayerName ( getVehicleController ( attacker ) ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
end
-- if the victim was shot in the head, append a special message
if ( bodypart == 9 ) then
tempString = tempString.." (HEADSHOT!)"
-- else, just append the bodypart name
else
tempString = tempString.." ("..getBodyPartName ( bodypart )..")"
end
-- display the message
outputChatBox ( tempString )
-- if there was no attacker,
else
-- output a death message without attacker info
outputChatBox ( getPlayerName ( source ).." died. ("..getWeaponNameFromID ( weapon )..") ("..getBodyPartName ( bodypart )..")" )
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), player_Wasted )
</syntaxhighlight>

And another example, this will spawn you in the middle of GTA SA world (x=0, y=0, z=3) after 2 seconds of your death
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerWasted", getRootElement( ),
function()
setTimer( spawnPlayer, 2000, 1, source, 0, 0, 3 )
end
)
</syntaxhighlight>

{{See also/Server event|Player events}}

Damage Types

2011-01-23T15:57:26Z

MaddDogg: added info about heli blades

The following death reasons are used by event like onPlayerWasted for the killerWeapon argument to describe the reason, why a ped died.<br>
When a player was shot by a weapon, the respective weapon ID is the death reason ID. The weapon IDs can be found [[Weapons|here]].
<br>
<br>
:{|border="1" cellpadding="4" cellspacing="0" align="left"
|-
!style="background:#afafaf;"|ID
!style="background:#afafaf;"|Death reason
!style="background:#afafaf;"|Additional info
|-
!19
|Rocket
|Actual death reason / weapon ID when dying from a rocket launcher
|-
!37
|Burnt
|This is used by a death by fire, even when the fire is created by a rocket explosion or a molotov
|-
!49
|Rammed
|
|-
!50
|Ranover
|This is also called when dying because of helicopter blades
|-
!51
|Explosion
|This may sometimes also be used at an indirect death through an exploding rocket
|-
!52
|Driveby
|This is NOT used for a driveby kill with e.g. the 'realdriveby' resource
|-
!53
|Drowned
|
|-
!54
|Fall
|
|-
!55
|Unknown
|No known information about this death reason
|-
!56
|Melee
|Seems to be never called (?); for an actual melee death, the fist weapon ID (0) is used (see [[Weapons|here]])
|-
!57
|Weapon
|Seems to be never called (?)
|-
!58
|Flare
|Purpose unknown
|-
!59
|Tank Grenade
|
|}

Id

2011-01-23T15:56:57Z

MaddDogg: added death reasons page

'''Note: this page needs to link functions they apply to'''

ID stands for identification. It is a whole-number integer that refers to many mechanics of San Andreas.
----
Game elements using IDs:
''Note: does not include small ID lists related to specific functions or IDs created by MTA''
*[[Animations|Animations]]
*[[Character Skins]]
*[[CJ_Clothes|Clothing styles]]
*[[Death Reasons]]
*[[Garage|Garage IDs]]
*[[Interior IDs]]
*[[Material IDs]]
*[[Projectiles]]
*[[Radar Blips]]
*[[Sounds]]
*[[Vehicle IDs]]
*[[Vehicle Colors]]
*[[Vehicle Upgrades]]
*[[Weapons|Weapons]]
*[[Weather]] ''Note: blended weather allows for many more undocumented effects''

==See Also==
*[[Vending|List of San Andreas Vending machine locations]]
*[[IDE_List|San Andreas IDE List]]
{{IDs}}
'''Credit for information contained in the pages:'''
Ransom (initial creation, formatting, and all lists not credited to others) eAi (vehicle colors list) erorr404/Talidan/Brophy (sound list) Talidan (radar blip pictures/vehicle list) Hellfish (skin pictures [http://www.gtaforums.com/index.php?showtopic=205220 SOURCE]) Brophy/Ratt/Panther/Twig (lots of inital ID data) GTAForums (Allowing Ransom to find IDs for lists)

Damage Types

2011-01-23T15:54:28Z

MaddDogg: Created page with "The following death reasons are used by event like onPlayerWasted for the killerWeapon argument to describe the reason, why a ped died.<br> When a player was shot by a weapon, th..."

The following death reasons are used by event like onPlayerWasted for the killerWeapon argument to describe the reason, why a ped died.<br>
When a player was shot by a weapon, the respective weapon ID is the death reason ID. The weapon IDs can be found [[Weapons|here]].
<br>
<br>
:{|border="1" cellpadding="4" cellspacing="0" align="left"
|-
!style="background:#afafaf;"|ID
!style="background:#afafaf;"|Death reason
!style="background:#afafaf;"|Additional info
|-
!19
|Rocket
|Actual death reason / weapon ID when dying from a rocket launcher
|-
!37
|Burnt
|This is used by a death by fire, even when the fire is created by a rocket explosion or a molotov
|-
!49
|Rammed
|
|-
!50
|Ranover
|
|-
!51
|Explosion
|This may sometimes also be used at an indirect death through an exploding rocket
|-
!52
|Driveby
|This is NOT used for a driveby kill with e.g. the 'realdriveby' resource
|-
!53
|Drowned
|
|-
!54
|Fall
|
|-
!55
|Unknown
|No known information about this death reason
|-
!56
|Melee
|Seems to be never called (?); for an actual melee death, the fist weapon ID (0) is used (see [[Weapons|here]])
|-
!57
|Weapon
|Seems to be never called (?)
|-
!58
|Flare
|Purpose unknown
|-
!59
|Tank Grenade
|
|}

Weapons

2011-01-23T15:18:25Z

MaddDogg: Edited info about death reasons

'''Scripting functions that ask for a weapon ID need an integer that refers to the GTASA weapon ID list. They are listed below.'''
<br>
*''NOTES:
**''Clip size () denotes clip size when the weapon is dual wielded. Weapons without this specification are not dual wield weapons.''
**''GTASA [[Weapon_skill_levels|weapon stats]] will affect movement, accuracy, damage, and dual wield capability. See [[SetPedStat]] to change these stats. The MTA server comes with a resource called "defaultStats"
that sets GTASA weapon stats to 999. See the weapon stats link for more info.''
**''For death reasons, especially in event handlers for onPlayerWasted or similar, also have a look at the [[Death_Reasons]].
<br>
{|border="1" cellpadding="1" cellspacing="0" align="center"
|-
| style="background:#afafaf;"|
! scope="col" style="background:#afafaf;"| Weapon
! scope="col" style="background:#afafaf;"| ID
! scope="col" style="background:#afafaf;"| Clip
! scope="col" style="background:#afafaf;"| Model ID
| style="background:#afafaf;"|
! scope="col" style="background:#afafaf;"| Weapon
! scope="col" style="background:#afafaf;"| ID
! scope="col" style="background:#afafaf;"| Clip
! scope="col" style="background:#afafaf;"| Model ID
|-
! scope="row" style="background:#cfcfcf;"| Slot 0: No Weapon
|style="background:#cfcfcf;"|Fist
|style="background:#cfcfcf;"|0
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|
! scope="row" style="background:#cfcfcf;"| Slot 6: Rifles
|style="background:#cfcfcf;"|Country Rifle
|style="background:#cfcfcf;"|33
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|357
|-
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Brass Knuckles
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|331
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Sniper Rifle
|style="background:#cfcfcf;"|34
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|358
|-
! scope="row" style="background:#efefef;"| Slot 1: Melee
|style="background:#efefef;"|Golf Club
|style="background:#efefef;"|2
|style="background:#efefef;"|
|style="background:#efefef;"|333
! scope="row" style="background:#efefef;"| Slot 7: Heavy Weapons
|style="background:#efefef;"|Rocket Launcher
|style="background:#efefef;"|35
|style="background:#efefef;"|1
|style="background:#efefef;"|359
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Nightstick
|style="background:#efefef;"|3
|style="background:#efefef;"|
|style="background:#efefef;"|334
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Heat-Seeking RPG
|style="background:#efefef;"|36
|style="background:#efefef;"|1
|style="background:#efefef;"|360
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Knife
|style="background:#efefef;"|4
|style="background:#efefef;"|
|style="background:#efefef;"|335
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Flamethrower
|style="background:#efefef;"|37
|style="background:#efefef;"|50
|style="background:#efefef;"|361
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Baseball Bat
|style="background:#efefef;"|5
|style="background:#efefef;"|
|style="background:#efefef;"|336
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Minigun
|style="background:#efefef;"|38
|style="background:#efefef;"|500
|style="background:#efefef;"|362
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Shovel
|style="background:#efefef;"|6
|style="background:#efefef;"|
|style="background:#efefef;"|337
! scope="row" style="background:#cfcfcf;"| Slot 8: Projectiles
|style="background:#cfcfcf;"|Grenade
|style="background:#cfcfcf;"|16
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|342
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Pool Cue
|style="background:#efefef;"|7
|style="background:#efefef;"|
|style="background:#efefef;"|338
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Tear Gas
|style="background:#cfcfcf;"|17
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|343
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Katana
|style="background:#efefef;"|8
|style="background:#efefef;"|
|style="background:#efefef;"|339
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Molotov Cocktails
|style="background:#cfcfcf;"|18
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|344
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Chainsaw
|style="background:#efefef;"|9
|style="background:#efefef;"|
|style="background:#efefef;"|341
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Satchel Charges
|style="background:#cfcfcf;"|39
|style="background:#cfcfcf;"|1
|style="background:#cfcfcf;"|363
|-
! scope="row" style="background:#cfcfcf;"| Slot 2: Handguns
|style="background:#cfcfcf;"|Pistol
|style="background:#cfcfcf;"|22
|style="background:#cfcfcf;"|17 (34)
|style="background:#cfcfcf;"|346
! scope="row" style="background:#efefef;"| Slot 9: Special 1
|style="background:#efefef;"|Spraycan
|style="background:#efefef;"|41
|style="background:#efefef;"|500
|style="background:#efefef;"|365
|-
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Silenced Pistol
|style="background:#cfcfcf;"|23
|style="background:#cfcfcf;"|17
|style="background:#cfcfcf;"|347
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Fire Extinguisher
|style="background:#efefef;"|42
|style="background:#efefef;"|500
|style="background:#efefef;"|366
|-
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Desert Eagle
|style="background:#cfcfcf;"|24
|style="background:#cfcfcf;"|7
|style="background:#cfcfcf;"|348
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Camera
|style="background:#efefef;"|43
|style="background:#efefef;"|36
|style="background:#efefef;"|367
|-
! scope="row" style="background:#efefef;"| Slot 3: Shotguns
|style="background:#efefef;"|Shotgun
|style="background:#efefef;"|25
|style="background:#efefef;"|1
|style="background:#efefef;"|349
! scope="row" style="background:#cfcfcf;"| Slot 10: Gifts/Other
|style="background:#cfcfcf;"|Long Purple Dildo
|style="background:#cfcfcf;"|10
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|321
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Sawn-Off Shotgun
|style="background:#efefef;"|26
|style="background:#efefef;"|2 (4)
|style="background:#efefef;"|350
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Short tan Dildo
|style="background:#cfcfcf;"|11
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|322
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|SPAZ-12 Combat Shotgun
|style="background:#efefef;"|27
|style="background:#efefef;"|7
|style="background:#efefef;"|351
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Vibrator
|style="background:#cfcfcf;"|12
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|323
|-
! scope="row" style="background:#cfcfcf;"| Slot 4: Sub-Machine Guns
|style="background:#cfcfcf;"|Uzi
|style="background:#cfcfcf;"|28
|style="background:#cfcfcf;"|50 (100)
|style="background:#cfcfcf;"|352
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Flowers
|style="background:#cfcfcf;"|14
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|325
|-
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|MP5
|style="background:#cfcfcf;"|29
|style="background:#cfcfcf;"|30
|style="background:#cfcfcf;"|353
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|Cane
|style="background:#cfcfcf;"|15
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|326
|-
! scope="row" style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|TEC-9
|style="background:#cfcfcf;"|32
|style="background:#cfcfcf;"|50 (100)
|style="background:#cfcfcf;"|372
! scope="row" style="background:#efefef;"| Slot 11: Special 2
|style="background:#efefef;"|Night-Vision Goggles
|style="background:#efefef;"|44
|style="background:#efefef;"|
|style="background:#efefef;"|368
|-
! scope="row" style="background:#efefef;"| Slot 5: Assault Rifles
|style="background:#efefef;"|AK-47
|style="background:#efefef;"|30
|style="background:#efefef;"|30
|style="background:#efefef;"|355
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Infrared Goggles
|style="background:#efefef;"|45
|style="background:#efefef;"|
|style="background:#efefef;"|369
|-
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|M4
|style="background:#efefef;"|31
|style="background:#efefef;"|50
|style="background:#efefef;"|356
! scope="row" style="background:#efefef;"|
|style="background:#efefef;"|Parachute
|style="background:#efefef;"|46
|style="background:#efefef;"|
|style="background:#efefef;"|371
|-
! scope="row" colspan="5" style="background:#efefef;"|
! scope="row" style="background:#cfcfcf;"| Slot 12: Satchel Detonator
|style="background:#cfcfcf;"|Satchel Detonator
|style="background:#cfcfcf;"|40
|style="background:#cfcfcf;"|
|style="background:#cfcfcf;"|364
|}