Search results

{{Note|El '''player''' quien clickeo el elemento siempre será [[localPlayer]].}} {{Note|Si usted desea saber más sobre triggers... Mire [[addEventHandler]]}}

{{Note|Moved to https://github.com/multitheftauto/mtasa-blue/wiki/CAccountPassword

{{Note|Wielokrotne łączenie i rozłączanie może mieć wpływ na wydajność se {{Note|Jeśli używasz MySQL 8 lub nowszego, dodaj tą linię do mysqld.cnf '''<no

* '''"container_drag"''' // drag container cursor (note: not in use) * '''"segment_moving"''' // segment moving cursor (note: not in use)

{{Note|The function will return ''false'' server-side if far clip distance has not {{Note|Default far clip distance value is 800.}}

{{Note|Please note the loading order that is used in the examples as other orders can cause co {{Note|Collision libraries (.col files containing multiple collision models) are n

{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]]. {{Note|If you want to ask why everything is triggered... See the forth parameter o

==Note==

{{Note|The function will not reset far clip distance client-side, unless it is rel {{Note|The function will reset the far clip distance to ''false'' server-side, as

{{Note|This event works only with weapons which have enabled bullet sync.}} ...which was hit by a shot. Currently this can be only another [[player]]. '''Note: hitElement could be incorrect and should not be relied upon.'''

{{Note|Using attachElements with the camera and the main player can interfere with {{Note|Using setElementPosition/Rotation/Matrix on the camera element will automat

The event is triggered when the whitelist has changed. Note that this event is only triggered if the request window was confirmed by ac {{Note|Attaching the event to a webbrowser won't work. Attach it to the root eleme

{{Important Note|The client-side version of this function can only be used on client-created {{Note|This function does not change when an element will be destroyed - Elements

{{Note| Returns an integer between '''25''' and '''32767''' (refer to the note above) of the maximum FPS that players can run their game at.

__NOTOC__{{Note|Please note the loading order that is used in the example as other orders can cause col {{Note|Collision libraries (.col files containing multiple collision models) are n

{{Note| attachElements استخدام هذا الفنكشن مع الكاميرا {{Note| [[setCameraTarget]] سوف يمسح اوتوماتيكياً هدف setEle

{{Note|Vehicles that are collisionless and have a driver will cause bugs.}} {{Note|Enabling a players collisions when they're inside a vehicle will cause bugs

{{Note|[[setCameraFieldOfView]] overrides the user game option in '''''Settings->V {{Note|[[setCameraFieldOfView]] does not affect the FOV for the following camera m

{{Note|[[setCameraFieldOfView]] overrides the user game option in '''''Settings->V {{Note|[[setCameraFieldOfView]] does not affect the FOV for the following camera m

{{Important Note|You can not use this function to draw vehicles and ped}} {{Important Note|This function doesn't obey any streaming limits, you can draw as many model

==Note==

{{Important Note|To reset the application ID, please use [[resetDiscordRichPresenceData]]}} {{Important Note|In order for the function to work correctly, the user must have their activ

==Note==

==Note:==

...r: 1px dotted blue; background: #00CC66;padding:4px;margin-bottom:2px;">'''Note''': This event should only be used as a low-level function for advanced us __NOTOC__ {{Note|This event triggers inconsistently (https://github.com/multitheftauto/mtasa

{{Important Note|This event should only be used as a low-level function for advanced users. __NOTOC__ {{Note|This event triggers inconsistently (https://github.com/multitheftauto/mtasa

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl {{Note|For the party size to be displayed, the state must be set [[setDiscordRichP

...ments already existing at that location until they first move. Please also note that before 1.0.3, this did not function correctly when moving a colshape. Please note that this function doesn't verify whether element is in the same dimension

==Note==

{{Note|MTA won't show any tray notifications if the MTA window is focused, because {{Note|You can only show a tray notification every 30 seconds.}}

{{Note|Before using this function you need to setup an initial value of element da {{Note|Calling [[removeElementData]] or [[setElementData]] with other sync mode wi

{{Important Note|Use [[decodeString]] instead, because teaEncode inflates the file size by a {{Important Note|teaDecode cannot handle binary data.}}

This function returns the number of children an element has. Note that only the direct children are counted and not elements that are further Note that this does not only count spawnpoint elements, but all child elements.

{{Note|unbindKey will only work on binds that were added by the same resource}} {{Note|unbindKey on the server may return ''true'' on failure}}

{{Note|DGS elements are always destroyed when the resource that created them is st {{Note|dgsSetParent only works with DGS elements.}}

''Note: does not include small ID lists related to specific functions or IDs creat *[[Weather]] ''Note: blended weather allows for many more undocumented effects''

{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]]. {{Note|If you want to ask why everything is triggered... See the forth parameter o

{{Note|Ta funkcja nie zadziała jeśli element jest zniszczony - Elementy DGS są {{Note|dgsSetParent działa tylko na elementy DGS.}}

...f it's archived by using the object oriented method. '''(It's important to note that you need to enable OOP in meta.xml to use this)''' ...it's archived by using the object oriented variable. '''(It's important to note that you need to enable OOP in meta.xml to use this)'''

__NOTOC__{{Note|Please note the loading order that is used in the examples as other orders can cause co

'''Note:''' To prevent infinite loops, debug messages that occur inside the functio **'''Note:''' may return [[nil]] when the source could not be found.

This function can be used to join a channel. Note that a delay of 2-3 seconds should be used before calling this function ins '''Note:''' Does not return ''true'' if ircbot successfully joined or ''false'' if

:warning: '''Note''': If you don’t follow this requirement before require the SDK, composer === Note for Python ===

{{Note|These sounds can be disabled with [[setWorldSoundEnabled]] so if these soun {{Note|These sounds don't work when [[fadeCamera]] has been used to make the scree

'''Note:''' You can use the function [[gettok]] to retrieve a single token from the {{note|Unicode characters work but when combined with others do not. E.g: #split("

__NOTOC__{{Note|Please note the loading order that is used in the example as other orders can cause col

'''Note:''' The maximum number of simultanuous connections is 5. There is no limit '''Note:''' Does not return ''true'' if ircbot was successfully connected or ''fals

{{Note|This event will not trigger when [[onDgsMouseClick]] is cancelled.}} ...ate:''' The state of the mouse button. Can be ''down'' or ''up''. ( Please note that '''both''' ''up'' and ''down'' state are supported! )

'''This article concerns the note left in [[attachElements]].''' ...local mainRot = { 0, 0, 90 } -- Two rotations are zero. See note in attachRotationAdjusted

{{Note|This event will not trigger when [[onDgsMousePreClick]] is cancelled.}} ...ate:''' The state of the mouse button. Can be ''down'' or ''up''. ( Please note that '''both''' ''up'' and ''down'' state are supported! )

...roup will have the permissions specified on the "Default" acl name list. ''Note: You will notice this group is special, in that it includes every user and ...er down the ACL and you will see the '''<acl name="Default" />''' listing. Note I have trimmed this list dramatically due to its length.

{{Note|This event does not work correctly pre 1.3.1-9-04627 {{Note|This event is triggered ahead of a sound beat the number passed is the play

{{Note|The '''player''' who clicked the gui-element is always the [[localPlayer]]. ...'' if the mouse button was pushed, or ''up'' if it was released. '''Please note currently only the ''up'' state is supported.'''

-- Note: The following values are not scaled. See second example for how to scale i Note: offsetY is 0.

{{note| Don't forget to give admin rights to the resource, in which you are using *'''responsiblePlayer:''' The player that is responsible for the event. '''Note''': If left out as in the second syntax, responsible player for the kick wi

{{Note|The resource using this function needs access to ''function.refreshResource '''Note:''' Checking for changes in all resources can result in lag for a short per

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin Note = DGSElement:setAlpha|

{{Note|This event is '''ONLY''' for custom weapons that were created with [[create {{Note|This event is only triggered for custom weapons that are streamed in}}

{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]]. {{Note|If you want to ask why everything is triggered... See the forth parameter o

'''Note:''' To prevent infinite loops, debug messages that occur inside the functio **'''Note:''' May return [[nil]] when the source could not be found

{{Note|This event is only for custom weapons that were created with [[createWeapon {{Note|This event is only triggered for custom weapons that are streamed in}}

{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]]. {{Note|If you want to ask why everything is triggered... See the forth parameter o

Note that most vehicles don't need more than two colors. You can specify a veh

{{Note|You should avoid triggering events on the [[root element]] unless you reall {{Note|See [[Event_Source_Element|Event Source Element]] for a descriptive visuali

{{Note | This event only triggers from fullscreen minimize. [[onClientRestore]] ca

{{Important Note|This function should only be used as a low-level function for advanced user ( '''note:''' use setPlayerVoiceMuted function if you are using the voice resource mo

{{Note|This function only works in development mode.}}

...amName''': The name of the stream. Note that this isn't the filename. Also note that this isn't always provided

'''Note''': Like all GUI functions, these are only available client side

{{Note|Availiable only in custom fork of mta. see https://github.com/multitheftaut

__NOTOC__{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as sho ...value:''' The value you wish to store. Set to false to remove the data. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

{{Note|The event will not be triggered if the message can be processed by an exist :'''NOTE:''' this script is for example purposes only. This can be done in a more ef

{{Note|Using '''passwordHash''' is the recommended way of storing passwords.}} *'''hash:''' A supported hash (see [[passwordHash]]). <span style="color:red">Note that only the prefix ''$2y$'' is supported for type bcrypt (older prefixes

''Note: To see a complete list of what each level does, refer to GTASA's weapon.da ''Note that the levels only change to the skill 'Gangster'''

===Note===

{{Note| Essa função não funciona com arquivos WAV remotos.}} {{Note|Se nenhuma informação estiver associada à um metadado, ele não será in

{{Note|1=Client side [[IsPedInVehicle]] only returns ''true'' if the ped is physic {{Note|1=Server side [[IsPedInVehicle]] returns whether the ped is entering, insid

{{Note|Enabling development mode on the server side does '''not enable''' it on th It is important to note that this example has to be in a client side script. Otherwise, the executi

{{Note|This function only works on synced peds and vehicles (ie. created serversid {{Note|This function only works within the following limits:

{{note|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5. {{note|Vehicle unique features may be unsupported, see [https://github.com/multith

This event is triggered when a [[resource]] is started. Please note that this is '''not''' triggered the same time as the serverside event [[on

{{Note|This event can not be cancelled.}}

'''Note 1:''' The escape key can only be cancelled once. If a user presses the esca '''Note 2:''' The event is only cancellable when the key is being pressed, not when

{{Important Note|Due to technical limitations (partly of json-c) the stringified keys will b <!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

__NOTOC__{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as sho ...unt of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the play

{{Note|Esses efeitos sonoros podem ser desabilitados utilizando a função [[setWo {{Note|Esses efeitos sonoros não funcionarão com a camera apagada (quando você

{{Note|To prevent memory leaks, ensure each call to [[xmlCreateFile]] has a matchi :Note that if a different resource than default is being accessed, the caller res

...se many different commands, affecting the players using the server. Please note that only console commands can be used, and that some commands can not be u

__NOTOC__{{Note|Please note the loading order that is used in the example as other orders can cause col

{{Note|Calling loadBrowserURL right after [[createBrowser]] will not work normally

{{note| Don't forget to give admin rights to the resource, in which you are using {{Note|The password will always be encrypted with '''sha256''', other types are no

{{Note|The function will reset the fog render distance to ''false'' server-side, a

This event is triggered when the local player enters text in the console. Note that, if you want to add custom console commands, it is easier to use the [

{{Note|This function only works in development mode.}}

{{Note|Avoid calling setPedLookAt every frame as this can cause bugs like being in {{Important Note|For remote players, you have to use [https://wiki.multitheftauto.com/wiki/S

Note that after a timer has completed all its iterations, it is destroyed and an

Note that the collision reported by this event doesn't always damage the vehicle {{Note|This event is only triggered for vehicles that are streamed in}}

{{Note|You can't use enter_exit or enter_passenger on a ped. Please use [[setPedEn {{Note|To make a ped crouch, set the control to ''true'' and reset to ''false'' af

{{Note|The function will return ''false'' server-side if fog distance has not been

{{Important Note| '''Note: There is no encryption parameter in this function, because xmlDeleteData w

{{Important Note|This event should only be used as a low-level function for advanced users.

Note: Not all control states are sent to the server at all times, as such their '''Note:''' several controls are not synched with the server, therefore the functio

__NOTOC__{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as sho ...unt of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the play

{{Note|This function only works in development mode.}}

{{Note| ...URL (http://, https:// or ftp://) of the sound file you want to play. ('''Note:''' Playing sound files from other resources requires the target resource t

{{Note|Weapons are removed when a ped dies by default. This means that it is only

{{PL/Note|Wywoływanie loadBrowserURL tuż po [[createBrowser]] nie działa prawidło

{{Note| If you want to access the name of any ''resource-data'' you should use [[g

* Note the supplied 7 digit code {{Note|Authorized Serial Account Protection helps prevent your server from getting

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|The function will return ''false'' server-side if moon size has not been se

{{Note|

'''Note:''' The server can only return the heat haze settings if it has actually be

{{Note|This event isn't triggered within the resource starting.}}

{{Note|One of the three: IP, Username or Serial have to be specified.}} {{note| Don't forget to give admin rights to the resource, in which you are using

...usar vários comandos diferentes, afetando os jogadores usando o servidor. Note que somente comandos de console podem ser usados, e que alguns comandos nã

{{Note|Use [[getPedTask]] to monitor what movements the player is currently doing. ...xample shows what block and animation your player is currently performing. Note this will return "N/A" if you did not set an animation with [[setPedAnimati

{{Note|This event is triggered for <b>players</b> only. Attaching this event to a

{{Server client function}}{{Important Note|The speed at which a client side timer runs can be completely unreliable if {{Important Note|Writing the following code can cause performance issues. Use [[onClientPreR

{{Note|This function only works in development mode.}}

{{Note|This event is only triggered for players that are streamed in}} {{Note|This does not trigger for any player's melee weapons or for remote player's

This function converts server ticks to a unix timestamp. '''Note''': this was built to work with the server tick timestamp returned by [[onP

{{Note|This event is only triggered for vehicles that are streamed in}}

{{Note|If property "AlwaysOnTop" sets to "True", this function will return false .

==Other things to note==

{{Note|A ped voice is one of the GTA built in voice character types. Not to be con

__NOTOC__{{Note|Es muy importante que nombres tus claves de la forma ''modulo.clave'', como ...unt of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the play

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Note|You should use [[requestBrowserDomains]] first to request permission to loa {{Note|Calling loadBrowserURL right after [[createBrowser]] will not work normally

{{Note|This event triggers regardless of whether the command exists in a script or Also, note, that if the server freezes for a frame and a player executes a command 2x

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

* '''Note:''' The bot can't join multiple servers.

{{Note|You cannot rely on this function to get the focus state of the MTA window -

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

{{Important Note| ...ript will generate a random key and use it to encrypt your stored data. '''Note: If you want to store "sensitive data", always use encryption!'''

{{Note|A ped voice is one of the GTA built in voice character types. Not to be con

{{Note|X and Y positions will be changed to an even integer. i.e. -2, 0, 2, 4 etc. {{Important Note|If you're working with dimensions, be sure to apply it by using [[setElemen

{{Note|This event is only triggered for objects that are streamed in}}

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Note|Calls may incur a performance overhead - they are not equivalent in perform {{Important Note|The sourceResource and sourceResourceRoot "hidden" variables are available

'''Note: You can not remove the built-in size handler of dgs window.'''

{{Note|Occlusions are used by GTA to enhance performance by hiding objects that ar

...he car of the other user then you can see the car make strange moves. Also note that traffic and peds were not synced.

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

{{Note|You can only execute commands created with addCommandHandler. You cannot ex {{Note|Serverside commands can only be executed by the server. The same applies to

'''Note:''' The server can only return the sky color if it has actually been set by

...ient side created peds however you can use it on a server side ped, though note that the weapon wouldn't be synced between clients unless your script gives {{Note|

{{Note|It's possible for a player to fake the value returned from getPlayerSerial {{Important Note|You should '''use this function''' in conjunction '''with account system'''

'''Note: You can not remove the built-in move handler of dgs window.'''

{{Note|To prevent memory leaks, ensure each successful call to [[fileCreate]] has {{Note|The file functions should not be used to implement configuration files. It

{{Note|This event is not triggered prior to r21247.}}

{{Note|Only breakable objects can be broken.}}

{{Note|If the [[sound]] [[element]] is destroyed by [[destroyElement]] the loop wi

{{Note|This function isn't accurate. The function works more like ''try to free up

** '''Note:''' The level value is clamped between 0.0 and 10.0 to avoid gameplay issue

{{Note|The function will return ''false'' server-side if sun size has not been set

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

:'''Note:''' Validity of the bot names are not checked. Make sure you enter a name t

'''DP2 note:''' Don't call this on players that have not spawned. This will crash the c

{{Note|Clientside will return the version from the player, and the server-sided wi {{Note|Current <!-- Newest --> server version: {{CurrentVersion}}}}

'''Note:''' Results may be late sometimes three days.

{{Important Note|See [[Script security]] for how-to prevent cheaters from abusing [[event sy ...ple handler functions are used, as this can lead to confusion. On the same note, for multiple reasons, it isn't a good idea to export the same functions th

{{Note|

{{Note|Useless function, use [[DxDrawLine3D]] or [[DxDrawMaterialLine3D]] instead. * '''NOTE:''' This is made to be used clientside!.

{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as sho ...unt of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the play

'''Note: You can not check the built-in size handler of dgs window.'''

{{Note|Always returns 3 if paintjobs are not supported for the vehicle.}}

{{Note|This event is only triggered for peds that are streamed in}}

===Important Note===

{{Note|This function only handles the cursor state set by the [[showCursor]] funct {{Note|If you use this function on the server-side, keep in mind that it only dete

...DGS:dgsCreateComboBox(20,30,150,20,"Checked ComboBox",false,dgsWindow) -- note the parameter after header, it will create a ComboBox

{{Note|You can fade up to 3 values at the same time, as long as they are properly {{Note|If you need to start another fade while this function is already fading som

'''NOTE:''' Valószínű, hogy a colorR/G/B értékek a szabványos color="#RRGGBB"

'''Note: You can not check the built-in move handler of dgs window.'''

{{PL/Note|Bronie zostają domyślnie usunięte kiedy gracz lub ped zginie. To znaczy,

{{Note| Every resource has a predefined global variable called ''resource'' that c

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

{{Note|The camera rotation angle returned by this function is 360º - α (where α

'''Note:''' this will fail but return true if

{{Note|See [[getPedTask]] to get a ped's task.}}

{{Note|The height of a combobox must be enough to fit the drop down menu, else the ...height of the GUI combobox. This is affected by the ''relative'' argument. Note: height must be enough to fit the drop down menu, else the drop down won't

{{Important Note|The event is not triggered when only the dimension changes of the player. S

{{Note|You should do a 'setDevelopmentMode(true, true)' before using this function

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Note|This function is different from [[dgsAttachToTranslation]]. See detail info

...r: 1px dotted blue; background: #00CC66;padding:4px;margin-bottom:2px;">'''Note''': This event should only be used as a low-level function for advanced us

{{Important Note|The element type which you type must be a '''string'''.}}

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

...able over all the [[account]]s that exist in the server internal.db file. (Note: accounts.xml is no longer used after version 1.0.4)

{{Note|Using this function on a player voice sound element is not supported at thi

__NOTOC__ {{Note|NEVER use serials for anything too critical (like handling admin rights, or ...done in the default Admin panel (under "AC Detected" on player info), but note that if your server has a high amount of problems due to duplicated serials

{{Important Note|Before r21155 ([https://github.com/multitheftauto/mtasa-blue/commit/3157905 ...me the SVG texture is updated (for example, via [[svgSetDocumentXML]]). '''Note''': if present, this will overwrite the current callback stored on the svg

{{Note|Please note the loading order that is used in the examples as other orders can cause te

{{Note|This function requires the resource to have 'ModifyOtherObjects' [[ACL]] ri

*'''oldValue''': The previous value. Please note that this value is in [[JSON]]. To get a normal Lua value, use [[fromJSON]]

{{Server client function}}{{Note|This function is equivalent to the [[Vector3]] class ''getLength'' method w ''Lua note: Using multiple return values as arguments for another function can only be

...DGS:dgsCreateComboBox(20,30,150,20,"Checked ComboBox",false,dgsWindow) -- note the parameter after header, it will create a ComboBox

{{PL/Note|Zawsze zwraca 3 jeśli dany pojazd nie obsługuje malowań}}

{{Note|If the width of all columns exceeds 0.95 horizontal scrollbar will appear.}

{{Note|This function has a few issues, see below. Consider using the clientside fu

'''Note:''' Indices of a JSON object such as "1": "cat" are being returned as [[str

{{Note|You may want to read up on [https://www.w3.org/International/wiki/Case_fold

'''NOTE''': The code must be in a separated resource. It will be responsible to be

'''Note''': After using this function you won't be able to change the drop-down box

'''Note:''' inside a bound render function, you can also use the predefined variabl

{{Note|This event is only triggered for peds that are streamed in}}

{{Note|If the player is using a hexcode in front of their name, it will override t <!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

* '''NOTE:''' This is made to be used clientside! Use string.format ( "%X", num ) to

{{Note|By default all these glitches are disabled - use this function to '''enable

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Note|Not all effects support rotation (e.g. the "fire" - effect doesn't).}} {{Note|All effects have their own duration.}}

Note: the data returned may not reflect the actual handling of a particular vehi

{{Note| ...dPath:''' raw data or [[filepath]] to the sound file you want to play. ('''Note:''' Playing sound files from other resources requires the target resource t

{{Note|The distance value is only available when the element is streamed in, other

{{Note|The resource that's using this function needs the right to remove an acl.}}

{{Note|It can be used to get the [[element]] responsible for a specific [[outputCh

{{Note|The resource that's using this function needs the right to remove an acl.}}

{{Note|This event is only triggered for players that are streamed in}}

{{Note| *'''fpsLimit:''' An integer value representing the maximum FPS. Refer to the note above for possible values. You can also pass '''0''' or '''false''', in whi

{{Note|If you want to remove the data in client side you can use 'setElementData(e

{{Note|Se o elemento de [[sound|áudio]] foi destruído por [[destroyElement]] a r

...DGS:dgsCreateComboBox(20,30,150,20,"Checked ComboBox",false,dgsWindow) -- note the parameter after header, it will create a ComboBox

'''Note:'''

{{Important Note|To use this function, you must set up your own application [[setDiscordAppl

{{Note| This function does not stop the resource immediately, so don't expect that

{{Important Note|[[toggleVehicleRespawn]] must be set to true for this function to have any

{{Important Note|The function will correctly return the UserID if the user has given consent

{{Note|Wersja funkcji [[getPlayerSerial]] po stronie klienta jest przestażała, g

__NOTOC__ {{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as sho *'''value:''' The value you wish to store. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.

* '''NOTE:''' This need more testing specially in deeps trees.

{{Note| This function can also be used to get the resource name of any ''resource-

'''Note: You have to put all the files of the .zip into a folder called "xmlData" a '''Note: These functions are available for Server and Client'''

''Note: A more efficient way to do this would be to use the [[onPlayerTarget]] eve

''Note: A more efficient way to do this would be to use the [[onPlayerTarget]] eve

'''''NOTE:''''' The server where your map will be played must also have the resource '''''NOTE: '''''Time is in '''milliseconds'''! (1 second = 1000 milliseconds) If you

Note = The '''Variable''' It's a table and has the following using:

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

'''Note:'''

...al'''". Leave this to ''nil'' to use '''resource'''([[getThisResource]]). [Note: When resource stops, the style will also be unloaded]

{{Note|.قبل استعمال هذه الوظيفة 'setDevelopmentMode(true, true

{{Note| ...RL(webBrowser, "http://mta/"..getResourceName(resource).."/index.html" ) --Note: you need to specify the resource name in the url.

{{Note|Setting higher values will cause problems to the client}}

{{Note|This function cannot set more than <maxplayers> as defined in [[mtaserver.c

{{Note|There is a tool available which allows you to find bank and sound IDs easil {{Note|PlaySFX sounds are MTA driven sounds, so MTA volume affects the volume.}}

{{Important Note | Non-element MTA data types like xmlNodes or resource pointers will not be {{Note|It is marginally more efficient to pass one large event than two smaller on

Note that [[fileClose]] automatically flushes the file.

Note = The returned value it's a [[Vector2]]|

__NOTOC__ {{Important Note|If you wish to retrieve more than one element at a time, it is more efficie

{{Client function}}{{Important Note|This function usually presents bugs when trying to return the state to 0 (n

{{Important Note|[[toggleVehicleRespawn]] must be set to true for this function to have any

{{Note|This event can not be canceled.}}

...with the specified name, or ''false'' if no resource of that name exists. Note that clientside this will also return ''false'' for resources that are in t

{{Note|The function will return ''false'' server-side if wind velocity has not bee

...ke sure that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, {{Note|

{{Note|效果的速度直接取决于当前的游戏速度.}}

{{Note|You may want to read up on [https://www.w3.org/International/wiki/Case_fold

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note | This effect is not synced for peds. When the ped falls off, he will not h

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|dgsGetParent działa tylko na elementy DGS.}}

'''Note:''' Resident set size should be roughly <code>shared</code> + <code>private

{{Note|This function is not reliable as element ids are eventually recycled. Alway

{{Note|This function is different from [[dgsSetAttachTranslation]]}}

{{Note|There is a tool available which allows you to find bank and sound IDs easil {{Note|PlaySFX sounds are MTA driven sounds, so MTA volume affects the volume.}}

...roup will have the permissions specified on the "Default" acl name list. ''Note: You will notice this group is special, in that it includes every user and ...er down the ACL and you will see the '''<acl name="Default" />''' listing. Note I have trimmed this list dramatically due to its length.

{{RU/Note|это пример изменения XML в памяти. Если вам

...Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.''' *'''colorCoded:''' Set to true to enable embedded #FFFFFF color codes. '''Note: clip and wordBreak are forced false if this is set.'''

It's important to note that resources aren't started on the client until they're completely downlo

'''Note:''' If you wish to just detect a single resource being stopped, you should

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|This event is only triggered for peds that are streamed in}}

{{PL/Note|Wejście nie zostanie wykryte jeśli [[element]] który wszedł do siatki k

{{Important Note|It is strongly recommended to use this function asynchronously, as presente '''''Note''': It is usually good practice to surround table and column names with bac

{{Note|This event is only triggered for players that are streamed in}}

{{Note|You must use this function prior to calling [[loadBrowserURL]] because ever

{{Note|You can use [[GetNearestElement|getNearestElement]] for other element types

{{Note|Using this function client side (not recommended) will not change a players

{{Important Note| '''Note: There is no encryption parameter in this function, because xmlLoadData wil

...DGS:dgsCreateComboBox(20,30,150,20,"Checked ComboBox",false,dgsWindow) -- note the parameter after header, it will create a ComboBox

...the element a player is standing on. This can be a vehicle or an object. Note that the server is unable to retrieve contact elements that are created cli

'''NOTE:''' It is likely that the colorR/G/B values will be changed to the more sta

{{Note|Using this function client side (not recommended) will not change a players

{{Note| '''Note''': ID 58 doesn't work <ref>https://github.com/multitheftauto/mtasa-blue/is

{{Note|If you push a value improperly, errors or warnings will occur, which may ca

'''Note: If you push a value improperly, errors or warnings will occur, which may c

{{Note|You can use [[CountPlayersInRange|countPlayersInRange]] if you want count p

<br/><br/>'''Important Note:''' Case sensitivity of the playername is important!

{{Note|This function sometimes doesn't work when setting the radio channel to anot

* '''NOTE:''' This is made to be used clientside!.

{{Important Note|It's enough to set the texture only once if it's a render target}}

{{Note|All resources have a [[Predefined_variables_list|predefined global variable

{{Note|dgsGetParent only works with DGS elements.}}

{{Note|This function may cause performance issues with client and/or server.}}

{{Note|colt 45, sawed-off, tec-9 and uzi are always enabled for the Jetpack and ar

'''Note:''' 'ralt' may trigger both 'ralt' and 'lctrl', this is due to AltGr

{{Note|The ID in this context is the value of the 'id' data item of the element (t

{{Note|This event is only triggered for peds that are streamed in}}

'''Note:''' You can only use this function with the element types listed below.

This example lets you drop an SQL table with the command: dropsqltable. Note: This command should be restricted to admins if you use it.

'''Note that this tutorial builds on content covered in the [[Introduction to Scrip '''Note that we are now writing more code for our existing 'createRulesWindow' func

{{Important Note|Before r21155 ([https://github.com/multitheftauto/mtasa-blue/commit/3157905 '''Note:''' See [[svgSetUpdateCallback]] for setting an svg's callback function aft

{{Important Note|Server-side this functions returns false or the latest value set via [[setC

...roup will have the permissions specified on the "Default" acl name list. ''Note: You will notice this group is special, in that it includes every user and ...er down the ACL and you will see the '''<acl name="Default" />''' listing. Note I have trimmed this list dramatically due to its length.

{{Important Note|If the user has not enabled screen uploading in the settings, the function {{Note|

{{Note|This function requires the resource to have 'ModifyOtherObjects' [[ACL]] ri

{{Note|This function does not work on [[Element/Collision_shape|colshape]].}} {{Note|This function does not work on [[createElement|dummy element]].}}

*'''value:''' The value which you wish to change the attribute to. ('''Note:''' ''nil'' will delete the attribute)

'''Note:''' If 2 teams has the same color, then the first one found will be returne

{{Note|This event is only triggered for objects that are streamed in.}}

{{Note|Server side filepaths which refer to resources will work correctly even if

{{Note|This function only works on synced peds and vehicles (i.e. created server-s

{{Note|[[setNearClipDistance]] should only be used when the camera orientation is

{{Important Note | Only passenger seats are counted, the driver seat is excluded.}}

'''Note: If you push a value improperly, errors or warnings will occur, which may c

{{Note|If you are looking for a tutorial on how to use the in-game web browser and It's important to note that parsed files are run in a separate virtual machine from the rest of yo

{{Note|The XML syntax is not implemented yet, but is a representation of what it w

{{Note|The XML syntax is not implemented yet, but is a representation of what it w

{{Note|It returns an uppercase string, so make sure you string.upper() anything el

{{note| Don't forget to give admin rights to the resource, in which you are using

{{Note|See [[Script security]] for tips on preventing cheaters when using events a {{Note|For performance reasons, never use setElementData in events that fire often

Note = The '''Variable''' It's a table and has the following using:

{{Note| You can't add a map to a running resource.}}

{{Note|This event is only triggered for peds that are streamed in}}

{{Note|This function is protected by default and must be explicitly allowed in the

{{DE/Note|Diese Funktion funktioniert scheinbar manchmal nicht aus unerklärlichen Gr

addCommandHandler ( "log-in", loginPlayer ) -- Make it trigger for "/log-in", NOTE: /login is hardcored and cannot be used.

{{Note|Usar essa função com a voz do [[player|jogador]] ainda não é suportado.

{{Note|1=Rotation Z returns value in CCW (counter-clock wise). So 3 o'clock is not

...] representing the percentage of health the ped lost in the final "hit". ''Note: Only for client-side created peds.''

{{Note| * Please note the loading order that is used in the example as other orders can cause col

{{Note|The amount may vary between the server and client, you shouldn't trust the

{{Important Note|A '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' ...he Definitive Edition", ami nem kompatibilis az MTA:SA-val (lásd Important Note), így érdemes körültekintőnek lenni az online kulcs viszonteladóknál

{{Note|Streams are not supported.}}

{{Note|هو مفيد جدًا عندما تريد عمل شيء معين عند ح

{{Note| This function doesn't fix the issue of camera clip not working on objects

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

'''NOTE:''' This function already takes the client's screen resolution into account

{{Note|When vehicles are frozen waiting for collisions to load they '''do not''' o

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

...s a ped from a vehicle immediately. This works for drivers and passengers. Note that this removes the ped from the vehicle and puts him in the exact positi

{{Note|This function only works properly on objects that have the special collisio

{{Note|You should avoid triggering events on the [[root element]] unless you reall ...",5000,false,root,data) --trigger - Avoid triggering to root element (Read note above)

...s a vehicle's doors undamageable, so they won't fall off when they're hit. Note that the vehicle '''has''' to be locked using [[setVehicleLocked]] for this

{{Server client function}}{{Note|This function is equivalent to the [[Vector2]] class ''getLength'' method w

{{RO/Important Note|Această funcție utilizată server-side redă false sau cea mai recentă v

'''Note that this tutorial builds on content covered in the [[Introduction to Scrip '''Note that we are now writing more code for our existing 'createTeleportWindow' f

{{Note|This event is only triggered for players that are streamed in}}

{{Note|Setting higher values will cause problems to the client}}

** '''Note:''' [[Object]]s are fully transparent at 140.

{{Note|Your settings cannot have a period (.) in them. This character is reserved.

{{Note|You have to use [[onClientRender]] or [[onClientPreRender]] events with thi

{{Note|This function is protected by default and must be explicitly allowed in the

{{RU/Note|Эти звуки могут быть отключены с помощью

Note: you won't get this to work properly without timer and 'fake' animation. Lo

Note that successful screen source creation is not guaranteed, and may fail due

{{Note|

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|The function will return ''false'' server-side if rain level has not been s

This function turns a vehicle's engine on or off. Note that the engine will always be turned on when someone enters the driver sea

{{Note|[[getPedCameraRotation]] may not return the value set by this function. Ple

{{Note|setObjectScale '''does not''' affect the collision models for the object, a

{{Note|Using '''passwordHash''' is the recommended way of storing passwords.}} ...ypt hashing algorithm. Hash length: 60 characters. <span style="color:red">Note that only the prefix ''$2y$'' is supported (older prefixes can cause securi

'''Note:''' This function will only work '''after''' you set the item's text using

'''Note:''' Does not return ''true'' if the channel topic was successfully changed

{{Note|This function only acts upon registry.db. Use [[dbQuery]] to query a custom Below are examples of equivalents for the deprecated executeSQL functions. Note that ` (backtick) can optionally be used to surround table and row names. I

{{Note|Connecting and disconnecting many times can have a performance impact on th {{Note|If you use MySQL 8 or newer, add this line to mysqld.cnf '''<nowiki>default

{{Note|The element must be streamed in for this function to work.}}

{{RU/Note| Во всех ресурсах есть [[Predefined_variables_list|пре

'''Note:''' Does not return ''true'' if ircbot's name was successfully changed or '

{{Note|In most cases you will still need to use [[engineSetModelLODDistance]] besi

{{Note|X and Y positions will be changed to an even integer. i.e. -2, 0, 2, 4 etc. {{Important Note|If you're working with dimensions, be sure to apply it by using [[setElemen

{{Important Note|This function should only be used as a low-level function for advanced user

{{Important Note|This function uses significant process RAM, make sure you don't load a lot {{Note|The times shown at the right of the page are only the time needed to add th

...Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.''' *'''colorCoded:''' Set to true to enable embedded #FFFFFF color codes. '''Note: clip and wordBreak are forced false if this is set.'''

{{Note|Code point characters beyond the byte value range (0-127) require at least

{{Important Note|'''This function is meant for advanced users only, as it can lead to stabil

{{Important Note|'''This function is meant for advanced users only, as it can lead to stabil

{{Note| The MTA server will not advertise itself to the master server list while t

Note: every resource has a [[Predefined_variables_list|predefined global variabl

Returns the bytes that were read in a string. Note that this string might not contain as many bytes as you specified if an err

'''NOTE:''' 'theReason' kan nil zijn als 'theUser' gequit heeft zonder reden. '''NOTE:''' 'theKicker' kan false zijn als 'theUser' gekickt was door een service z

:{{RU/Note| Если вы создаете файл в другом ресурсе, д

...player from a vehicle immediately. This works for drivers and passengers. Note that this removes the player from the vehicle and puts him in the exact pos

Note: Objects can already stream from a very long distance, so even when you can

'''Note:''' You can only use this function with the element types listed below.

{{Note|The hit won't be detected if the [[element]] that entered the colshape is a

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Important Note|You should use the global variable [[Predefined_variables_list|''client'']] {{Note|It is marginally more efficient to pass one large event than two smaller on

__NOTOC__ {{Note|Be aware that this event triggers for local player (as itself being the ele

{{Note|You can also compare if a version is higher than another using the ''<'' or

{{Note|remember to set players camera mode back to "player" on resource unload, or

{{Important Note|The event is not triggered when only the dimension changes of the player. S

{{Note|Also with this function you can move specified file to a new location, new

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|The values returned by this function are sizeZ, sizeX and sizeY respectivel

Note = It variables is a conjunction:

{{Important Note|You must '''NOT''' to use this function to limit features to users that bel

{{Note|Clientside, this function will not return a correct value for remote player

{{Important Note|If you used [[setElementPosition]] to spawn the [[ped]]/[[player]], this fu

{{Note|Avoid outputting text to the chatbox that isn't actually chat, as this can Note: The #RRGGBB format must contain capital letters a-f is not acceptable but

Note that if there are other child elements, you'd have to check whether the ele

{{Note|Due to underlying C API restrictions this function may return false until a

{{Note|In vehicles with 3 wheels, the wheels are combined 2 in 1, in motorbikes on

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

Note that the external HTTP server can be on the same machine as the MTA server. '''Note''': If you are getting a 403 Forbidden response, nginx cannot access the fi

{{Note|X and Y positions will be changed to an even integer. i.e. -2, 0, 2, 4 etc.

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{PL/Note| Serwer, który ma włączoną komendę fakelag nie będzie wyświetlany na

{{PL/note| Nie zapomnij nadać uprawnień administratora dla zasobu, w przeciwnym wyp

{{Note|#getElementsByType("player") works the same as this function but also works

{{Note|This event will not trigger when [[onDgsMousePreClick]] is cancelled.}}

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|The returned height will be in logical units which are 1.75 times the actua

{{Note|This event will not trigger when [[onDgsMousePreClick]] is cancelled.}}

{{Note|'''visibleTo''' can also be a Team object, in this case, the text will be v

{{Note|Only certain action names work. This function seems to return ''nil'' and o

{{Important Note|The name of this function will change, so you should first check that the f

{{Note|As vezes essa função não funciona ao definir uma estação de rádio dif

{{Note|This event is only triggered for elements that are streamed in}}

'''Note:''' Does not return ''true'' if the user was successfully kicked or ''false

...nd that set player vehicle speed to provided one (in predefined unit kph). Note: It doesn't care if player is driver or passenger.

Please note that even if you enable SD #22 and #23 on your server, you are not protecte

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|This function only works with peds using CJ skin (ID 0).}}

...Either a custom [[DX font]] element or the name of a built-in DX font: '''Note: Some fonts are incompatible with certain languages such as Arabic.''' ***'''colorCoded:''' Set to true to enable embedded #FFFFFF color codes. '''Note: clip and wordBreak are forced false if this is set.'''

{{Note|You need to use this function together with [[onClientPedsProcessed]].}}

{{Note|Changing wheel position on Z axis doesn't work.}} {{Note|Vehicles in the 'bike' category have 8 different components from the others

{{Note|The XML syntax is not implemented yet, but is a representation of what it w

{{Note|To prevent memory leaks, ensure each call to [[xmlLoadFile]] has a matching

{{Note|DGS OOP Class returns tables which can not use original functions directly.

{{Important Note|Use [[encodeString]] instead, because teaEncode inflates the file size by a

* '''NOTE:''' This is made to be used clientside!.

...t response (which may return nil). Use -1 to wait until a result is ready. Note: A wait here will freeze the entire server just like executeSQLQuery {{Important Note|It is strongly recommended to use this function in callback, as presented i

(unknown if still relevant, see note below)

'''Note:''' The server can only return the water color, if it has actually been set

* '''NOTE:''' The structure of the code was made based on the greenzone tag resource!

This function returns a table with all players in an ACL group. Please note that it is valid only for players connected to the server.

* '''NOTE:''' this is made to be only client side

It's important to note that set ''always'' writes to the settings.xml file, even if [[get]] read t

{{Note|O evento não será acionado se o [[element]] que entrou no colshape for ta

{{Note|Color values are only applied when debug level is 0 or 4.}}

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

Note that the final argument passed to guiCreateWindow in the above example is ' '''Note that we are now writing more code for our existing 'createLoginWindow' func

{{Note|

{{Note|[[updateElementRpHAnim]] must be called after this function to apply bone r

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|There is bug when you try to destroy webbrowser that returned from guiGetBr {{Note|As element ids are eventually recycled, always make sure you nil variables

'''Формат:''' <nowiki>{{RU/Note box|Пишите примечание сюда}}</nowiki> {{RU/Note box|Пишите примечание сюда}}

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

Note that the index of row and column start from 1, which is different from [[gu

...roup will have the permissions specified on the "Default" acl name list. ''Note: You will notice this group is special, in that it includes every user and ...er down the ACL and you will see the '''<acl name="Default" />''' listing. Note I have trimmed this list dramatically due to its length.

{{Note|The size can't be less than 5 or more than 150. Use this function after onC

'''Note:''' The amount may vary between the server and client, you shouldn't trust

...te:''' the state of the mouse button. Can be ''down'' or ''up''. '''Please note currently only the up state is supported.'''

{{Note|Using '''escape''' key or '''F8''' key will always return false. Use [[onCl {{Note|Handler function won't be triggered while focused in CEGUI editbox. You can

It is ''important'' to note that events follow the element hierachy. All events are initially triggered ...tive event has been canceled using [[wasEventCanceled]]. It's important to note that canceling event ''does not'' prevent other event handlers being trigge

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|Consider using a variable instead of this function. Using this function wil

{{PL/Note|Ta funkcja działa tylko na skinie CJ'a (ID 0).}}

{{Note|

{{Note|This event checks the player's time as set on the computer and not the regi

{{Note|Installing or removing a wheel upgrade from a vehicle resets the wheel scal

...distance the position can be off screen before the function returns false. Note: it's clamped down on both axies to the size of screen at the given axis*10

''NOTE:'' Settings are not applicable for all vehicles of these types, for instanc

'''Note:''' Does not return ''true'' if a channel mode was successfully set or ''fa

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

'''NOTE:''' This is not the most efficient way, as it won't allow you to have more

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|Before r6974 the component rotations went the wrong way (i.e. opposite to t

{{Note|This useful function requires OOP.}}

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{RU/Note|При использовании функции со стороны кли

* '''fire''' Fire a player's weapon. ('''Note''': If you want to disable weapons fire, remember to also disable the contr ...ork with the functions [[toggleControl]] and [[toggleAllControls]]. Please note that [[toggleControl]] can't disable screenshot.

'''Note:''' Does not return ''true'' if the user was successfully banned or ''false

{{Note|Some small water areas within parts of the city do not count as water to be

{{Note|To prevent memory leaks, ensure each call to [[xmlCopyFile]] has a matching

{{PL/Note|Po ustawieniu po stronie klienta, rzeczywistym limitem jest najniższa z ob

{{Note|Ez a function egyedül csak a CJ skinnel működik (ID 0).}}

{{Note|This function might block actually valid and existing emails. You '''should

{{RU/Note|Это возвращает состояние курсора, которо

{{RU/Note|Не все эффекты поворачиваются (например,

{{Note|Although you may be able to add sirens to any vehice, this function may not

...DGS:dgsCreateComboBox(20,30,150,20,"Checked ComboBox",false,dgsWindow) -- note the parameter after header, it will create a ComboBox

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|In the case of the [[vehicle]] element, the following effects appear, depen

<!-- NOTE: don't use 'special' names for variable names, e.g. you shouldn't be writin

{{Note|This function is not reliable as timer ids are eventually recycled. Always

{{Note|setGarageOpen does not work with ID 32 (Pay 'n' Spray near Royal Casino). T