Server Scripting Functions: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Changed translations hierarchy)
 
(277 intermediate revisions by 63 users not shown)
Line 1: Line 1:
This page lists all the scripting functions that have been implemented and are available as native functions from the Deathmatch mod. To request a function or event, use [[Requested Functions and Events]]
<pageclass class="server"></pageclass>
 
{{Adding_Pages_to_Categories_and_Templates}}
Please note that the scripting functions can now be extended by loading in dynamic modules that provide new functionality, such as MySQL database access. These scripting functions are non-native and require the module to be loaded in order to work.
This page lists all the '''server-side''' scripting functions that have been implemented and are available as native functions. To request a function, create an issue in [https://github.com/multitheftauto/mtasa-blue/issues our GitHub repository.]
 
Head over to [[Module functions]] for a list of non-native functions and modules that are available.


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__
==Account functions==
{{Account_functions}}
==ACL functions==
{{ACL_functions}}
==Admin functions==
{{Admin_functions}}
==Audio functions==
{{Audio_functions}}
==Announcement functions==
{{Announce_functions}}
==Blip functions==
==Blip functions==
[[blip]] [[createBlip]] ( float x, float y, float z, [[[int]] icon=0, [[int]] size=2, [[int]] r=255, [[int]] g=0, [[int]] b=0, [[int]] a=255, visibleTo=[[getRootElement]]()] )
{{Blip_functions}}
 
[[blip]] [[createBlipAttachedTo]] ( [[entity]] entity, [[[int]] icon=0, [[int]] size=2, [[int]] r=255, [[int]] g=0, [[int]] b=0, [[int]] a=255, visibleTo=[[getRootElement]]()] )
==Camera functions==
 
{{Camera_functions}}
bool [[destroyBlipAttachedTo]] ( [[entity]] entity )
 
==Clothes and body functions==
bool [[destroyAllBlips]] ()
{{Clothes_and_body_functions}}
 
[[int]] [[getBlipIcon]] ( [[blip]] blip )
==Collision shape functions==
 
{{Collision_shape_functions}}
[[int]] [[getBlipSize]] ( [[blip]] blip )
 
==Cursor functions==
[[int]] [[int]] [[int]] [[int]] [[getBlipColor]] ( [[blip]] blip )
{{Cursor_functions}}
 
blip [[getBlipAttachedTo]] ( [[entity]] entity )
 
bool [[setBlipIcon]] ( [[element]] blip, [[int]] icon )
 
bool [[setBlipSize]] ( [[element]] blip, [[int]] size )
 
bool [[setBlipColor]] ( [[element]] blip, [[int]] red, [[int]] green, [[int]] blue, [[int]] alpha )
 
bool [[attachBlipToEntity]] ( [[blip]] blip, [[entity]] entity )
 
==Element functions==
==Element functions==
bool [[destroyElement]] ( [[element]] element )
{{Element_functions}}
 
[[element]] [[getRootElement]] ()
 
[[element]] [[getElementChild]] ( [[element]] parent, [[int]] index )
 
[[int]] [[getElementChildrenCount]] ( [[element]] parent )
 
string [[getElementID]] ( [[element]] element )
 
[[element]] [[getElementByID]] ( string name, [[int]] index )
 
[[element]] [[getElementByIndex]] ( string type, [[int]] index )
 
var [[getElementData]] ( string name )
 
[[element]] [[getElementParent]] ( [[element]] element )
 
string [[getElementType]] ( [[element]] element )
 
table [[getElementsByType]] ( string type )
 
bool [[setElementID]] ( [[element]] element, string name )
 
bool [[setElementData]] ( [[element]] element, string name, var data )
 
bool [[setElementParent]] ( [[element]] element, [[element]] parent )
 
==Entity functions==
float float float [[getEntityPosition]] ( [[entity]] entity )
 
bool [[setEntityPosition]] ( [[element]] entity, float x, float y, float z )
 
bool [[addEntityVisibleTo]] ( [[element]] entity, [[element]] visibleto )
 
bool [[removeEntityVisibleTo]] ( [[element]] entity, [[element]] visibleto )
 
bool [[clearEntityVisibleTo]] ( [[element]] entity )
 
==Event functions==
==Event functions==
bool [[addEvent]] ( string name, string arguments )
{{Event_functions}}
 
bool [[addEventHandler]] ( string name, [[element]] element, string handler )
==Explosion functions==
 
{{Explosion_functions}}
bool [[triggerEvent]] ( string name, [[element]] element, [argument, ...] )
 
==File functions==
{{File_functions}}
==HTTP functions==
{{HTTP_functions}}
==Input functions==
{{Server_input_functions}}
==Map functions==
==Map functions==
string [[getLoadedMapName]] ()
{{Map_functions}}
 
xmlnode [[getLoadedMapXMLRoot]] ()
 
bool [[startMap]] ( string name )
 
bool [[endMap]] ()
 
[[element]] [[loadMapData]] ( [[xmlnode]] node, [[element]] parent )
 
==Marker functions==
==Marker functions==
A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.
{{Marker_functions}}
 
[[element]] [[createMarker]] ( float x, float y, float z, [string type, float size, [[int]] r, [[int]] g, [[int]] b, [[int]] a, visibleTo=[[getRootElement]]()] )
==Matrix functions==
 
{{Shared_matrix_functions}}
bool [[destroyAllMarkers]] ()
 
==Module functions==
[[int]] [[getMarkerCount]] ()
{{Module_functions}}
 
string [[getMarkerType]] ( [[element]] marker )
 
float [[getMarkerSize]] ( [[element]] marker )
 
[[int]] [[int]] [[int]] [[int]] [[getMarkerColor]] ( [[element]] marker )
 
float float float [[getMarkerTarget]] ( [[element]] marker )
 
bool [[setMarkerType]] ( [[element]] marker, string type )
 
bool [[setMarkerSize]] ( [[element]] marker, float size )
 
bool [[setMarkerColor]] ( [[element]] marker, [[int]] r, [[int]] g, [[int]] b, [[int]] a )
 
bool [[setMarkerTarget]] ( [[element]] marker, false )
 
bool [[setMarkerTarget]] ( [[element]] marker, float x, float y, float z )
 
==Object functions==
==Object functions==
An object is a model in the world. These have collision models and can be moved and rotated at will. Any existing GTA model can be used.
{{Object_functions}}
 
[[element]] [[createObject]] ( [[int]] id, float x, float y, float z, [float rx, float ry, float rz] )
==Output functions==
 
{{Output_functions}}
bool [[destroyAllObjects]] ()
 
==Ped functions==
[[int]] [[getObjectModel]] ( [[element]] object )
{{Ped_functions}}
 
float float float [[getObjectRotation]] ( [[element]] object )
 
bool [[setObjectModel]] ( [[element]] object, [[int]] id )
 
bool [[setObjectRotation]] ( [[element]] object, float x, float y, float z )
 
bool [[moveObject]] ( [[element]] object, [[int]] time, float x, float y, float z, float rx, float ry, float rz )
 
==Pickup functions==
==Pickup functions==
[[pickup]] [[createPickup]] ( float x, float y, float z, [[int]] type, [[int]] amount/weapon, [[[int]] ammo] )
{{Pickup_functions}}
 
bool [[destroyAllPickups]] ()
 
[[int]] [[getPickupType]] ( [[pickup]] pickup )
 
[[int]] [[getPickupWeapon]] ( [[pickup]] pickup )
 
[[int]] [[getPickupHealth]] ( [[pickup]] pickup )
 
[[int]] [[getPickupAmmo]] ( [[pickup]] pickup )
 
bool [[setPickupType]] ( [[element]] pickup, [[int]] type, [[int]] amount/weapon, [[[int]] ammo] )
 
==Player functions==
==Player functions==
[[int]] [[getPlayerCount]] ()
{{Player_functions}}
 
[[int]] [[getPlayerCurrentWeaponAmmoInClip]] ( [[player]] player )
==Projectile functions==
 
{{Projectile_functions}}
[[int]] [[getPlayerCurrentWeaponID]] ( [[player]] player )
 
[[player]] [[getPlayerFromNick]] ( string nick )
 
float [[getPlayerHealth]] ( [[player]] player )
 
float [[getPlayerArmor]] ( [[player]] player )
 
[[int]] [[getPlayerLevel]] ( [[player]] player )
 
[[int]] [[getPlayerMoney]] ( [[player]] player )
 
float float float [[getPlayerMoveSpeed]] ( [[player]] player )
 
string [[getPlayerName]] ( [[player]] player )
 
[[vehicle]] [[getPlayerOccupiedVehicle]] ( [[player]] player )
 
[[int]] [[getPlayerOccupiedVehicleSeat]] ( [[player]] player )
 
[[int]] [[getPlayerPing]] ( [[player]] player )
 
float [[getPlayerRotation]] ( [[player]] player )
 
[[int]] [[getPlayerSkin]] ( [[player]] player )
 
string [[getPlayerSourceIP]] ( [[player]] player )
 
[[player]] [[getRandomPlayer]] ()
 
bool [[isPlayerDead]] ( [[player]] player )
 
bool [[isPlayerDucked]] ( [[player]] player )
 
bool [[isPlayerMuted]] ( [[player]] player )
 
bool [[setPlayerRotation]] ( [[element]] player, float rotation )
 
bool [[setPlayerSkin]] ( [[element]] player, [[int]] id )
 
bool [[setPlayerHealth]] ( [[element]] player, float health )
 
bool [[setPlayerArmor]] ( [[element]] player, float armor )
 
bool [[setPlayerMoney]] ( [[element]] player, [[int]] money )
 
bool [[givePlayerMoney]] ( [[element]] player, [[int]] money )
 
bool [[takePlayerMoney]] ( [[element]] player, [[int]] money )
 
bool [[killPlayer]] ( [[element]] player )
 
bool [[warpPlayerintoVehicle]] ( [[player]] player, [[vehicle]] vehicle, [[int]] seat] )
 
