Multi Theft Auto: Wiki - User contributions [en]

Server Scripting Events

2020-08-22T14:10:59Z

Violence: /* Server events */

<pageclass class="server"></pageclass>
This page lists all '''server-side''' scripting [[event]]s that have been implemented and are available in the Deathmatch mod.

To request a function or event, use [[Requested Functions and Events]].

'''Client-side scripting events can be found here: [[Client Scripting Events]]

==Account events==
{{Account_events}}

==Client events==
{{Client_events}}

==Colshape events==
{{Colshape_events}}

==Element events==
{{Element_events}}

==Marker events==
{{Marker_events}}

==Pickup events==
{{Pickup_events}}

==Player events==
{{Player_events}}

==Ped events==
{{Ped_events}}

==Resource events==
{{Resource_events}}

==Sunucu Olayları==
{{Server_events}}

==Vehicle events==
{{Vehicle_events}}

==Weapon events==
{{Weapon_events}}

[[hu:Server Scripting Events]]
[[tr:Server Scripting Events]]
[[pt-br:Eventos de Scripting do Servidor]]
[[ru:Server Scripting Events]]
[[fr:Server Scripting Events]]
[[ru:Server Scripting Events]]
[[ar:Server Scripting Events]]

OnBan

2020-08-22T14:10:31Z

Violence: /* Örnek */

__NOTOC__
{{Server event}}
This event is triggered when an IP address or serial is banned from the server.

==Sözdizimi==
<syntaxhighlight lang="lua">
yasaklama theBan
</syntaxhighlight>

*'''theBan''': Eklenmiş olan yasak.

==Kaynak==
Bu olayın kaynağı, yasaklanmadan sorumlu olan değişkendir.Eğer hiçbir sorumlu yoksa o zaman kaynak, genel root değişkeni olur.

==İptal Etme==
Bu olay iptal edilemez.

==Örnek==
Bu örnek, bir oyuncu yasaklandığında herkese bir mesaj gönderiyor.
<syntaxhighlight lang="lua">
function announceBan( theBan )
if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root
</syntaxhighlight>

OnBan

2020-08-22T14:10:14Z

Violence: /* Example */

OnBan

2020-08-22T14:09:33Z

Violence: /* Cancel effect */

__NOTOC__
{{Server event}}
This event is triggered when an IP address or serial is banned from the server.

==Sözdizimi==
<syntaxhighlight lang="lua">
yasaklama theBan
</syntaxhighlight>

*'''theBan''': Eklenmiş olan yasak.

==Kaynak==
Bu olayın kaynağı, yasaklanmadan sorumlu olan değişkendir.Eğer hiçbir sorumlu yoksa o zaman kaynak, genel root değişkeni olur.

==İptal Etme==
Bu olay iptal edilemez.

==Example==
This example outputs a simple message to all players when a player added a ban.
<syntaxhighlight lang="lua">
function announceBan( theBan )
if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root
</syntaxhighlight>

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

OnBan

2020-08-22T14:09:15Z

Violence: /* Parameters */

__NOTOC__
{{Server event}}
This event is triggered when an IP address or serial is banned from the server.

==Sözdizimi==
<syntaxhighlight lang="lua">
yasaklama theBan
</syntaxhighlight>

*'''theBan''': Eklenmiş olan yasak.

==Kaynak==
Bu olayın kaynağı, yasaklanmadan sorumlu olan değişkendir.Eğer hiçbir sorumlu yoksa o zaman kaynak, genel root değişkeni olur.

==Cancel effect==
This event cannot be canceled.

==Example==
This example outputs a simple message to all players when a player added a ban.
<syntaxhighlight lang="lua">
function announceBan( theBan )
if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root
</syntaxhighlight>

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

OnBan

2020-08-22T14:09:01Z

Violence: /* Source */

__NOTOC__
{{Server event}}
This event is triggered when an IP address or serial is banned from the server.

==Parameters==
<syntaxhighlight lang="lua">
yasaklama theBan
</syntaxhighlight>

*'''theBan''': Eklenmiş olan yasak.

==Kaynak==
Bu olayın kaynağı, yasaklanmadan sorumlu olan değişkendir.Eğer hiçbir sorumlu yoksa o zaman kaynak, genel root değişkeni olur.

==Cancel effect==
This event cannot be canceled.

==Example==
This example outputs a simple message to all players when a player added a ban.
<syntaxhighlight lang="lua">
function announceBan( theBan )
if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root
</syntaxhighlight>

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

OnBan

2020-08-22T14:06:57Z

Violence: /* Parameters */

__NOTOC__
{{Server event}}
This event is triggered when an IP address or serial is banned from the server.

==Parameters==
<syntaxhighlight lang="lua">
yasaklama theBan
</syntaxhighlight>

*'''theBan''': Eklenmiş olan yasak.

==Source==
The [[event system#Event source|source]] of this event is the [[element]] that was responsible for the banning. If no responsible was specified, the source is the global root element.

==Cancel effect==
This event cannot be canceled.

==Example==
This example outputs a simple message to all players when a player added a ban.
<syntaxhighlight lang="lua">
function announceBan( theBan )
if ( isElement( source ) ) and ( getElementType( source ) == "player" ) then -- Check if the element responsible for the ban is a player element
outputChatBox( getPlayerName( source ) .. " banned " .. ( getBanSerial( theBan ) or getBanIP( theBan ) ) ) -- Output to the chatbox saying the player has banned the IP/Serial
end
end
addEventHandler( "onBan", root, announceBan ) -- Adds the event handler for "onBan" and must be bound to root
</syntaxhighlight>

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

Server Scripting Events

2020-08-22T14:05:48Z

Violence: /* Server events */

AddAccount

2020-08-22T14:05:18Z

Violence: /* Syntax */

{{Server function}}
__NOTOC__
This function adds an [[account]] to the list of registered accounts of the current server.

==Sözdizimi==
<syntaxhighlight lang="lua">hesap addAccount ( Hesap İsmi, Satır Geçisi [, bool Durum Varyasyonlarına izin Ver = false/true ] )
</syntaxhighlight>
{{OOP|This function is a static function underneath the Account class.|[[Account]].add ||}}
===Required Arguments===
*'''name:''' The name of the account you wish to make, this normally is the player's name.
*'''pass:''' The password to set for this account for future logins.

===Optional Arguments===
*'''allowCaseVariations:''' Whether the username is case sensitive (if this is set to true, usernames "Bob" and "bob" will refer to different accounts)

===Returns===
Returns an [[account]] or ''false'' if the account already exists or an error occured.

===Limits===
*'''name:'''
** Minimal account name length is 1 character.
** Account names are case-sensitive if allowCaseVariations is ''true''.
** Account name can not be equal to "*****"
*'''pass:'''
** Minimal account password length is 1 character.
** Maximum account password length is 30 characters.
** Account password can not be equal to "*****"

==Example==
'''Example 1:''' This enables players to register on your server by using /register <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, password )
-- Check if the password field is blank or not (only blank if they didnt enter one)
if ( password ~= "" and password ~= nil ) then
--Attempt to add the account, and save its value in a var
local accountAdded = addAccount( getPlayerName(source), password )
if ( accountAdded ) then
-- Tell the user all is done
outputChatBox ( "Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login", source )
else
-- There was an error making the account, tell the user
outputChatBox ( "Error creating account, contact the server admin", source )
end
else
-- There was an error in the syntax, tell the user the correct syntax.
outputChatBox ( "Error creating account, correct syntax: /register <password>", source )
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''This code differs by allowing the user to change their username that they wish to use.'''

