Multi Theft Auto: Wiki - User contributions [en]

OnVehicleWeaponFire

2010-08-09T16:29:30Z

ArranTuna: /* Parameters */

{{Useful Function}}
__NOTOC__
This '''event''' is triggered when a player in a vehicle fires a vehicles weapon. A list of vehicles that have weapons are listed below:

* Hydra - Fighter Jet (ID: 520)
* Hunter - Assault Helicopter (ID: 425)
* Rustler - World War 2 style fighter (ID: 476)
* Predator - Police Boat with side guns (ID: 430)
* Rhino - Heavily armoured tank (ID: 432)
* Firetruck - Firetruck with sprayable hose (ID: 407)
* RC Baron - A mini fighter (ID: 464)

==Parameters==
<syntaxhighlight lang="lua">string vehicleFireType, int vehicleModel</syntaxhighlight>

* vehicleFireType: this will be "primary" or "secondary" depending on which player the button pressed.
* vehicleModel: the model number the player is in when they triggered the event.

==Source==
The source of this event is the player who fired the vehicles gun(s).

==Code==
<section name="Clientside Script" class="client" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(getLocalPlayer()))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", getLocalPlayer(), vehicleFireType, vehModel)
end
end
bindKey("vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey("vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
</syntaxhighlight>
</section>
<section name="Serverside Script" class="server" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(thePresser, key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(thePresser))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", thePresser, vehicleFireType, vehModel)
end
end

function bindOnJoin()
bindKey(source, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(source, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
addEventHandler("onPlayerJoin", root, bindOnJoin)

function bindOnStart()
for index, thePlayer in pairs(getElementsByType("player")) do
bindKey(thePlayer, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(thePlayer, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
end
addEventHandler("onResourceStart", getResourceRootElement(), bindOnStart)
</syntaxhighlight>
</section>

==Example Code==
<section name="Clientside Example" class="client" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(getLocalPlayer()))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", getLocalPlayer(), vehicleFireType, vehModel)
end
end
bindKey("vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey("vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")

function eventVehicleFire(typeOfFire, theModel)
outputChatBox(getPlayerName(source).." fired his "..getVehicleNameFromModel(theModel).."'s weapon ("..typeOfFire..")")
end
addEvent("onVehicleWeaponFire", false)
addEventHandler("onVehicleWeaponFire", getLocalPlayer(), eventVehicleFire)
</syntaxhighlight>
</section>
<section name="Serverside Example" class="server" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(thePresser, key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(thePresser))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", thePresser, vehicleFireType, vehModel)
end
end

function bindOnJoin()
bindKey(source, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(source, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
addEventHandler("onPlayerJoin", root, bindOnJoin)

function bindOnStart()
for index, thePlayer in pairs(getElementsByType("player")) do
bindKey(thePlayer, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(thePlayer, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
end
addEventHandler("onResourceStart", getResourceRootElement(), bindOnStart)

function eventVehicleFire(typeOfFire, theModel)
outputChatBox(getPlayerName(source).." fired his "..getVehicleNameFromModel(theModel).."'s weapon ("..typeOfFire..")", root, 0, 255, 0)
end
addEvent("onVehicleWeaponFire", false)
addEventHandler("onVehicleWeaponFire", root, eventVehicleFire)
</section>

'''Author: Tuna'''

==See Also==
{{Useful_Functions}}

OnVehicleWeaponFire

2010-08-09T16:22:31Z

ArranTuna: Created page with '{{Useful Function}} __NOTOC__ This '''event''' is triggered when a player in a vehicle fires a vehicles weapon. A list of vehicles that have weapons are listed below: * Hydra - …'

{{Useful Function}}
__NOTOC__
This '''event''' is triggered when a player in a vehicle fires a vehicles weapon. A list of vehicles that have weapons are listed below:

* Hydra - Fighter Jet (ID: 520)
* Hunter - Assault Helicopter (ID: 425)
* Rustler - World War 2 style fighter (ID: 476)
* Predator - Police Boat with side guns (ID: 430)
* Rhino - Heavily armoured tank (ID: 432)
* Firetruck - Firetruck with sprayable hose (ID: 407)
* RC Baron - A mini fighter (ID: 464)

==Parameters==
<syntaxhighlight lang="lua">string vehicleFireType, int vehicleModel</syntaxhighlight>

==Source==
The source of this event is the player who fired the vehicles gun(s).

==Code==
<section name="Clientside Script" class="client" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(getLocalPlayer()))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", getLocalPlayer(), vehicleFireType, vehModel)
end
end
bindKey("vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey("vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
</syntaxhighlight>
</section>
<section name="Serverside Script" class="server" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(thePresser, key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(thePresser))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", thePresser, vehicleFireType, vehModel)
end
end

function bindOnJoin()
bindKey(source, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(source, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
addEventHandler("onPlayerJoin", root, bindOnJoin)

function bindOnStart()
for index, thePlayer in pairs(getElementsByType("player")) do
bindKey(thePlayer, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(thePlayer, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
end
addEventHandler("onResourceStart", getResourceRootElement(), bindOnStart)
</syntaxhighlight>
</section>

==Example Code==
<section name="Clientside Example" class="client" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(getLocalPlayer()))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", getLocalPlayer(), vehicleFireType, vehModel)
end
end
bindKey("vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey("vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")

function eventVehicleFire(typeOfFire, theModel)
outputChatBox(getPlayerName(source).." fired his "..getVehicleNameFromModel(theModel).."'s weapon ("..typeOfFire..")")
end
addEvent("onVehicleWeaponFire", false)
addEventHandler("onVehicleWeaponFire", getLocalPlayer(), eventVehicleFire)
</syntaxhighlight>
</section>
<section name="Serverside Example" class="server" show="true">
<syntaxhighlight lang="lua">
armedVehicles = {[425]=true, [520]=true, [476]=true, [447]=true, [340]=true, [432]=true, [464]=true, [407]=true}
function vehicleWeaponFire(thePresser, key, keyState, vehicleFireType)
local vehModel = getElementModel(getPedOccupiedVehicle(thePresser))
if (armedVehicles[vehModel]) then
triggerEvent("onVehicleWeaponFire", thePresser, vehicleFireType, vehModel)
end
end

function bindOnJoin()
bindKey(source, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(source, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
addEventHandler("onPlayerJoin", root, bindOnJoin)

function bindOnStart()
for index, thePlayer in pairs(getElementsByType("player")) do
bindKey(thePlayer, "vehicle_fire", "down", vehicleWeaponFire, "primary")
bindKey(thePlayer, "vehicle_secondary_fire", "down", vehicleWeaponFire, "secondary")
end
end
addEventHandler("onResourceStart", getResourceRootElement(), bindOnStart)

function eventVehicleFire(typeOfFire, theModel)
outputChatBox(getPlayerName(source).." fired his "..getVehicleNameFromModel(theModel).."'s weapon ("..typeOfFire..")", root, 0, 255, 0)
end
addEvent("onVehicleWeaponFire", false)
addEventHandler("onVehicleWeaponFire", root, eventVehicleFire)
</section>

'''Author: Tuna'''

==See Also==
{{Useful_Functions}}

Boolean

2010-08-09T09:43:50Z

ArranTuna:

A ''boolean'' or ''bool'' is a datatype whose value can be either ''true'' or ''false''. These are often returned by functions to indicate whether the operation was successful or not.

Using the lua functions tostring() and type() can help you to find out what datatype something is:
<syntaxhighlight lang="lua">
local theReturn = isPedDead(getRandomPlayer())
outputChatBox("The reurn was: "..tostring(theReturn)) -- Will say: "true" or "false"
outputChatBox("The datatype of this return was: "..type(theReturn)) -- Will say "boolean"
</syntaxhighlight>
[[Category:Scripting Concepts]]

[[ru:Boolean]]

AclGetRight

2010-08-09T09:35:57Z

ArranTuna:

__NOTOC__
{{Server function}}

This function returns whether the access for the given right is set to true or false in the ACL.

==Syntax==

<syntaxhighlight lang="lua">
bool aclGetRight ( acl theAcl, string rightName )
</syntaxhighlight>

===Required Arguments===

*'''theAcl:''' The ACL to get the right from
*'''rightName:''' The right name to return the access value of.

===Returns===

Returns ''true'' or ''false'' if the ACL gives access or not to the given function. Returns ''nil'' if it failed for some reason, e.g. an invalid ACL was specified or the right specified does not exist in the ACL.

==Example==
This example lets players check if an ACL group has access to something or not.
<syntaxhighlight lang="lua">
--theACL examples: Admin, Default, Moderator
--theRight examples: command.debugscript, function.banPlayer

function aclRightCheck(player, command, theACL, theRight)
if (theACL and theRight) then -- Make sure atleast two arguments were entered.
local theACL = aclGet(theACL) -- If theACL exists then convert it into an ACL pointer from a string.
if (theACL) then -- If the ACL was found.
local theReturn = aclGetRight(theACL, theRight) -- Will return true if it was found in the ACL.
outputChatBox("The ACL right was found and returned: "..tostring(theReturn), player, 0, 255, 0)
else
outputChatBox("The ACL you entered was not found to exist in the ACL file.", player, 255, 0, 0) -- When the ACL was not found.
end
else
outputChatBox("You need to enter an ACL, and a right name.", player, 255, 0, 0) -- When 2 arguements weren't entered.
end
end
addCommandHandler("aclgetright", aclRightCheck) -- When a player does the aclgetright command it calls aclRightCheck function above.
-- Example of use: /aclgetright Admin command.debugscript (this should return true)
-- Example of use: /aclgetright Default command.debugscript (this should return false)
</syntaxhighlight>

==See Also==

{{ACL_functions}}

GetTimerDetails

2010-08-08T21:29:10Z

ArranTuna: /* Returns */

__NOTOC__
{{Server client function}}

This function is for getting the details of a running timer.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int getTimerDetails ( timer theTimer )
</syntaxhighlight>

===Required Arguments===
*'''theTimer:''' A timer element.

===Returns===
* Integer one represents the time left in miliseconds (1000th of a second) of the current time left in the loop.
* Integer two represents the ammount of times the timer has left to execute.
* Integer three represents the ammount of times the timer will execute.

* Returns false if the timer doesn't exist or stopped running. Also, debugscript will say "Bad Arguement @ 'getTimerDetails'" to prevent this you can check if the timer exists with [[isTimer]]().

==Example==
This example creates a 1 second (1000 ms) timer that will run 1000 times, and you can see the timer details by using the command: timerdetails.
<syntaxhighlight lang="lua">
theTimer = setTimer(function() end, 1000, 10) -- A timer that does nothing.

function timerDetails()
remaining, executesRemaining, totalExecutes = getTimerDetails(theTimer) -- Get the timers details
if (remaining and executesRemaining and totalExecutes) then
outputChatBox("Time remaining this second: "..remaining.." Executes remaining: "..executesRemaining.." Total executes: "..totalExecutes)
else
outputChatBox("Timer no longer exists")
end
end
addCommandHandler("timerdetails", timerDetails)
</syntaxhighlight>

User:ArranTuna

2010-08-08T21:16:21Z

ArranTuna:

== Yo. ==

ArranTuna == Tuna

File:Skin265.jpg

2010-08-08T18:33:23Z

ArranTuna: uploaded a new version of "File:Skin265.jpg": Changed the size of this image yet again in attempt to make it look more equal sized with the others.

Skin ID 265

Special Skins Page

2010-08-08T14:25:17Z

ArranTuna:

'''These skins are available for use in MTA 1.1 or higher.'''

'''1 '''[[Image:Skin1.jpg]]
'''2 '''[[Image:Skin2.jpg]]
'''265 '''[[Image:Skin265.jpg]]
'''266 '''[[Image:Skin266.jpg]]
'''267 '''[[Image:Skin267.jpg]]
'''268 '''[[Image:Skin268.jpg]]

'''269 '''[[Image:Skin269.jpg]]
'''270 '''[[Image:Skin270.jpg]]
'''271 '''[[Image:Skin271.jpg]]
'''272 '''[[Image:Skin272.jpg]]
'''290 '''[[Image:Skin290.jpg]]
'''291 '''[[Image:Skin291.jpg]]

'''292 '''[[Image:Skin292.jpg]]
'''293 '''[[Image:Skin293.jpg]]
'''294 '''[[Image:Skin294.jpg]]
'''295 '''[[Image:Skin295.jpg]]
'''296 '''[[Image:Skin296.jpg]]
'''297 '''[[Image:Skin297.jpg]]

'''298 '''[[Image:Skin298.jpg]]
'''299 '''[[Image:Skin299.jpg]]
'''300 '''[[Image:Skin271.jpg]] 
'''301 '''[[Image:Skin301.jpg]]
'''302 '''[[Image:Skin302.jpg]]
'''303 '''[[Image:Skin303.jpg]]

'''304 '''[[Image:Skin304.jpg]]
'''305 '''[[Image:Skin305.jpg]]
'''306 '''[[Image:Skin306.jpg]]
'''307 '''[[Image:Skin307.jpg]]
'''308 '''[[Image:Skin308.jpg]]
'''309 '''[[Image:Skin309.jpg]]

'''310 '''[[Image:Skin310.jpg]]
'''311 '''[[Image:Skin311.jpg]]
'''312 '''[[Image:Skin312.jpg]]

==Notes:==
Ryder skin ID 271 and skin ID 300 are identical.

Special Skins Page

2010-08-08T14:23:35Z

ArranTuna:

'''These skins are available for use in MTA 1.1 or higher.'''

'''1 '''[[Image:Skin1.jpg]]
'''2 '''[[Image:Skin2.jpg]]
'''265 '''[[Image:Skin265.jpg]]
'''266 '''[[Image:Skin266.jpg]]
'''267 '''[[Image:Skin267.jpg]]
'''268 '''[[Image:Skin268.jpg]]

'''269 '''[[Image:Skin269.jpg]]
'''270 '''[[Image:Skin270.jpg]]
'''271 '''[[Image:Skin271.jpg]]
'''272 '''[[Image:Skin272.jpg]]
'''290 '''[[Image:Skin290.jpg]]
'''291 '''[[Image:Skin291.jpg]]

'''292 '''[[Image:Skin292.jpg]]
'''293 '''[[Image:Skin293.jpg]]
'''294 '''[[Image:Skin294.jpg]]
'''295 '''[[Image:Skin295.jpg]]
'''296 '''[[Image:Skin296.jpg]]
'''297 '''[[Image:Skin297.jpg]]

'''298 '''[[Image:Skin298.jpg]]
'''299 '''[[Image:Skin299.jpg]]
'''300 '''[[Image:Skin271.jpg]] 
'''301 '''[[Image:Skin301.jpg]]
'''302 '''[[Image:Skin302.jpg]]
'''303 '''[[Image:Skin303.jpg]]
'''304 '''[[Image:Skin304.jpg]]

'''305 '''[[Image:Skin305.jpg]]
'''306 '''[[Image:Skin306.jpg]]
'''307 '''[[Image:Skin307.jpg]]
'''308 '''[[Image:Skin308.jpg]]
'''309 '''[[Image:Skin309.jpg]]
'''310 '''[[Image:Skin310.jpg]]

'''311 '''[[Image:Skin311.jpg]]
'''312 '''[[Image:Skin312.jpg]]

GetTimerDetails

2010-08-08T14:08:55Z

ArranTuna:

__NOTOC__
{{Server client function}}

This function is for getting the details of a running timer.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int getTimerDetails ( timer theTimer )
</syntaxhighlight>

===Required Arguments===
*'''theTimer:''' A timer element.

===Returns===
* Integer one represents the time left in miliseconds (1000th of a second) of the current time left in the loop.
* Integer two represents the ammount of times the timer has left to execute.
* Integer three represents the ammount of times the timer will execute.

* Returns false if the timer doesn't exist or stopped running. Also, debugscript is will say "Bad Arguement @ 'getTimerDetails'"

==Example==
This example creates a 1 second (1000 ms) timer that will run 1000 times, and you can see the timer details by using the command: timerdetails.
<syntaxhighlight lang="lua">
theTimer = setTimer(function() end, 1000, 10) -- A timer that does nothing.

function timerDetails()
remaining, executesRemaining, totalExecutes = getTimerDetails(theTimer) -- Get the timers details
if (remaining and executesRemaining and totalExecutes) then
outputChatBox("Time remaining this second: "..remaining.." Executes remaining: "..executesRemaining.." Total executes: "..totalExecutes)
else
outputChatBox("Timer no longer exists")
end
end
addCommandHandler("timerdetails", timerDetails)
</syntaxhighlight>

GetTimerDetails

2010-08-08T14:08:21Z

ArranTuna:

__NOTOC__
{{Server client function}}

This function is for getting the details of a running timer.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int [[getTimerDetails]] ( timer theTimer )
</syntaxhighlight>

===Required Arguments===
*'''theTimer:''' A timer element.

===Returns===
* Integer one represents the time left in miliseconds (1000th of a second) of the current time left in the loop.
* Integer two represents the ammount of times the timer has left to execute.
* Integer three represents the ammount of times the timer will execute.

* Returns false if the timer doesn't exist or stopped running. Also, debugscript is will say "Bad Arguement @ 'getTimerDetails'"

==Example==
This example creates a 1 second (1000 ms) timer that will run 1000 times, and you can see the timer details by using the command: timerdetails.
<syntaxhighlight lang="lua">
theTimer = setTimer(function() end, 1000, 10) -- A timer that does nothing.

function timerDetails()
remaining, executesRemaining, totalExecutes = getTimerDetails(theTimer) -- Get the timers details
if (remaining and executesRemaining and totalExecutes) then
outputChatBox("Time remaining this second: "..remaining.." Executes remaining: "..executesRemaining.." Total executes: "..totalExecutes)
else
outputChatBox("Timer no longer exists")
end
end
addCommandHandler("timerdetails", timerDetails)
</syntaxhighlight>

GetTimerDetails

2010-08-08T14:07:45Z

ArranTuna: Created page with '__NOTOC__ {{Server client function}} This function is for getting the details of a running timer. ==Syntax== <syntaxhighlight lang="lua"> int, int, int getTimerDetails ( timer theTimer ) </…'

__NOTOC__
{{Server client function}}

This function is for getting the details of a running timer.

==Syntax==
<syntaxhighlight lang="lua">
int, int, int getTimerDetails ( timer theTimer )
</syntaxhighlight>

===Required Arguments===
*'''theTimer:''' A timer element.

===Returns===
* Integer one represents the time left in miliseconds (1000th of a second) of the current time left in the loop.
* Integer two represents the ammount of times the timer has left to execute.
* Integer three represents the ammount of times the timer will execute.

* Returns false if the timer doesn't exist or stopped running. Also, debugscript is will say "Bad Arguement @ 'getTimerDetails'"

==Example==
This example creates a 1 second (1000 ms) timer that will run 1000 times, and you can see the timer details by using the command: timerdetails.
<syntaxhighlight lang="lua">
theTimer = setTimer(function() end, 1000, 10) -- A timer that does nothing.

function timerDetails()
remaining, executesRemaining, totalExecutes = getTimerDetails(theTimer) -- Get the timers details
if (remaining and executesRemaining and totalExecutes) then
outputChatBox("Time remaining this second: "..remaining.." Executes remaining: "..executesRemaining.." Total executes: "..totalExecutes)
else
outputChatBox("Timer no longer exists")
end
end
addCommandHandler("timerdetails", timerDetails)
</syntaxhighlight>

FxAddWaterHydrant

2010-08-08T13:30:11Z

ArranTuna:

__NOTOC__
{{Client function}}
[[Image:Fxwaterhydrant.png|thumb|200px|Water hydrant]]
This function creates a water hydrant particle effect.

==Syntax==
<syntaxhighlight lang="lua">
bool fxAddWaterHydrant ( float posX, float posY, float posZ )
</syntaxhighlight>

===Required Arguments===
* '''posX:''' A float representing the '''x''' position of the hydrant
* '''posY:''' A float representing the '''y''' position of the hydrant
* '''posZ:''' A float representing the '''z''' position of the hydrant

===Returns===
Returns a true if the operation was successful, false otherwise.

==Example==
This example will create 20 water hydrant effects around the players position when they use the command: hydrantmania.
<syntaxhighlight lang="lua">
function createHydrants()
local GLP = getLocalPlayer()
local x, y, z = getElementPosition(GLP) -- Get your location.
for i=0, 20 do -- 20 Hydrants.
fxAddWaterHydrant(x + math.random(-5,5), y + math.random(-5,5), z) -- Using math.random, and your current location 20 water hydrants are created.
end
end
addCommandHandler("hydrantmania", createHydrants)
</syntaxhighlight>

==See Also==
{{Client Effects functions}}

ExecuteSQLDropTable

2010-08-08T13:22:23Z

ArranTuna:

__NOTOC__
{{Server function}}
This function drops a table in the registry. This function doesn't do anything when the table doesn't exist.

The executed SQL query is the following:

<syntaxhighlight lang="lua">[sql]DROP TABLE <table></syntaxhighlight>

==Syntax==
<syntaxhighlight lang="lua">
bool executeSQLDropTable ( string tableName )
</syntaxhighlight>

===Required Arguments===
*'''tableName:''' The name of the table you want to drop.

===Returns===
The function returns ''true'' on success, and ''false'' on failure.

===Example===
This example lets you drop an SQL table with the command: dropsqltable. Note: This command should be restricted to admins if you use it.
<syntaxhighlight lang="lua">
function removeSQLTable(thePlayer, command, SQLtable)
if (SQLtable) then -- Make sure the player entered an argument.
success = executeSQLDropTable(SQLtable) -- Drop the table
if (success) then -- If executeSQLDropTable returns true, it passes this if check to display a confirmation message
outputChatBox("SQL Table "..SQLtable.." successfully dropped.", thePlayer, 0, 255, 0)
else
outputChatBox("SQL Table "..SQLtable.." was not successfully dropped.", thePlayer, 255, 0, 0)
end
end
end
addCommandHandler("dropsqltable", removeSQLTable)
</syntaxhighlight>

==See Also==
{{Registry_functions}}

MakePedUseGun

2010-08-08T13:12:27Z

ArranTuna:

__NOTOC__
{{Client function}}
{{Deprecated}}
This function is used to force a ped to use a gun. '''This function does not appear to work,''' to make a ped use a weapon use [[setPedControlState]] instead.

==Syntax==
<syntaxhighlight lang="lua">
bool makePedUseGun ( ped thePed, int useType, element target )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' The [[ped]] you wish to force the use of a gun upon.
*'''useType:''' How the weapon should be used, will accept the following values:
** '''0:''' Do nothing
** '''1:''' Aim weapon
** '''2:''' Fire
** '''3:''' Burst-fire
** '''4:''' Reload
** '''5:''' Pistolwhip (Weapon melee)
** '''6:''' Cancel use
** '''7:''' Cancel use immediately
*'''target:''' An [[element]] referring to the target that the ped will use its weapon against.

===Returns===
Returns ''true'' if the command was successful, false otherwise.

==Example==
This page lacks an example.

==See Also==
{{Client_ped_functions}}

Tocolor

2010-08-08T12:49:43Z

ArranTuna:

__NOTOC__
{{Client function}}
This function retrieves the hex number of a specified color, useful for the dx functions.

==Syntax==
<syntaxhighlight lang="lua">
int tocolor ( int red, int green, int blue [, int alpha = 255] )
</syntaxhighlight>

===Required Arguments===
* '''red:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space red] in the color (0-255).
* '''green:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space green] in the color (0-255).
* '''blue:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space blue] in the color (0-255).

===Optional Arguments===
* '''alpha:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space alpha] in the color (0-255).

===Returns===
Returns a single value representing the color.

==Example==
This example displays the text "Tuna" in small at the top left side of your screen. The color of this text can be changed using a command.
<syntaxhighlight lang="lua">
-- Make some default colour
R = 255
G = 255
B = 255
A = 255

-- This function draws the text, and the color is decided with tocolor(R, G, B, A)
function drawDX()
dxDrawText("Tuna", 10, 10, 100, 100, tocolor(R, G, B, A), 1)
end
addEventHandler("onClientRender", root, drawDX)
-- This will make some DX text (Tuna) appear at the top left of your screen.

--Now to modify the R, G, B, and A with a command.
function editRGBA(command, red, green, blue, alpha)
if (tonumber(red) and tonumber(green) and tonumber(blue) and tonumber(alpha)) then -- Make sure the user entered all 4 args as numbers.
R = tonumber(red)
G = tonumber(green)
B = tonumber(blue)
A = tonumber(alpha)
-- tonumber() had to be used here else tocolor() didn't display the right color.
outputChatBox("Color of Tuna set to the color of this text, with "..A.." alpha.", R, G, B)
end
end
addCommandHandler("setcoloroftuna", editRGBA) -- setcoloroftuna command.
-- Example /setcoloroftuna 255 0 0 255 - for red.
</syntaxhighlight>

==See Also==
{{Client_utility_functions}}

Tocolor

2010-08-08T12:47:27Z

ArranTuna: /* Example */

Tocolor

2010-08-08T12:46:36Z

ArranTuna: /* Example */

__NOTOC__
{{Client function}}
This function retrieves the hex number of a specified color, useful for the dx functions.

==Syntax==
<syntaxhighlight lang="lua">
int tocolor ( int red, int green, int blue [, int alpha = 255] )
</syntaxhighlight>

===Required Arguments===
* '''red:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space red] in the color (0-255).
* '''green:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space green] in the color (0-255).
* '''blue:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space blue] in the color (0-255).

===Optional Arguments===
* '''alpha:''' The amount of [http://en.wikipedia.org/wiki/RGBA_color_space alpha] in the color (0-255).

===Returns===
Returns a single value representing the color.

==Example==
<syntaxhighlight lang="lua">
-- Make some default colour
R = 255
G = 255
B = 255
A = 255

-- This function draws the text, and the color is decided with tocolor(R, G, B, A)
function drawDX()
dxDrawText("Tuna", 10, 10, 100, 100, tocolor(R, G, B, A), 1)
end
addEventHandler("onClientRender", root, drawDX)
-- This will make some DX text (Tuna) appear at the top left of your screen.

--Now to modify the R, G, B, and A with a command.
function editRGBA(command, red, green, blue, alpha)
if (tonumber(red) and tonumber(green) and tonumber(blue) and tonumber(alpha)) then -- Make sure the user entered all 4 args as numbers.
R = tonumber(red)
G = tonumber(green)
B = tonumber(blue)
A = tonumber(alpha)
-- tonumber() had to be used here else tocolor() didn't display the right color.
outputChatBox("Color of Tuna set to the color of this text, with "..A.." alpha.", R, G, B)
end
end
addCommandHandler("setcoloroftuna", editRGBA) -- setcoloroftuna command.
-- Example /setcoloroftuna 255 0 0 255 - for red.
</syntaxhighlight>

==See Also==
{{Client_utility_functions}}
[[Category:Needs_Example]]

Character Skins

2010-08-08T11:56:17Z

ArranTuna:

Skins that the player may use (pedestrian skins).

*[[All Skins Page]] - Not recommended for slow Internet
*[[Special Skins Page]] - New skins available after MTA 1.1

'''Sectioned Skin Pages:'''
----
*[[Skins Page 1]]: 7, 9-29
*[[Skins Page 2]]: 30-41, 43-52
*[[Skins Page 3]]: 53-64, 66-73, 75-76
*[[Skins Page 4]]: 77-85, 87-99
*[[Skins Page 5]]: 100-118, 120-122
*[[Skins Page 6]]: 123-144
*[[Skins Page 7]]: 145-148, 150-167
*[[Skins Page 8]]: 168-189
*[[Skins Page 9]]: 190-207, 209-212
*[[Skins Page 10]]: 213-234
*[[Skins Page 11]]: 235-238, 240-257
*[[Skins Page 12]]: 258-264, 274-288

==Notes:==
*12 pages: 266 total.

*IDs 1-8 (except 7) are non-functional

*The following pairs of IDs produce same character (1st ID used in lists, 2nd disabled)
**118:119
**148:149

*Non-working IDs
1-6
8
42
65
74
86
119
149
208
239
265-273

==See Also==
[[id|ID Lists]]

[[it:Skin Personaggi]]
[[ru:Character Skins]]

Special Skins Page

2010-08-08T11:54:16Z

ArranTuna: Created page with ''''These skins are available for use in MTA 1.1 or higher.''' '''1 '''Image:Skin1.jpg '''2 '''Image:Skin2.jpg '''265 '''Image:Skin265.jpg '''266 '''[[Image:Skin266.j…'

'''These skins are available for use in MTA 1.1 or higher.'''

'''1 '''[[Image:Skin1.jpg]]
'''2 '''[[Image:Skin2.jpg]]
'''265 '''[[Image:Skin265.jpg]]
'''266 '''[[Image:Skin266.jpg]]
'''267 '''[[Image:Skin267.jpg]]
'''268 '''[[Image:Skin268.jpg]]

'''269 '''[[Image:Skin269.jpg]]
'''270 '''[[Image:Skin270.jpg]]
'''271 '''[[Image:Skin271.jpg]]
'''272 '''[[Image:Skin272.jpg]]
'''290 '''[[Image:Skin290.jpg]]
'''291 '''[[Image:Skin291.jpg]]

'''292 '''[[Image:Skin292.jpg]]
'''293 '''[[Image:Skin293.jpg]]
'''294 '''[[Image:Skin294.jpg]]
'''295 '''[[Image:Skin295.jpg]]
'''296 '''[[Image:Skin296.jpg]]
'''297 '''[[Image:Skin297.jpg]]

'''298 '''[[Image:Skin298.jpg]]
'''299 '''[[Image:Skin299.jpg]]
'''301 '''[[Image:Skin301.jpg]]
'''302 '''[[Image:Skin302.jpg]]
'''303 '''[[Image:Skin303.jpg]]
'''304 '''[[Image:Skin304.jpg]]

'''305 '''[[Image:Skin305.jpg]]
'''306 '''[[Image:Skin306.jpg]]
'''307 '''[[Image:Skin307.jpg]]
'''308 '''[[Image:Skin308.jpg]]
'''309 '''[[Image:Skin309.jpg]]
'''310 '''[[Image:Skin310.jpg]]

'''311 '''[[Image:Skin311.jpg]]
'''312 '''[[Image:Skin312.jpg]]

File:Skin272.jpg

2010-08-08T11:51:44Z

ArranTuna: Skin ID 272

Skin ID 272

File:Skin312.jpg

2010-08-08T11:49:04Z

ArranTuna: Skin ID 312

Skin ID 312

File:Skin311.jpg

2010-08-08T11:47:54Z

ArranTuna: Skin ID 311

Skin ID 311

File:Skin310.jpg

2010-08-08T11:46:41Z

ArranTuna: Skin ID 310

Skin ID 310

File:Skin309.jpg

2010-08-08T11:45:42Z

ArranTuna: Skin ID 309

Skin ID 309

File:Skin308.jpg

2010-08-08T11:44:45Z

ArranTuna: Skin ID 308

Skin ID 308

File:Skin307.jpg

2010-08-08T11:43:15Z

ArranTuna: Skin ID 307

Skin ID 307

File:Skin306.jpg

2010-08-08T11:42:29Z

ArranTuna: Skin ID 306

Skin ID 306

File:Skin305.jpg

2010-08-08T11:41:10Z

ArranTuna: Skin ID 305

Skin ID 305

File:Skin304.jpg

2010-08-08T11:39:58Z

ArranTuna: Skin ID 304

Skin ID 304

File:Skin303.jpg

2010-08-08T11:38:39Z

ArranTuna: Skin ID 303

Skin ID 303

File:Skin302.jpg

2010-08-08T11:37:11Z

ArranTuna: Skin ID 302

Skin ID 302

File:Skin301.jpg

2010-08-08T11:36:14Z

ArranTuna: Skin ID 301

Skin ID 301

File:Skin299.jpg

2010-08-08T11:33:50Z

ArranTuna: Skin ID 299

Skin ID 299

File:Skin298.jpg

2010-08-08T11:32:25Z

ArranTuna: Skin ID 298

Skin ID 298

File:Skin297.jpg

2010-08-08T11:30:48Z

ArranTuna: Skin ID 297

Skin ID 297

File:Skin296.jpg

2010-08-08T11:29:30Z

ArranTuna: Skin ID 296

Skin ID 296

File:Skin295.jpg

2010-08-08T11:28:13Z

ArranTuna: Skin ID 295

Skin ID 295

File:Skin294.jpg

2010-08-08T11:27:00Z

ArranTuna: Skin ID 294

Skin ID 294

File:Skin293.jpg

2010-08-08T11:25:43Z

ArranTuna: Skin ID 293

Skin ID 293

File:Skin292.jpg

2010-08-08T11:23:47Z

ArranTuna: Skin ID 292

Skin ID 292

File:Skin291.jpg

2010-08-08T11:22:28Z

ArranTuna: Skin ID 291

Skin ID 291

File:Skin290.jpg

2010-08-08T11:21:22Z

ArranTuna: Skin ID 290

Skin ID 290

File:Skin271.jpg

2010-08-08T11:18:35Z

ArranTuna: Skin ID 271

Skin ID 271

File:Skin270.jpg

2010-08-08T11:16:41Z

ArranTuna: Skin ID 270

Skin ID 270

File:Skin269.jpg

2010-08-08T11:15:07Z

ArranTuna: Skin ID 269

Skin ID 269

File:Skin265.jpg

2010-08-08T11:12:41Z

ArranTuna: uploaded a new version of "File:Skin265.jpg"

Skin ID 265

File:Skin268.jpg

2010-08-08T11:10:49Z

ArranTuna: Skin ID 268

Skin ID 268

File:Skin267.jpg

2010-08-08T11:08:57Z

ArranTuna: Skin ID 267

Skin ID 267

File:Skin266.jpg

2010-08-08T11:05:00Z

ArranTuna: Skin ID 266

Skin ID 266