Multi Theft Auto: Wiki - User contributions [en]

Resource:Admin

2012-08-22T00:32:05Z

Ken Xeiko:

{{Resource page}}
A quick tutorial on how to get admin rights and install admin resource.

<section name="MTA 1.0.0 and lower" class="server" show="false">
'''Note:''' Since mta 1.0.5 the accounts.xml file has been removed and replaced by sqlite.

At first, open the '''accounts.xml''' file located in '''server\mods\deathmatch\''' and add a line with your account details, like on the following example.

[[Image:admin_accounts.png]]
</section>

To add an account in '''MTA {{padleft:|3|{{Current Version|full}}}}''' use the following command in the server

'''Note:''' The server needs to run for this action
<syntaxhighlight lang="lua">
addaccount <username> <password>
</syntaxhighlight>

'''Note:''' Server should not be running when you are editing the acl file below

Then you open the '''acl.xml''' file located in the same folder and add yourself as an object to the Admin group by using the 'user.*' syntax, where * would be your account name.

[[Image:admin_acl.png]]

Now open your '''mtaserver.conf''' file and scroll to the bottom, make sure the admin resource is added to the ones that start with the server (note: protected="1" means that it can not be stopped).

[[Image:admin_mtaserver.png]]

Now that you're done with server files, you can finally start it. Connect to the server itself and login with your account details: use 'login [username] <password>'. If it tells you to press 'p' you have done everything right, congratulations! If not, do this from the very beginning.
[[Category:Scripting Concepts]]

[[it:Resource:Admin]]
[[ru:Resource:Admin]]

Template:Useful Functions

2012-08-07T14:25:48Z

Ken Xeiko:

*[[callClientFunction]] » This function allows you to call any clientside function from the server's side.

*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.

*[[centerWindow]] » This function center the window in any resolution.

*[[Check]] » This function checks if it's arguments are of the right types and calls the error-function if one isn't.

*[[coroutine.resume]] » Fix for hidden coroutine error messages

*[[dxDrawColorText]] » This function draws a dx text with #RRGGBB color codes support.

*[[findRotation]] » Takes two points and returns the direction from point A to point B.

*[[FormatDate]] » Formats a date on the basis of a format string and returns it.

*[[getAge]] » This function calculates the age of a birthday.

*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.

*[[getCursorMoveOn]] » This function checks in which way the cursor is currently moving.

*[[getElementSpeed]] » This function allows you to get element speed in kph or mph units.

*[[getPlayerFromNamePart]] » This function allows you to get player From his Name part.

*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.

*[[getResourceSettings]] » This function returns a table of the resource settings.

*[[getTimestamp]] » With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].

*[[IfElse]] » Returns one of two values based on a boolean expression.

*[[isLeapYear]] » Checks if the given year is a leap year.

*[[iterElements]] » Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).

*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.

*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicles weapon.

*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.

*[[setElementSpeed]] » This function allows you to set moving element speed in kph or mph units.

*[[setTableProtected]] » Protects a table and makes it read-only.

*[[setVehicleGravityPoint]] » This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.

*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.

*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.

*[[table.copy]] » This function copies a whole table and all the tables in that table.

*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.

*[[table.size]] » Finds the absolute size of a table.

*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used clientside.

*[[var_dump]] »This function outputs information about one or more variables using outputConsole(). 

*[[multi_check]] » This function checks one element to many, handy and clean. 

*[[isElementInPhotograph]] » This function checks if an element was in the player's camera picture. This needs writing still. --[[User:Ransom|Ransom]] 21:45, 2 May 2012 (UTC) 

*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations. 

*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites.

*[[getPlayersInPhotograph]] » This function gets all the players in a photograph.

*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.

*[[dxDrawImage3D]] » This function draws a 3D image.

*[[string.count]] » This function counts a text from a text.

*[[getOnlineAdmins]] » This function will give the online admins.

*[[dxGetFontSizeFromHeight]] » This function calculate a font size from given height for dxDraw.

*[[isElementInRange]] » This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
[[Category:Useful Functions]]

Template:Useful Functions

2012-08-07T14:25:19Z

Ken Xeiko:

*[[callClientFunction]] » This function allows you to call any clientside function from the server's side.

*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.

*[[centerWindow]] » This function center the window in any resolution.

*[[Check]] » This function checks if it's arguments are of the right types and calls the error-function if one isn't.

*[[coroutine.resume]] » Fix for hidden coroutine error messages

*[[dxDrawColorText]] » This function draws a dx text with #RRGGBB color codes support.

*[[findRotation]] » Takes two points and returns the direction from point A to point B.

*[[FormatDate]] » Formats a date on the basis of a format string and returns it.

*[[getAge]] » This function calculates the age of a birthday.

*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.

*[[getCursorMoveOn]] » This function checks in which way the cursor is currently moving.

*[[getElementSpeed]] » This function allows you to get element speed in kph or mph units.

*[[getPlayerFromNamePart]] » This function allows you to get player From his Name part.

*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.

*[[getResourceSettings]] » This function returns a table of the resource settings.

*[[getTimestamp]] » With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].

*[[IfElse]] » Returns one of two values based on a boolean expression.

*[[isLeapYear]] » Checks if the given year is a leap year.

*[[iterElements]] » Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).

*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.

*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicles weapon.

*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.

*[[setElementSpeed]] » This function allows you to set moving element speed in kph or mph units.

*[[setTableProtected]] » Protects a table and makes it read-only.

*[[setVehicleGravityPoint]] » This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.

*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.

*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.

*[[table.copy]] » This function copies a whole table and all the tables in that table.

*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.

*[[table.size]] » Finds the absolute size of a table.

*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used clientside.

*[[var_dump]] »This function outputs information about one or more variables using outputConsole(). 

*[[multi_check]] » This function checks one element to many, handy and clean. 

*[[isElementInPhotograph]] » This function checks if an element was in the player's camera picture. This needs writing still. --[[User:Ransom|Ransom]] 21:45, 2 May 2012 (UTC) 

*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations. 

*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites.

*[[getPlayersInPhotograph]] » This function gets all the players in a photograph.

*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.

*[[dxDrawImage3D]] » This function draws a 3D image.

*[[string.count]] » This function counts a text from a text.

*[[getOnlineAdmins]] » This function will give the online admins.

*[[dxGetFontSizeFromHeight]] » This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.

*[[isElementInRange]] » This function calculate a font size from height.
[[Category:Useful Functions]]

IsElementInRange

2012-08-03T21:47:07Z

Ken Xeiko:

__NOTOC__
{{Useful Function}}
This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, float range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(theElement, x, y, z, range)
if theElement and x and y and z and range then
local px, py, pz = getElementPosition (theElement)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then -- check if the player's range to the command user is 25m.
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:44:30Z

Ken Xeiko:

__NOTOC__
{{Useful Function}}
This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(theElement, x, y, z, range)
if theElement and x and y and z and range then
local px, py, pz = getElementPosition (theElement)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then -- check if the player's range to the command user is 25m.
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:43:15Z

Ken Xeiko: /* Example */

__NOTOC__
{{Useful Function}}
This function allows you to find out is the element in range of the main point.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(theElement, x, y, z, range)
if theElement and x and y and z and range then
local px, py, pz = getElementPosition (theElement)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then -- check if the player's range to the command user is 25m.
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:42:22Z

Ken Xeiko: /* Code */

__NOTOC__
{{Useful Function}}
This function allows you to find out is the element in range of the main point.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(theElement, x, y, z, range)
if theElement and x and y and z and range then
local px, py, pz = getElementPosition (theElement)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:42:07Z

Ken Xeiko: /* Code */

__NOTOC__
{{Useful Function}}
This function allows you to find out is the element in range of the main point.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(theElement, x, y, z, range)
if theElementand x and y and z and range then
local px, py, pz = getElementPosition (theElement)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:41:22Z

Ken Xeiko: /* Example */

__NOTOC__
{{Useful Function}}
This function allows you to find out is the element in range of the main point.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(element, x, y, z, range)
if element and x and y and z and range then
local px, py, pz = getElementPosition (player)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs (getElementsByType ('player')) do
if isElementInRange (p, x, y, z, 25) then
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:40:49Z

Ken Xeiko:

__NOTOC__
{{Useful Function}}
This function allows you to find out is the element in range of the main point.
==Syntax==
<syntaxhighlight lang="lua">
bool isElementInRange( element theElement, float x, float y, float z, fload range )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' the element whose range we want to check.
*'''x:''' the x coordinate of the main point.
*'''y:''' the y coordinate of the main point.
*'''z:''' the z coordinate of the main point.
*'''range:''' the range of the main point to the element.

===Returns===
*Returns ''true'' if the element is in range of the main point, ''false'' otherwise.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function isElementInRange(element, x, y, z, range)
if element and x and y and z and range then
local px, py, pz = getElementPosition (player)
return ((x-px)^2+(y-py)^2+(z-pz)^2)^0.5 <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) the maximum range.
else
return false
end
end

end
</syntaxhighlight>
</section>

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("killnear",
function (player)
local x, y, z = getElementPosition (player)
for _,p in ipairs(getElementsByType('player')) do
if isElementInRange(p, x, y, z, 25) then
if p ~= player then
killPed (p, player) -- kill player within 25m from the command user.
end
end
end
end
)
</syntaxhighlight>
</section>

Function created by '''KenXeiko'''.

==See Also==
{{Useful_Functions}}

IsElementInRange

2012-08-03T21:36:19Z

Ken Xeiko: Created page with "__NOTOC__ {{Useful Function}} This function allows you to find out is the element in range of the main point. ==Syntax== <syntaxhighlight lang="lua"> bool isElementInRange( element theElement,..."

GetElementAttachedOffsets

2012-08-03T12:45:42Z

Ken Xeiko:

__NOTOC__
{{Server client function}}
This function returns the offsets of an element that has been attached to another element using [[attachElements]].

==Syntax==
<syntaxhighlight lang="lua">
float, float, float, float, float, float getElementAttachedOffsets ( element theElement )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The attached element.

===Returns===
Returns 6 [[float|floats]], of which the first 3 indicate the position offset (x, y, z), and the last 3 indicate the rotation offset (x, y, z), if successful. ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
'''Example:''' This example creates a car with a minigun
<syntaxhighlight lang="lua">
-- Offsets
local x,y,z,rx,ry,rz= 0,-1.5,-0.1,0,0,-90

function createArmedBobcat(cmd)
local lx, ly, lz = getElementPosition(getLocalPlayer()) -- get the position of the player
lx = lx + 5 -- add 5 units to the x position

veh = createVehicle( 422, lx, ly, lz) -- create a bobcat
base = createObject( 2985, 2,2,2) -- create a minigun_base object
setElementCollisionsEnabled ( base, false ) -- the minigun_base damages the car
-- you could alternatively load an empty col file for the minigun object
attachElements ( base, veh, x,y,z,rx,ry,rz) -- attach the base to the bobcat
end

function rotateIt(cmd, addZ)
if(addZ) then
local x, y, z, rz, ry, rz = getElementAttachedOffsets (base) -- get the offsets
rz = rz + addZ
setElementAttachedOffsets (base, x, y, z, rx, ry, rz) -- update offsets
end
end

addCommandHandler("bobcat", createArmedBobcat)
addCommandHandler("rotate", rotateIt)
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

OnClientPlayerWeaponFire

2012-08-03T12:42:48Z

Ken Xeiko: /* Parameters */

{{Client event}}
__NOTOC__
This event is called when player shoots a weapon. This does not trigger for projectiles based, or melee weapons. Also note that this event is only triggered for players nearby the local player's camera. This is due to elements far away being streamed out.

==Parameters==
<syntaxhighlight lang="lua">
int weapon, int ammo, int ammoInClip, float hitX, float hitY, float hitZ, element hitElement, float startX, float startY, float startZ
</syntaxhighlight>
*'''weapon''': an [[int]] representing [[weapons|weapon]] used for making a shot.
*'''ammo''': an [[int]] ammount of ammo left for this weapon type.
*'''ammoInClip''': an [[int]] ammount of ammo left for this weapon type in clip.
*'''hitX''', '''hitY''', '''hitZ''': [[float]] world coordinates representing a hit point.
*'''hitElement''': an [[element]] which was hit by a shot.
{{New feature/item|3.0152|1.3.1|4311|
*'''startX''', '''startY''', '''startZ''': [[float]] world coordinates representing the start of the bullet. Note: This is not the gun muzzle.
}}

==Source==
The [[event system#Event source|source]] of this event is the streamed in [[player]] who fired the weapon.

==Example==
This example sends a warning to the local player if they shoot another player with a minigun.
<syntaxhighlight lang="lua">
--First, we create a function for the event handler to use.
function onClientPlayerWeaponFireFunc(weapon, ammo, ammoInClip, hitX, hitY, hitZ, hitElement )
if weapon == 38 and getElementType(hitElement)=="player" then -- If the player shoots with a minigun, and hits another player...
outputChatBox ( "Don't kill people with minigun, it's lame!", 255, 0, 0 ) -- We output a warning to him.
end
end
-- Add this as a handler so that the function will be triggered every time the local player fires.
addEventHandler ( "onClientPlayerWeaponFire", getLocalPlayer(), onClientPlayerWeaponFireFunc )
</syntaxhighlight>
This example makes the Shotgun fire explosive rounds.
<syntaxhighlight lang="lua">
function onClientPlayerWeaponFireFunc(weapon, ammo, ammoInClip, hitX, hitY, hitZ, hitElement)
if (weapon == 25) then -- If the player shoots with a shotgun
createExplosion(hitX, hitY, hitZ, 12, true, false, true) -- Creates a tiny explosion where the bullet hit.
end
end
-- Add this as a handler so that the function will be triggered every time a player fires.
addEventHandler("onClientPlayerWeaponFire", root, onClientPlayerWeaponFireFunc)
</syntaxhighlight>

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

User:Ken Xeiko

2012-07-22T12:18:31Z

Ken Xeiko: /* ToDo List */

KenXeiko is only an gamer which is addicted of coding and scripting.
And also a fan of MTA:SA.

==TODO List==
* Learn more about C++ and training more with it.
* Make more funny things on MTA:SA.

GetElementAttachedOffsets

2012-07-22T11:54:58Z

Ken Xeiko: /* Example */

__NOTOC__
{{Server client function}}
This function returns the offsets of an element that has been attached to another element using [[attachElements]].

==Syntax==
<syntaxhighlight lang="lua">
float, float, float, float, float, float getElementAttachedOffsets ( element theElement )
</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The attached element.

===Returns===
Returns 6 [[float|floats]], of which the first 3 indicate the position offset (x, y, z), and the last 3 indicate the rotation offset (x, y, z), if successful. ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
'''Example:''' This example creates a car with a minigun
<syntaxhighlight lang="lua">
-- Offsets
local x,y,z,rx,ry,rz= 0,-1.5,-0.1,0,0,-90

function createArmedBobcat(cmd)
local lx, ly, lz = getElementPosition(getLocalPlayer()) -- get the position of the player
lx = lx + 5 -- add 5 units to the x position

veh = createVehicle( 422, lx, ly, lz) -- create a bobcat
base = createObject( 2985, 2,2,2) -- create a minigun_base object
setElementCollisionsEnabled ( base, false ) -- the minigun_base damages the car
-- you could alternatively load an empty col file for the minigun object
attachElements ( base, veh, x,y,z,rx,ry,rz) -- attach the base to the bobcat
end

function rotateIt(cmd, addZ)
if(addZ) then
local x, y, z, rz, ry, rz = getElementAttachedOffsets -- get the offsets
rz = rz + addZ
setElementAttachedOffsets (base, x, y, z, rx, ry, rz) -- update offsets
end
end

addCommandHandler("bobcat", createArmedBobcat)
addCommandHandler("rotate", rotateIt)
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

User:Ken Xeiko

2012-07-14T14:14:57Z

Ken Xeiko: Created page with "KenXeiko is only an gamer which is addicted of coding and scripting. And also a fan of MTA:SA. ==ToDo List== * Learn more about C++ and training more with it. * Make more funny ..."

KenXeiko is only an gamer which is addicted of coding and scripting.
And also a fan of MTA:SA.

==ToDo List==
* Learn more about C++ and training more with it.
* Make more funny things on MTA:SA.
* Learn deustch (or my teacher will kill me, pff).

SetWorldSpecialPropertyEnabled

2012-07-14T14:07:00Z

Ken Xeiko: /* Required Arguments */

__NOTOC__
{{Client function}}

Enables or disables a special world property (cheat).

==Syntax==
<syntaxhighlight lang="lua">bool setWorldSpecialPropertyEnabled ( string propname, bool enable )</syntaxhighlight>

===Required Arguments===
*'''propname:''' the name of the property to set. Possible values are:
**'''hovercars''' - no known equivalent PC cheat, and allows cars to drive on water.
**'''aircars''' - equivalent of the RIPAZHA cheat, and allows cars to fly.
**'''extrabunny''' - equivalent of the CJPHONEHOME or JHJOECW cheat, and allows you to bunny hop on bicycles much higher.
**'''extrajump''' - equivalent of the KANGAROO cheat, and allows you to jump on foot much higher.
*'''enable:''' whether or not to enable the property.

===Returns===
Returns ''true'' if successful, ''false'' otherwise.

==See Also==
{{Client world functions}}