Multi Theft Auto: Wiki - User contributions [en]

SetBanNick

2015-03-31T17:13:26Z

HuX: /* Example */

__NOTOC__
{{Server function}}

{{New feature/item|3.0141|1.4.1|7093|This function sets a new nick for a [[ban]].}}

==Syntax==
<syntaxhighlight lang="lua">bool setBanNick ( ban theBan, string theNick )</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] you want to change the nick of.
*'''theNick:''' A string representing the nick you want to set the ban to.

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

== Example ==
<syntaxhighlight lang="lua">
-- this example looks if there is a ban with nick 'Steve', and if there is, it changes ban nick to 'Mike'
function changeBanNick()
for i,ban in pairs(getBans()) do
if getBanNick(ban) == "Steve" then
setBanNick(ban,"Mike")
end
end
end
addCommandHandler("setbannick",changeBanNick)
</syntaxhighlight>

== See Also ==
{{Admin_functions}}

SetBanNick

2015-03-31T17:12:54Z

HuX:

__NOTOC__
{{Server function}}

{{New feature/item|3.0141|1.4.1|7093|This function sets a new nick for a [[ban]].}}

==Syntax==
<syntaxhighlight lang="lua">bool setBanNick ( ban theBan, string theNick )</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] you want to change the nick of.
*'''theNick:''' A string representing the nick you want to set the ban to.

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

== Example ==
<syntaxhighlight lang="lua">
-- this example looks if there is a ban with nick 'Steve', and if is, it changes ban nick to 'Mike'
function changeBanNick()
for i,ban in pairs(getBans()) do
if getBanNick(ban) == "Steve" then
setBanNick(ban,"Mike")
end
end
end
addCommandHandler("setbannick",changeBanNick)
</syntaxhighlight>

== See Also ==
{{Admin_functions}}

SetBanNick

2015-03-31T17:12:34Z

HuX: /* Example */

__NOTOC__
{{Server function}}
{{Needs Example}}

{{New feature/item|3.0141|1.4.1|7093|This function sets a new nick for a [[ban]].}}

==Syntax==
<syntaxhighlight lang="lua">bool setBanNick ( ban theBan, string theNick )</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] you want to change the nick of.
*'''theNick:''' A string representing the nick you want to set the ban to.

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

== Example ==
<syntaxhighlight lang="lua">
-- this example looks if there is a ban with nick 'Steve', and if is, it changes ban nick to 'Mike'
function changeBanNick()
for i,ban in pairs(getBans()) do
if getBanNick(ban) == "Steve" then
setBanNick(ban,"Mike")
end
end
end
addCommandHandler("setbannick",changeBanNick)
</syntaxhighlight>

== See Also ==
{{Admin_functions}}

GetElementMatrix

2015-03-09T23:12:12Z

HuX: /* Example */