bool [[removePlayerFromVehicle]] ( [[element]] player )
 
bool [[spawnPlayer]] ( [[player]] player, [[spawnpoint]] spawnpoint )
 
bool [[spawnPlayer]] ( [[player]] player, float x, float y, float z, float rotation, [[int]] skin )
 
==Radar area functions==
==Radar area functions==
[[radararea]] [[createRadarArea]] ( float x, float y, float sizex, float sizey, [[int]] r, [[int]] g, [[int]] b, [[int]] a, [visibleTo=[[getRootElement]]()] )
{{Radar_area_functions}}
 
bool [[destroyAllRadarAreas]] ()
==Resource functions==
 
{{Resource_functions}}
float float [[getRadarAreaSize]] ( [[radararea]] radararea )
 
[[int]] [[int]] [[int]] [[int]] [[getRadarAreaColor]] ( [[radararea]] radararea )
 
bool [[isRadarAreaFlashing]] ( [[radararea]] radararea )
 
bool [[setRadarAreaSize]] ( [[element]] radararea, float x, float y )
 
bool [[setRadarAreaColor]] ( [[element]] radararea, [[int]] r, [[int]] g, [[int]] b, [[int]] a )
 
bool [[setRadarAreaFlashing]] ( [[element]] radararea, bool flash )
 