'''Example 2:''' This enables players to register on your server by using /register <username> <password> in the chat window.
<syntaxhighlight lang="lua">
function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
addCommandHandler ( "register", registerPlayer ) -- add the command handler
</syntaxhighlight>

'''Example 3:''' This code differs again so the user can only register once /register <username> <password>.
<syntaxhighlight lang="lua">
bRegisteredOnce = {}

function registerPlayer ( source, commandName, username, password )
if(password ~= "" and password ~= nil and username ~= "" and username ~= nil and not bRegisteredOnce[source]) then
local accountAdded = addAccount(username,password)
if(accountAdded) then
outputChatBox("Thank you " .. getPlayerName(source) .. ", you're now registed, you can login with /login",source)
bRegisteredOnce[source] = true
else
outputChatBox("Error creating account, contact the server admin.",source)
end
else
if bRegisteredOnce[source] == true then
outputChatBox("You already registered on this server!",source)
else
outputChatBox("Error creating account, correct syntax: /register <nick> <pass>",source)
end
end
end
</syntaxhighlight>

==See Also==

{{Account_functions}}

[[ar:addAcount]]
[[es:addAcount]]
[[pl:addAccount]]
[[ru:addAccount]]

Server Scripting Functions

2020-08-22T14:02:58Z

Violence: /* Account functions */