{{Client function}}
__NOTOC__
This function gets an [[element]]'s transform [[matrix]]. This contains 16 float values that multiplied to a point will give you the point transformed. It is most useful for matrix calculations such as calculating offsets. For further information, please refer to a tutorial of matrices in computer graphics programming.
{{Note|The [[matrix]] returned by this function is [http://bugs.mtasa.com/view.php?id{{=}}6984 not setup correctly for some calculations] unless the '''legacy''' argument is set to '''''false'''''.}}
{{Tip|''For [[matrix]] manipulation which goes beyond the basic examples given on this page, see the [[Lua matrix library]].'' If you are using MTA: SA 1.4 or higher, using the built-in [[matrix]] class is also recommended.}}
==Syntax==
<syntaxhighlight lang="lua">
table getElementMatrix ( element theElement [, bool legacy = true ] )
</syntaxhighlight>
{{OOP||[[element]]:getMatrix|matrix|setElementMatrix}}

===Required Arguments===
*'''theElement:''' The [[element]] which you wish to retrieve the [[matrix]] for.

===Optional Arguments===
*'''legacy:''' Set to ''false'' to return correctly setup [[matrix]] (i.e. Last column in the first 3 rows set to zero).

===Returns===
Returns a multi-dimensional array (which can be transformed into a proper [[matrix]] class using ''Matrix.create'' method) containing a 4x4 matrix. Returns ''false'' if the element is not streamed in, and not a [[vehicle]], [[ped]] or [[object]].

==Example==
This example creates a utility function that turns an offset into a position that is relative to the specified element.
<syntaxhighlight lang="lua">
function getPositionFromElementOffset(element,offX,offY,offZ)
local m = getElementMatrix ( element ) -- Get the matrix
local x = offX * m[1][1] + offY * m[2][1] + offZ * m[3][1] + m[4][1] -- Apply transform
local y = offX * m[1][2] + offY * m[2][2] + offZ * m[3][2] + m[4][2]
local z = offX * m[1][3] + offY * m[2][3] + offZ * m[3][3] + m[4][3]
return x, y, z -- Return the transformed point
end

-- Get the position of a point 3 units to the right of the element:
x,y,z = getPositionFromElementOffset(element,3,0,0)

-- Get the position of a point 2 units in front of the element:
x,y,z = getPositionFromElementOffset(element,0,2,0)

-- Get the position of a point 1 unit above the element:
x,y,z = getPositionFromElementOffset(element,0,0,1)

</syntaxhighlight>

This example creates some more matrix utility functions
<syntaxhighlight lang="lua">
function getMatrixLeft(m)
return m[1][1], m[1][2], m[1][3]
end
function getMatrixForward(m)
return m[2][1], m[2][2], m[2][3]
end
function getMatrixUp(m)
return m[3][1], m[3][2], m[3][3]
end
function getMatrixPosition(m)
return m[4][1], m[4][2], m[4][3]
end

local mat = getElementMatrix(element) -- Get the matrix
x,y,z = getMatrixLeft(mat) -- Get the matrix left direction
x,y,z = getMatrixForward(mat) -- Get the matrix forward direction
x,y,z = getMatrixUp(mat) -- Get the matrix up direction

</syntaxhighlight>

This example function shows you what getElementMatrix does internally.
<syntaxhighlight lang="lua">
function getElementMatrix(element)
local rx, ry, rz = getElementRotation(element, "ZXY")
rx, ry, rz = math.rad(rx), math.rad(ry), math.rad(rz)
local matrix = {}
matrix[1] = {}
matrix[1][1] = math.cos(rz)*math.cos(ry) - math.sin(rz)*math.sin(rx)*math.sin(ry)
matrix[1][2] = math.cos(ry)*math.sin(rz) + math.cos(rz)*math.sin(rx)*math.sin(ry)
matrix[1][3] = -math.cos(rx)*math.sin(ry)
matrix[1][4] = 1

matrix[2] = {}
matrix[2][1] = -math.cos(rx)*math.sin(rz)
matrix[2][2] = math.cos(rz)*math.cos(rx)
matrix[2][3] = math.sin(rx)
matrix[2][4] = 1

matrix[3] = {}
matrix[3][1] = math.cos(rz)*math.sin(ry) + math.cos(ry)*math.sin(rz)*math.sin(rx)
matrix[3][2] = math.sin(rz)*math.sin(ry) - math.cos(rz)*math.cos(ry)*math.sin(rx)
matrix[3][3] = math.cos(rx)*math.cos(ry)
matrix[3][4] = 1

matrix[4] = {}
matrix[4][1], matrix[4][2], matrix[4][3] = getElementPosition(element)
matrix[4][4] = 1

return matrix
end
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04186|Added legacy argument}}

==See Also==
{{Client_element_functions}}

SetFarClipDistance

2015-03-07T20:41:37Z

HuX:

{{note box|Setting this less than 5 will cause problems to the client}}
__NOTOC__
{{Server client function}}
This function is used to set the distance of render. Areas beyond the specified distance will not be rendered.

==Syntax==
<syntaxhighlight lang="lua">
bool setFarClipDistance ( float distance )
</syntaxhighlight>

===Required Arguments===
*'''distance:''' A float specifying the distance of render.

===Returns===
Returns ''true'' if the distance was set correctly, ''false'' if invalid arguments were passed.

==Example==
<section name="Server" class="server" show="true">
This example adjusts the visibility range of the game world.
<syntaxhighlight lang="lua">
addEventHandler( "onResourceStart", resourceRoot,
function( )
setFarClipDistance( 3000 ) -- We adjust visibility range to 3000 metres
end
)
</syntaxhighlight>
</section>
<section name="Client" class="client" show="false">
This example adjusts the visibility range of the game world.
<syntaxhighlight lang="lua">
addEventHandler( "onClientResourceStart", resourceRoot,
function( )
setFarClipDistance( 3000 ) -- We adjust visibility range to 3000 metres
end
)
</syntaxhighlight>
</section>

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

TriggerClientEvent

2015-03-07T19:32:00Z

HuX:

__NOTOC__
{{Server function}}
This function triggers an event previously registered on a client. This is the primary means of passing information between the server and the client. Clients have a similar [[triggerServerEvent]] function that can do the reverse. You can treat this function as if it was an asynchronous function call, using [[triggerServerEvent]] to pass back any returned information if necessary.

Almost any data types can be passed as expected, including [[element]]s and complex nested [[table]]s. Non-element MTA data types like xmlNodes or resource pointers will not be able to be passed as they do not necessarily have a valid representation on the client.

Events are sent reliably, so clients will receive them, but there may be (but shouldn't be) a significant delay before they are received. You should take this into account when using them.

Keep in mind the bandwidth issues when using events - don't pass a large list of arguments unless you really need to. It is marginally more efficient to pass one large event than two smaller ones.
==Syntax==
<syntaxhighlight lang="lua">
bool triggerClientEvent ( [table/element sendTo=getRootElement()], string name, element sourceElement, [arguments...] )
</syntaxhighlight>

===Required Arguments===
*'''name:''' The name of the event to trigger client side. You should register this event with [[addEvent]] and add at least one event handler using [[addEventHandler]].
*'''sourceElement:''' The element that is the [[Event system#Event handlers|source]] of the event.
{{Note|To save client CPU, you should avoid setting '''sourceElement''' to the [[root element]] where possible. Using [[GetThisResource|resourceRoot]] is usually sufficient if the event is handled by the same resource on the client.}}

===Optional Arguments===
{{OptionalArg}}
*'''sendTo:''' The event will be sent to all [[player]]s that are children of the specified element. By default this is the root element, and hence the event is sent to all players. If you specify a single player it will just be sent to that player. This argument can also be a table of player elements.
*'''arguments...:''' A list of arguments to trigger with the event. You can pass any lua data type (except functions). You can also pass [[element]]s.

===Returns===
Returns ''true'' if the event trigger has been sent, ''false'' if invalid arguments were specified.

==Example==
===Example 1===
This example shows how you can pass a simple "Hello World" message from the server to the all the clients using an event.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function greetingHandler ( message )
outputChatBox ( "The server says: " .. message )
end
addEvent( "onGreeting", true )
addEventHandler( "onGreeting", localPlayer, greetingHandler )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function greetingCommand ( playerSource, commandName )
triggerClientEvent ( playerSource, "onGreeting", playerSource, "Hello World!" )
end
addCommandHandler ( "greet", greetingCommand )
</syntaxhighlight>
</section>

When the command "greet" is executed (by typing it in the server console or the player's console), the server's ''greetingCommand'' function is called. This triggers the client side event ''onGreeting'' with the string ''"Hello World!"''. This event is then handled by the ''greetingHandler'' function client side which then displays the message.

===Example 2===
This example shows how you can pass a simple "Hello World" message from the server to '''a single''' client using an event.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function greetingHandler ( message )
outputChatBox ( "The server says: " .. message )
end
addEvent( "onGreeting", true )
addEventHandler( "onGreeting", localPlayer, greetingHandler )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function greetingCommandOne ( playerSource, commandName, playerName )
if playerName then
local thePlayer = getPlayerFromName ( playerName )
if thePlayer then
triggerClientEvent ( thePlayer, "onGreeting", thePlayer, "Hello World!" )
else
-- invalid player name specified
end
else
-- No player name specified
end
end
addCommandHandler ( "greet_one", greetingCommandOne )
</syntaxhighlight>
</section>

This works like the first example except an extra ''thePlayer'' argument is specified for triggerClientEvent.

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.0-9.04570|Added option to use a list of player elements for the 'sendTo' argument}}

==See Also==
{{Event functions}}
[[ru:triggerClientEvent]]

OnClientPedHitByWaterCannon

2015-02-08T12:14:06Z

HuX: /* Cancel effect */

__NOTOC__
{{Client event}}
This event is fired when a ped is hit by a water cannon.
{{Note|This event is only triggered for peds that are streamed in}}
==Parameters==
<syntaxhighlight lang="lua">
ped pedHit
</syntaxhighlight>
*'''pedHit:''' the ped which got shot by the water cannon

==Source==
The source of this event is the vehicle who shot the water cannon.

==Type==
This event is a pre reaction event meaning it occurs before any game level reaction to the collision which include:
* Peds flying off
* Peds being knocked down

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the ped will not be knocked down

==Example==
<section class="client" name="Client" show="true">
This example says who got hit by a water cannon.
<syntaxhighlight lang="lua">
function outputPlayerHitByWater(thePed)
if (getElementType(thePed) ~= "player") then
return false -- This event is for peds and players but this example only wants players
end
local hitPed = getPlayerName(thePed)
outputChatBox(hitPed.." got hit by a water cannon!", 255, 0, 0)
end
addEventHandler("onClientPedHitByWaterCannon", root, outputPlayerHitByWater)

</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.03931|}}

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

GetProjectileCounter

2015-02-08T12:11:13Z

HuX:

__NOTOC__
{{Client function}}
Get the time left before a projectile detonates.

==Syntax==
<syntaxhighlight lang="lua">int getProjectileCounter ( projectile projectile )</syntaxhighlight>
{{OOP||[[projectile]]:getCounter|counter|setProjectileCounter}}

===Required Arguments===
* projectile: the projectile to get the timer of.

===Returns===
Returns the the time in milliseconds to detonation which depending on the projectile type will do different things:
* Grenades will explode when it hits 0
* Teargas may be a duration timer
* Both types of rockets will explode when it hits 0
* Satchels restarts so I do not think it does anything

===Example===
<section name="Client" class="client" show="true">
With this example you can find out how long does it take for a projectile to explode/end
<syntaxhighlight lang="lua">
function getProjectileBoomTime()
outputChatBox("Time for "..getProjectileType(source).." to explode/end is "..getProjectileCounter(source).." miliseconds.",255,0,0)
end
addEventHandler("onClientProjectileCreation",root,getProjectileBoomTime)

</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.04555|}}