==Scoreboard functions==
bool [[addScoreboardColumn]] ( string id, string name, float width )
 
bool [[removeScoreboardColumn]] ( string id )
 
==Server functions==
==Server functions==
[[int]] [[getMaxPlayers]] ()
{{Server_functions}}
 
bool [[serverLoggerPrint]] ( string text )
==Settings registry functions==
 
{{Settings_registry_functions}}
bool [[serverChat]] ( string text, [r, g, b] )
 
==SQL functions==
bool [[playerPM]] ( [[element]] player, string text, [r, g, b] )
{{SQL_functions}}
 
bool [[outputDebugString]] ( string text, [[[int]] level=3] )
==Team functions==
 
{{Team_functions}}
bool [[addCommandHandler]] ( string key, string handler )
 
==Text functions==
bool [[removeCommandHandler]] ( string key )
{{Text_functions}}
 
==spawnpoint functions==
float [[getspawnpointRotation]] ( [[spawnpoint]] spawn )
 
[[int]] [[getspawnpointSkin]] ( [[spawnpoint]] spawn )
 
bool [[setspawnpointRotation]] ( [[element]] spawn, float rotation )
 
bool [[setspawnpointSkin]] ( [[element]] spawn, [[int]] skin )
 
==Text Functions==
textdisplay [[textCreateDisplay]] ()
 
