Server Scripting Functions: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
 
(297 intermediate revisions by 64 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}}
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.]


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.
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 [[Module functions]] for a list of non-native functions and modules that are available.
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==
'''Shared'''
{{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]]()] )
'''Shared'''
 
{{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]]()] )
 
bool [[destroyBlipAttachedTo]] ( [[entity]] entity )
 
bool [[destroyAllBlips]] ()


int [[getBlipIcon]] ( [[blip]] blip )
==Camera functions==
'''Shared'''
{{Camera functions}}


int [[getBlipSize]] ( [[blip]] blip )
==Clothes and body functions==
'''Shared'''
{{Clothes and body functions}}


int int int int [[getBlipColor]] ( [[blip]] blip )
==Collision shape functions==
'''Shared'''
{{Collision shape functions}}


blip [[getBlipAttachedTo]] ( [[entity]] entity )
==Cursor functions==
 
'''Shared'''
bool [[setBlipIcon]] ( [[element]] blip, int icon )
{{Cursor functions}}
 
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|server}}
 
[[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|server}}
==Explosion functions==
'''Shared'''
{{Explosion functions}}


bool [[addEventHandler]] ( string name, [[element]] element, string handler )
==File functions==
 
'''Shared'''
bool [[triggerEvent]] ( string name, [[element]] element, [argument, ...] )
{{File functions}}


==HTTP functions==
{{HTTP functions}}
==Input functions==
{{Input functions|server}}
==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.
'''Shared'''
 
{{Marker functions}}
[[element]] [[createMarker]] ( float x, float y, float z, [string type, float size, int r, int g, int b, int a, visibleTo=[[getRootElement]]()] )
 
bool [[destroyAllMarkers]] ()
 
int [[getMarkerCount]] ()
 
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 )
==Matrix functions==
'''Shared'''
{{Matrix functions}}


==Module functions==
{{Module functions}}
==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.
'''Shared'''
 
{{Object functions}}
[[element]] [[createObject]] ( int id, float x, float y, float z, [float rx, float ry, float rz] )
 
bool [[destroyAllObjects]] ()
 
int [[getObjectModel]] ( [[element]] object )
 
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 )


==Output functions==
{{Output functions|server}}
==Ped functions==
{{Ped functions|server}}
==Pickup functions==
==Pickup functions==
[[pickup]] [[createPickup]] ( float x, float y, float z, int type, int amount/weapon, [int ammo] )
{{Pickup functions|server}}
 
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|server}}
 
int [[getPlayerCurrentWeaponAmmoInClip]] ( [[player]] player )
==Projectile functions==
 
'''Shared'''
int [[getPlayerCurrentWeaponID]] ( [[player]] player )
{{Projectile_functions}}
 
[[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]]()] )
'''Shared'''
 
{{Radar functions}}
bool [[destroyAllRadarAreas]] ()
 
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 )


==Resource functions==
{{Resource functions|server}}
==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|server}}
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|server}}
 
float [[getDistanceBetweenPoints3D]] ( float x1, float y1, float z1, float x2, float y2, float z2 )
==UTF8 Library==
 
'''Shared'''
int [[randInt]] ( int lowerbound, int upperbound )
{{UTF8 functions}}
 
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|server}}
 
bool [[destroyAllVehicles]] ()
==Water functions==
 
'''Shared'''
int int int int [[getVehicleColor]] ( [[vehicle]] vehicle )
{{Water functions}}
 
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|server}}
 
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|server}}
 
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 )
'''Shared'''
 
{{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 )


bool [[fakefunctionexample]] ( 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 22:34, 6 September 2024

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

Shared



Announcement functions


Blip functions

Shared


Camera functions

Shared



Clothes and body functions

Shared


Collision shape functions

Shared


Cursor functions

Shared



Element functions



Event functions



Explosion functions

Shared


File functions

Shared


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

Shared



Matrix functions

Shared


Module functions


Object functions

Shared



Output functions



Ped functions



Pickup functions



Player functions



Projectile functions

Shared



Radar area functions

Shared


Resource functions



Server functions


Settings registry functions


SQL functions


Team functions



Text functions


Utility functions



UTF8 Library

Shared


Vehicle functions



Water functions

Shared



Weapon functions



World functions



XML functions

Shared

Retrieved from "https://wiki.multitheftauto.com/wiki/Server_Scripting_Functions?oldid=80370"