==See Also==
{{Client projectile functions}}

OnClientPedHitByWaterCannon

2015-01-25T20:44:05Z

HuX:

__NOTOC__
{{Client event}}
This event is fired when a ped is hit by a water cannon.
{{Note|This event is only triggered for peds that are streamed in}}
==Parameters==
<syntaxhighlight lang="lua">
ped pedHit
</syntaxhighlight>
*'''pedHit:''' the ped which got shot by the water cannon

==Source==
The source of this event is the vehicle who shot the water cannon.

==Type==
This event is a pre reaction event meaning it occurs before any game level reaction to the collision which include:
* Peds flying off
* Peds being knocked down

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the Ped will not be knocked down

==Example==
<section class="client" name="Client" show="true">
This example outputs who got hit by water cannon.
<syntaxhighlight lang="lua">
function outputPlayerHitByWater(thePed)
local hitPed = getPlayerName(thePed) or "ped"
outputChatBox(hitPed.." got hit by water cannon!", 255, 0, 0)
end
addEventHandler("onClientPedHitByWaterCannon",root,outputPlayerHitByWater)

</syntaxhighlight>
'''Example was created by HuX'''
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.03931|}}

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

OnClientPedHitByWaterCannon

2015-01-25T20:42:55Z

HuX: /* Example */