void [[textDestroyDisplay]] ( textdisplay )
 
textitem [[textCreateTextItem]] ( [text, x, y, priority, red, green, blue, alpha, scale] )
 
void [[textDestroyTextItem]] ( textitem )
 
void [[textDisplayAddText]] ( textdisplay, textitem )
 
void [[textDisplayAddObserver]] ( textdisplay, player )
 
void [[textItemSetText]] ( textitem, text )
 
string [[textItemGetText]] ( textitem )
 
void [[textItemSetScale]] ( textitem, scale )
 
float [[textItemGetScale]] ( textitem )
 
void [[textItemSetPosition]] ( textitem, x, y )
 
float float [[textItemGetPosition]] ( textitem )
 
void [[textItemSetColor]] ( textitem, red, green, blue, alpha )
 
[[int]] [[int]] [[int]] [[int]] [[textItemGetColor]] ( textitem )
 
void [[textItemSetPriority]] ( textitem, priority )
 
[[int]] [[textItemGetPriority]] ( textitem )
 
==Utility functions==
==Utility functions==
float [[getDistanceBetweenpoints2D]] ( float x1, float y1, float x2, float y2 )
{{Utility_functions}}
 
float [[getDistanceBetweenpoints3D]] ( float x1, float y1, float z1, float x2, float y2, float z2 )
==UTF8 Library==
 
{{UTF8_functions}}
[[int]] [[rand[[int]]]] ( [[int]] lowerbound, [[int]] upperbound )
 
float [[randFloat]] ()
 
[[int]] [[getTickCount]] ()
 
string [[gettok]] ( string text, [[int]] index, [[int]] separator )
 
bool [[setTimer]] ( string function, [[int]] time, [arg1, arg2, ...] )
 
==Vehicle functions==
==Vehicle functions==
vehicle [[createVehicle]] ( [[int]] id, float x, float y, float z, [float rx, float ry, float rz] )
{{Vehicle_functions}}
 
bool [[destroyAllVehicles]] ()
==Water functions==
 
{{Water_functions}}
[[int]] [[int]] [[int]] [[int]] [[getVehicleColor]] ( [[vehicle]] vehicle )
 
float [[getVehicleHealth]] ( [[vehicle]] vehicle )
 
[[int]] [[getVehicleID]] ( [[vehicle]] vehicle )
 
[[int]] [[getVehicleIDFromName]] ( string name )
 
[[int]] [[getVehicleIndex]] ( [[vehicle]] vehicle )
 
float float float [[getVehicleMoveSpeed]] ( string vehicle )
 
string [[getVehicleName]] ( string vehicle )
 
string [[getVehicleNameFromID]] ( [[int]] id )
 
player [[getVehicleOccupant]] ( [[vehicle]] vehicle, [[[int]] seat=0] )
 
float float float [[getVehicleRotation]] ( [[vehicle]] vehicle )
 