<pageclass class="server"></pageclass>
{{Adding_Pages_to_Categories_and_Templates}}
This page lists all the '''server-side''' scripting functions that have been implemented and are available as native functions. To request a function or event, use [[Requested Functions and Events]] or https://bugs.mtasa.com.

Please note that the scripting functions can also be extended by loading in dynamic modules that provide new functionality, such as utility functions. These scripting functions are non-native and require the module to be loaded in order to work.

Head over to [[Modules]] for a list of non-native serverside functions and modules that are available.

For more functions, check the [[Useful_Functions|useful functions page]].

'''Client-side scripting functions can be found here: [[Client Scripting Functions]].'''
__TOC__

==Hesap Fonksiyonları==
{{Account_functions}}

==ACL functions==
{{ACL_functions}}

==Admin functions==
{{Admin_functions}}

==Audio functions==
{{Audio_functions}}

==Announcement functions==
{{Announce_functions}}

==Blip functions==
{{Blip_functions}}

==Camera functions==
{{Camera_functions}}

==Clothes and body functions==
{{Clothes_and_body_functions}}

==Collision shape functions==
{{Collision_shape_functions}}

==Cursor functions==
{{Cursor_functions}}

==Element functions==
{{Element_functions}}

==Event functions==
{{Event_functions}}

==Explosion functions==
{{Explosion_functions}}

==File functions==
{{File_functions}}

==HTTP functions==
{{HTTP_functions}}

==Input functions==
{{Input_functions}}

==Map functions==
{{Map_functions}}

==Marker functions==
{{Marker_functions}}

==Matrix functions==
{{Shared_matrix_functions}}

==Module functions==
{{Module_functions}}

==Object functions==
{{Object_functions}}

==Output functions==
{{Output_functions}}

==Ped functions==
{{Ped_functions}}

==Pickup functions==
{{Pickup_functions}}

==Player functions==
{{Player_functions}}

==Projectile functions==
{{Projectile_functions}}

==Radar area functions==
{{Radar_area_functions}}

==Resource functions==
{{Resource_functions}}

==Server functions==
{{Server_functions}}

==Settings registry functions==
{{Settings_registry_functions}}

==SQL functions==
{{SQL_functions}}

==Team functions==
{{Team_functions}}

==Text functions==
{{Text_functions}}

==Utility functions==
{{Utility_functions}}

==UTF8 Library==
{{UTF8_functions}}

==Vehicle functions==
{{Vehicle_functions}}

==Water functions==
{{Water_functions}}

==Weapon functions==
{{Weapon_functions}}

==World functions==
{{World_functions}}

==XML functions==
{{XML_functions}}

[[hu:Server Scripting Functions]]
[[ar:Server Scripting Functions]]
[[de:Server-Seitige Scripting Funktionen]]
[[es:Funciones_del_Server]]
[[pl:Server Scripting Functions]]
[[pt-br:Funções de Scripting do Servidor]]
[[ru:Server Scripting Functions]]
[[tr:Server Scripting Functions]]