__NOTOC__
{{Client event}}
{{Needs Example}}
This event is fired when a ped is hit by a water cannon.
{{Note|This event is only triggered for peds that are streamed in}}
==Parameters==
<syntaxhighlight lang="lua">
ped pedHit
</syntaxhighlight>
*'''pedHit:''' the ped which got shot by the water cannon

==Source==
The source of this event is the vehicle who shot the water cannon.

==Type==
This event is a pre reaction event meaning it occurs before any game level reaction to the collision which include:
* Peds flying off
* Peds being knocked down

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the Ped will not be knocked down

==Example==
<section class="client" name="Client" show="true">
This example outputs who got hit by water cannon.
<syntaxhighlight lang="lua">
function outputPlayerHitByWater(thePed)
local hitPed = getPlayerName(thePed) or "ped"
outputChatBox(hitPed.." got hit by water cannon!", 255, 0, 0)
end
addEventHandler("onClientPedHitByWaterCannon",root,outputPlayerHitByWater)

</syntaxhighlight>
'''Example was created by HuX'''
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.03931|}}

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

HR/banPlayer

2014-10-26T23:25:43Z

HuX: /* Izborni Argumenti */

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
Ova funkcija će prognati određenog igrača pomoću njegovog IP-a, [[serial]]-a, ili nadimka
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player prognaniIgrač, [ bool IP = true, bool Nadimak = false, bool Serial = false,
player odgovoranIgrač = nil, string razlog = nil, int sekunde = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player prognaniIgrač , [ element odgovoranElement, string razlog ] )
</syntaxhighlight>
}}
{{OOP||[[player]]:ban||}}
===Potrebni Argumenti===
*'''prognaniIgrač:''' Igrač koji će biti prognan sa servera.