float float float [[getVehicleTurnSpeed]] ( [[vehicle]] vehicle )
 
float float [[getVehicleTurretPosition]] ( [[vehicle]] vehicle )
 
[[int]] [[getVehicleMaxPassengers]] ( [[vehicle]] vehicle )
 
bool [[isVehicleLocked]] ( [[vehicle]] vehicle )
 
bool [[fixVehicle]] ( [[element]] vehicle )
 
bool [[blowVehicle]] ( [[element]] vehicle, [bool explode=true] )
 
bool [[setVehicleRotation]] ( [[element]] vehicle, float rx, float ry, float rz )
 
bool [[setVehicleMoveSpeed]] ( [[element]] vehicle, float x, float y, float z )
 
bool [[setVehicleTurnSpeed]] ( [[element]] vehicle, float rx, float ry, float rz )
 
bool [[setVehicleHealth]] ( [[element]] vehicle, float health )
 
bool [[setVehicleColor]] ( [[element]] vehicle, [[int]] color1, [[int]] color2, [[int]] color3, [[int]] color4 )
 
bool [[setVehicleLocked]] ( [[element]] vehicle, bool locked )
 
==Weapon functions==
==Weapon functions==
string [[getWeaponNameFromID]] ( [[int]] id )
{{Weapon_functions}}
 
[[int]] [[getWeaponIDFromName]] ( string name )
 
bool [[giveWeapon]] ( [[element]] player, [[int]] [[weapon]], [[[int]] ammo=30] )
 
bool [[takeWeapon]] ( [[element]] player, [[int]] [[weapon]] )
 
bool [[takeAllWeapons]] ( [[element]] player )
 
==World functions==
==World functions==
[[int]] [[int]] [[getTime]] ()
{{World_functions}}
 
[[int]] [[getWeather]] ()
 
bool [[setTime]] ( [[int]] hour, [[int]] min )
 
bool [[setWeather]] ( [[int]] id )
 
bool [[setWeatherBlended]] ( [[int]] id )
 
==XML functions==
==XML functions==
xmlnode [[xmlFindSubNode]] ( parent, subnode, index )
{{XML_functions}}
 
string [[xmlNodeGetValue]] ( xmlNode )
 
bool [[xmlNodeSetValue]] ( xmlNode, value )
 
string [[xmlNodeGetAttribute]] ( xmlNode, attribute name )
 
bool [[xmlNodeSetAttribute]] ( xmlNode, attribute name, value )
 
xmlnode [[xmlLoadFile]] ( filename )


bool [[xmlUnloadFile]] ( xmlnode )
[[ar:Server Scripting Functions]]
[[de:Server-Seitige Scripting Funktionen]]
[[en:Server Scripting Functions]]
[[es:Funciones_del_Server]]
[[hu:Server Scripting Functions]]
[[pl:Server Scripting Functions]]
[[pt-br:Funções de Scripting do Servidor]]
[[ru:Server Scripting Functions]]
[[tr:Server Scripting Functions]]
[[zh-cn:Server Scripting Functions]]

Latest revision as of 15:13, 7 August 2023

Contributors: Did you create a page but it's not on this list? Confused? Read: 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, create an issue in our GitHub repository.

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 page.

Client-side scripting functions can be found here: Client Scripting Functions.

Account functions


ACL functions


Admin functions


Audio functions


Announcement functions


Blip functions


Camera functions


Clothes and body functions


Collision shape functions


Cursor functions


Element functions


Event functions


Explosion functions


File functions


HTTP functions

These functions can only be used from within lua blocks in HTML pages hosted by the server


Input functions


Map functions


Marker functions


Matrix functions


Module functions


Object functions


Output functions


Ped functions


Pickup functions


Player functions


Projectile functions


Radar area functions


Resource functions


Server functions


Settings registry functions


SQL functions


Team functions


Text functions


Utility functions


UTF8 Library


Vehicle functions


Water functions


Weapon functions


World functions


XML functions