===Izborni Argumenti===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Hoće li igrač biti prognan pomoću IP-a?
*'''Nadimak:''' Hoće li igrač biti prognan pomoću nadimka?
*'''Serial:''' Hoće li igrač biti prognan pomoću serial-a?

:'''NAPOMENA:''' da prognaš pomoću nadimka ili serial-a, ''verifyserials'' mora biti upaljen u datoteci konfiguracije servera.

}}
*'''odgovoranElement:''' Element koji je odgovoran za prognuće igrača. Ovo može biti igrač ili korijen ([[getRootElement]]()) (Najviše 30 slova ako se koristi string).
*'''razlog:''' Razlog zbog kojeg će igrač biti prognan sa servera.
*'''sekunde:''' Broj sekundi koliko će igrač biti prognan sa servera. Ovo može biti 0 za beskonačnu količinu vremena.

===Vraća===
{{Deprecated_feature|3|1.0|
Vraća ''true'' ako je igrač prognan uspješno, ''false'' ako su nevaljani argumenti naznačeni.
}}

{{New feature|3|1.0|
Vraća [[ban]] objekt ako je prognan uspješno, ili ''false'' ako je neuspješno.
}}

==Primjer==
Ovaj primjer dopušta igraču da progna bilo koga ako ima ACL prava.
<syntaxhighlight lang="lua">
-- Dodaj "ban" komandu
-- Primjer sa igračem
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Obavijesti igrača ako nema ACL prava
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Pronađi igrača iz imena
local bannedPlayer = getPlayerFromName ( bannedName )

--Prognaj igrača
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "progon: " .. bannedName .. " uspješno prognan", theClient )

else
outputChatBox ( "progon: Nemaš dopuštenje", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Primjer funkcije sa korijenovim elementom. Ovdje možeš predati igračev element funkciji.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "Ti si prognan zbog varanja.")
end
</syntaxhighlight>

Ovo je primjer "Zaštitnog Zida" Igračevoga računa na prijavi.
<syntaxhighlight lang="lua">
Firewall =
{
[ 'AccountName' ] = 'SerialPlayer',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if ( Serial ) then
if Serial ~= getPlayerSerial ( source ) then
banPlayer ( source, false, false, true, getRootElement ( ), 'razlog prognuća' )
end
end
end
)
</syntaxhighlight>

==Vidi također==
{{Admin_functions}}
[[es:banPlayer]]
[[ru:BanPlayer]]

BanPlayer

2014-10-26T23:21:56Z

HuX:

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
This function will ban the specified player by either IP, [[serial]] or username
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false,
player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement, string reason ] )
</syntaxhighlight>
}}
{{OOP||[[player]]:ban||}}
===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server.

===Optional Arguments===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Will player be banned by IP?
*'''Username:''' Will player be banned by username?
*'''Serial:''' Will player be banned by serial?

:'''Note:''' to ban by username or serial, ''verifyserials'' must be enabled in the server configuration file.

}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()) (Maximum 30 characters if using a string).
*'''reason:''' The reason the player will be banned from the server.
*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

===Returns===
{{Deprecated_feature|3|1.0|
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.
}}

{{New feature|3|1.0|
Returns a [[ban]] object if banned successfully, or ''false'' if unsuccessful.
}}

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
-- Example with the player
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromName ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Example function with the root element. Here you would pass a player element to the function.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
end
</syntaxhighlight>

This example is Firewall Account Player by serial on Login
<syntaxhighlight lang="lua">
Firewall =
{
[ 'AccountName' ] = 'SerialPlayer',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if ( Serial ) then
if Serial ~= getPlayerSerial ( source ) then
banPlayer ( source, false, false, true, getRootElement ( ), 'reason ban' )
end
end
end
)
</syntaxhighlight>

==See Also==
{{Admin_functions}}
[[es:banPlayer]]
[[ru:BanPlayer]]

BanPlayer

2014-10-26T23:20:02Z

HuX:

HR/banPlayer

2014-10-26T22:10:24Z

HuX: Created page with "__NOTOC__ {{Server function}} {{New feature|3|1.0| Ova funkcija će prognati određenog igrača pomoću njegovog IP-a, serial-a, ili nadimka }} {{Deprecated_feature|3|1...."

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
Ova funkcija će prognati određenog igrača pomoću njegovog IP-a, [[serial]]-a, ili nadimka
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player prognaniIgrač, [ bool IP = true, bool Nadimak = false, bool Serial = false,
player odgovoranIgrač = nil, string razlog = nil, int sekunde = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player prognaniIgrač , [ element odgovoranElement, string razlog ] )
</syntaxhighlight>
}}
{{OOP||[[player]]:ban||}}
===Potrebni Argumenti===
*'''prognaniIgrač:''' Igrač koji će biti prognan sa servera.

===Izborni Argumenti===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Hoće li igrač biti prognan pomoću IP-a?
*'''Nadimak:''' Hoće li igrač biti prognan pomoću nadimka?
*'''Serial:''' Hoće li igrač biti prognan pomoću serial-a?

:'''Napomena:''' da prognaš pomoću nadimka ili serial-a, ''verifyserials'' mora biti upaljen u datoteci konfiguracije servera.

}}
*'''odgovoranElement:''' Element koji je odgovoran za prognuće igrača. Ovo može biti igrač ili korijen ([[getRootElement]]()) (Najviše 30 slova ako se koristi string).
*'''razlog:''' Razlog zbog kojeg će igrač biti prognan sa servera.
*'''sekunde:''' Broj sekundi koliko će igrač biti prognan sa servera. Ovo može biti 0 za beskonačnu količinu vremena.

===Vraća===
{{Deprecated_feature|3|1.0|
Vraća ''true'' ako je igrač prognan uspješno, ''false'' ako su nevaljani argumenti naznačeni.
}}

{{New feature|3|1.0|
Vraća [[ban]] objekt ako je prognan uspješno, ili ''false'' ako je neuspješno.
}}

==Primjer==
Ovaj primjer dopušta igraču da progna bilo koga ako ima ACL prava.
<syntaxhighlight lang="lua">
-- Dodaj "ban" komandu
-- Primjer sa igračem
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Obavijesti igrača ako nema ACL prava
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Pronađi igrača iz imena
local bannedPlayer = getPlayerFromName ( bannedName )

--Prognaj igrača
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "progon: " .. bannedName .. " uspješno prognan", theClient )

else
outputChatBox ( "progon: Nemaš dopuštenje", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Primjer funkcije sa korijenovim elementom. Ovdje možeš predati igračev element funkciji.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "Ti si prognan zbog varanja.")
end
</syntaxhighlight>

Ovo je primjer "Zaštitnog Zida" Igračevoga računa na prijavi.
<syntaxhighlight lang="lua">
Firewall =
{
[ 'AccountName' ] = 'SerialPlayer',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if ( Serial ) then
if Serial ~= getPlayerSerial ( source ) then
banPlayer ( source, false, false, true, getRootElement ( ), 'razlog prognuća' )
end
end
end
)
</syntaxhighlight>

==Vidi također==
{{Admin_functions}}
[[es:banPlayer]]
[[ru:BanPlayer]]

User talk:HuX

2014-10-25T15:34:51Z

HuX: Created page with "test"

test

GetWeaponFlags

2014-10-12T22:15:22Z

HuX: /* Required Arguments */

__NOTOC__
{{Client function}}
{{Needs_Example}}
Gets the flags of the custom weapon (used to determine what to hit)

==Syntax==
<syntaxhighlight lang="lua">value getWeaponFlags ( weapon theWeapon, string theFlag )</syntaxhighlight>

===Required Arguments===
* '''theWeapon:''' The weapon to get the flag of.
* '''theFlag:''' The weapon flag to get:
** bool disable_model disable the weapon model of the weapon
** flags edit the processLineOfSight flags used to find the hit position
** bool checkBuildings
** bool checkCarTires
** bool checkDummies
** bool checkObjects
** bool checkPeds
** bool checkVehicles
** bool checkSeeThroughStuff
** bool checkShootThroughStuff
** bool instant_reload reload the weapon instantly rather than doing a reload
** bool shoot_if_out_of_range shoot the target position if out of weapon range
** bool shoot_if_blocked shoot the target position if blocked

===Returns===
Returns the ''value(s)'' on success (flags have 8 values), ''false'' otherwise.

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

==Requirements==
{{Requirements|n/a|1.3.0-9.04555|}}

==See Also==
{{Client weapon creation functions}}

GetModelHandling

2014-10-12T22:08:36Z

HuX: /* Example */

{{Server function}}
{{Needs_Example}}
__NOTOC__
This function returns a table containing the handling data of the specified vehicle model.

Note: the data returned may not reflect the actual handling of a particular vehicle, since this may be overriden by the [[setVehicleHandling]] function.

==Syntax==
<syntaxhighlight lang="lua">
table getModelHandling ( int modelId )
</syntaxhighlight>

===Required Arguments===
*'''modelId:''' The vehicle model you wish to get the handling data of.

===Returns===
Returns a ''table'' containing all the handling data, ''false'' if an invalid vehicle model is specified. Here is a list of valid table properties and what they return:
{{Handling Properties}}

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getHandlings(thePlayer,commandName,id)
if id then
local getVehicleHandlings = getModelHandling(id)
for k in pairs (getVehicleHandlings) do
outputChatBox(tostring(k))
end
else return end
end
addCommandHandler("gethandling",getHandlings)
</syntaxhighlight>
</section>

==See other vehicle functions==
{{Vehicle functions}}

GetModelHandling

2014-10-12T22:08:15Z

HuX: /* Example */

GetModelHandling

2014-10-12T22:07:55Z

HuX: /* Example */

GetModelHandling

2014-10-12T22:06:58Z

HuX: /* Example */

GetModelHandling

2014-10-12T22:03:41Z

HuX: /* Example */

{{Server function}}
{{Needs_Example}}
__NOTOC__
This function returns a table containing the handling data of the specified vehicle model.

Note: the data returned may not reflect the actual handling of a particular vehicle, since this may be overriden by the [[setVehicleHandling]] function.

==Syntax==
<syntaxhighlight lang="lua">
table getModelHandling ( int modelId )
</syntaxhighlight>

===Required Arguments===
*'''modelId:''' The vehicle model you wish to get the handling data of.

===Returns===
Returns a ''table'' containing all the handling data, ''false'' if an invalid vehicle model is specified. Here is a list of valid table properties and what they return:
{{Handling Properties}}

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getHandlings(thePlayer,commandName,id) -- 'id' represents a vehicle ID(number)
if id then
local getVehicleHandlings = getModelHandling(id) -- returns a table
for k in pairs (getVehicleHandlings) do -- for our table do
outputChatBox(tostring(k)) -- output every model's handling property
end
else return end -- if no id then stop executing the code
end
addCommandHandler("gethandling",getHandlings) -- attach the function to command 'gethandling'
</syntaxhighlight>
</section>

==See other vehicle functions==
{{Vehicle functions}}