Search results

Returns an [[Element|element]] if it's within the specified '''distance''', ''false'' otherwise. local elements = getElementsWithinRange(Vector3(getElementPosition(player)), distance, type, getElementInterior(player), getElementDimension(p

local x, y, z = getElementPosition(getPedOccupiedVehicle(thePlayer) or thePlayer) ...example adds a command that outputs the rounded players current position. It's useful for [[createWater]] function.

...pearing not to load them at all. Refer to the second example on that page, it's a client-side function and cannot be used next to assignLOD.}} setElementPosition(lod, getElementPosition(element))

{{IT/MainP}} {{IT/Funzioni client}}

...oat indicating the related angle between the first element and the second. It returns ''false'' if invalid parameters are provided. local pointX, pointY = getElementPosition(thisElement)

Returns ''true'' if the position is inside the radar area, ''false'' if it isn't or if any parameters are invalid. -- get the x, y coordinates from getElementPosition (z gets silently discarded)

...ions:''' A table of options. It is not mandatory, but when it is provided, it must be a table. For a list of options, see the [https://github.com/kikito/ ...rns a string. The contents can change if we update the inspect library, so it is not expected to be consistent across Lua versions.

...players that are within a certain range if there is minimum 1 player else it returns false. local x,y,z = getElementPosition(playerSource);

This function takes two sets of XY coordinates. It returns the direction from point A to point B. This can for example be used This command makes the player who enters it face the player whose name is given.

local px, py, pz = getElementPosition(theElement) if (hitElement == theElement) then -- If it collides with the element return true

...behavior of [[isPedInVehicle]] server-sided for [[player]] elements ONLY. It checks if a specified [[player]] is actually in a [[vehicle]] and not just ...fully completed entering a [[vehicle]] and hasn't fully completed exiting it yet, ''false'' otherwise.

...that holds the direction and distance between two points. In other words, it produces exactly the same result as substracting the points' coordinates an vehicle1x, vehicle1y, vehicle1z = getElementPosition ( vehicle1 )

...that holds the direction and distance between two points. In other words, it produces exactly the same result as substracting the points' coordinates an This example gets the distance between two vehicles and outputs it to the chat box.

...mmand that creates a M4 where the player uses it, and gives 1 clip ammo to it. local wep = createWeapon("m4", getElementPosition(localPlayer))

...example checks if the object created is breakable and if it is then breaks it. local x, y, z = getElementPosition(localPlayer)

...example checks if the object created is breakable and if it is then breaks it. local x, y, z = getElementPosition(plr)

outputServerLog( table.concat({getElementPosition(source)}, ", ") ) ...xist but aren't supposed to be (like forbidden, where they can still spawn it through creation vulnerability, or identify which resource is hooked into (

It is required that the point is near enough to the local player so that it's within the area where collision data is loaded. If this is not the case, local px, py, pz = getElementPosition ( thePlayer )

{{Note|Disabling a peds collisions will cause some problems, such as it being unable to move or wrong rotation after creation.}} local playerX, playerY, playerZ = getElementPosition(thePlayer)

{{IT/MainP}} {{IT/Funzioni client}}

...ator:''' the explosion's simulated creator, the [[player]] responsible for it. local pX, pY, pZ = getElementPosition ( source )

...overlay grain effect. The game will draw it on top of other grain effects. It can be used to imitate an effect of radiation or electromagnetic disturbanc local x, y, z = getElementPosition( localPlayer )

...ent. These events can only trigger when the client has its cursor enabled. It triggers for all three mousebuttons in both their up and down states. This example prints type of the element you clicked to chatbox when you click it.

[[File:DxDrawImageOnElement.png|thumb|Example of how it should looks like.|284x230px]] * ''TheElement'': The element you want to draw the image on it.

...hel charge, returns the [[element]] at which it is glued to (or ''nil'' if it isn't glued to any).}} local x,y,z = getElementPosition(getLocalPlayer()) -- Get the position of the player

This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B. This can for example be u This command makes the player's vehicle to rotate at vehicle near it.

...a while. Because it's a client side only function, other players won't see it, so custom events or custom objects will be needed to make a fire visible t ...nd, which creates a patch of fire in the position of the player that types it.

...- if visibility for root is set to false and for a player is set to true, it will be visible to the player. *'''visible:''' Whether you are making it visible or invisible to the player.

local px, py, pz = getElementPosition(localPlayer) -- output it to the console

.... It is required that the point is near enough to the local player so that it's within the area where collision data is loaded.}} local playerX, playerY, playerZ = getElementPosition (localPlayer)

If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID. This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned.

...weenPoints3D(x, y, z, getElementPosition(ele)) <= range -- returns true if it the range of the element to the main point is smaller than (or as big as) t local x, y, z = getElementPosition(player)

If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID. This will allow the player to create a vehicle by name and it's model ID will be displayed in the chatbox when the vehicle is spawned.

This example creates a polygon colshape and show height of it with command 'getpolyheight'. local x, y = getElementPosition ( colPoly )

* '''weapon''': If the type is a Weapon pickup, then it represents the [[Weapon|weapon ID]] of the weapon pickup. When used with th ...ntPosition ( source ) --get the position of the person who died and define it as x, y and z

...ain location. The water level is 0 in most places though it can vary (e.g. it's higher near the dam). local x, y, z = getElementPosition ( thePlayer ) -- get his position

...and named ''getscale'' which creates an object and prints out the scale of it. local theObject = createObject(1337, getElementPosition(localPlayer))

local x1,y1,z1 = getElementPosition(sm.object1) local x2,y2,z2 = getElementPosition(sm.object2)

...want a custom weapon to take into account recoil, you will have to script it by firing at fixed coordinates.}} * '''theTarget:''' The [[element]] to shoot at. It can be a [[player]], [[ped]], [[vehicle]] or [[object]].

If a boolean was passed to the function, it always succeeds and returns ''true''. ...localPlayer) == 17 and getDistanceBetweenPoints3D(493.39, -22.72, 1000.68, getElementPosition(localPlayer)) < 50 and getInteriorSoundsEnabled() then

local x,y,z = getElementPosition ( creator ) ...tData ( claymoreCol , "type", "claymore" ) --store the type of colshape so it can be retrieved

...tElementPosition (somewhere far away) and then destroyElement (which makes it explode). ...here the teargas got created, and also the teargas keeps getting warped to it. This will result in +/-60hp loss for the creator.

This event is triggered every time GTA renders a new frame. It is required for the DirectX drawing functions, and also useful for other cl local x, y, z = getElementPosition ( localPlayer )

...ers) or detecting if a point is on the screen (though it does not check if it is actually visible, you should use [[processLineOfSight]] for that). ...ce 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

{{IT/MainP}} {{IT/Funzioni client}}

This element has to create a blip at the nearest garage and removes it in 10 seconds. local ex,ey,ez = getElementPosition (element)

This function checks in which way the cursor is currently moving, it's updated version of https://wiki.multitheftauto.com/wiki/GetCursorMoveOn. local x, y, z = getElementPosition(vehicle)

...en local and said remote player (that spawned far away) during this event, it would output the distance at which they died in front of local player, e.g local x, y, z = getElementPosition(localPlayer)

...tion can only remove command handlers that were added by the resource that it is called in. local x, y, z = getElementPosition ( huntedPlayer )

[[Image:Drawcircleonelementdemo.jpg|thumb|Example of how it should looks like.|304x250px]] * '''TheElement''': The element you want to draw the text on it.

destroyElement ( theZone ) -- if so, destroy it local x,y,z = getElementPosition ( creator )

This example creates an antenna, and changes the size of it. local x, y, z = getElementPosition(localPlayer)

local x, y, z = getElementPosition(localPlayer) -- Get player position ...mo(customWeapon, 99999) -- Set the ammo in clip of the weapon to 99999, so it never should reload

...unction creates a camera object at a specified location in the game world. It then sets up a timer to check the speed of all vehicles in the game every s local x1, y1, z1 = getElementPosition(vehicle)

...le 1:''' This example attaches a marker to a vehicle, and detaches it when it blows up: local x,y,z = getElementPosition(source);

...one element to another, so that the first one follows the second whenever it moves. ...w attachment. For example, if carA is asked to attached to carB then carC, it is only attached to carC.

Returns ''true'' if the position is inside the colshape, ''false'' if it isn't or if any parameters are invalid. return isInsideColShape( theColShape, getElementPosition( theElement ) )

This example gets the ammo of the custom weapon and outputs it to the chatbox. local position = Vector3(getElementPosition(localPlayer)) -- get the localPlayer position

This function attempts to read a double (native type) from a file and return it. The amount of bytes read should be eight. Returns a double if it was successfully read from the file, '''false''' otherwise.

This function attempts to read a double (native type) from a file and return it. The amount of bytes read should be eight. Returns a double if it was successfully read from the file, '''false''' otherwise.

{{Warning|Do not use this function to spawn a [[player]]. It will cause problems with other functions like [[warpPedIntoVehicle]]. Use [ {{OOP||[[element]]:setPosition|position|getElementPosition}}

local x, y, z = getElementPosition ( sourcePlayer ) -- Get the name of the car the player asked for and store it in the

local x, y, z = getElementPosition ( localPlayer ) This event and [[onClientRender]] will trigger whatever function it is attached to with every frame. Depending on the server's maximum FPS and

'''Attention:''' Do not use this function to spawn a [[player]]. It will cause problems with other functions like [[warpPedIntoVehicle]]. <br> {{OOP||[[element]]:setPosition|position|getElementPosition}}

...to Google blocking non-user calls to their TTS API. Plase feel free to fix it by using another public and reliable TTS API.|1}} ...d table, the speech will be broadcasted to the players contained in it. If it's a element, the speech will be heard by the players which are children of

local x, y, z = getElementPosition ( thePlayer ) -- Get the name of the car the player asked for and store it in the

local x, y, z = getElementPosition(localPlayer) -- Give it some ammo and fire it

[[Image:dxDrawTextOnElement.png|thumb|Example of how it should looks like.|284x230px]] * ''TheElement'': The element you want to draw the text on it.

local playerX, playerY, playerZ = getElementPosition(source) -- get position of player outputChatBox("Rocket minigun overheated! Give it a rest pal!", source) -- output a message

...log state of a specified [[ped]]'s control, as if they pressed or released it. local playerPosition = Vector3( getElementPosition( localPlayer ) )

...is responsible for informing the server about the state of that element - it's position, orientation and other state information. The function can be al .... This is within 140 units for vehicles and 100 units for peds. As soon as it becomes impossible for your chosen player to sync the element, another play

local px, py, pz = getElementPosition( v ) This Example get players in range and out put it in chat .

-- Otherwise it will look all funny local frPosX, frPosY, frPosZ = getElementPosition( from )

...unction takes a set of XY coordinates, a distance and a rotation argument. It returns XY coordinates of the point that is the given distance away from th local x,y,z = getElementPosition(player);

...one element to another, so that the first one follows the second whenever it moves. ...w attachment. For example, if carA is asked to attached to carB then carC, it is only attached to carC.

...nd ''createmarker'' (which creates a red marker at the caller's position). It then creates a second command handler ''createmarker2'' which will call the -- If a player triggered it (rather than the admin) then

{{Warning|Do not use this function to spawn a [[player]]. It will cause problems with other functions like [[warpPedIntoVehicle]]. Use [ {{OOP||[[element]]:setPosition|position|getElementPosition}}

This function checks if a ped is aiming and if it is at an certain distance from the object you specified. Returns true if ye local x, y, z = getElementPosition(theElement)

...seOfModel]], or you can estimate it yourself and just spawn the vehicle so it drops to the ground. ...ty with some scripts. It never had any effect, but it is read by the code. It is recommended to ignore this argument, passing ''false'' or the ''variant1

...ater at 500 units below the ground at the position of the player who types it. local px, py, pz = getElementPosition(localPlayer)

Returns ''true'' if the property is enabled, ''false'' if it is disabled or the specified property name is invalid. x,y,z = getElementPosition(glp)

...gradeOnSlot(pVehicle, 8) then -- Check if the vehicle has nitrous added in it local fX, fY, fZ = getElementPosition(pVehicle)

...nto another by calculating the rotation and position offset automatically. It works exactly like [[attachElements]] but you don't need to provide offset local vec = Vector3 (getElementPosition(theElement))

local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position

Returns an [[element]] of the [[blip]] if it was created successfully, ''false'' otherwise. ...le creates a radar blip at a random player's position and makes it so that it is only visible to that player.

...oat values that multiplied to a point will give you the point transformed. It is most useful for matrix calculations such as calculating offsets. For fur matrix[4][1], matrix[4][2], matrix[4][3] = getElementPosition(element)

{{IT/MainP}} {{IT/Funzioni server client}}

...ot be cloned. If a player element is a child of an element that is cloned, it will be skipped, along with the elements that exist as a child to the playe local x, y, z = getElementPosition ( occupiedVehicle ) -- get the vehicle's position

local px, py, pz = getElementPosition(v) if (hit == v) or (hit == veh) or (not veh) then -- If it collides with the player itself, the client or the players vehicle, continu

if (not normalMessage) then -- it's not normal message local playerX, playerY, playerZ = getElementPosition(source) -- get position of player who sent the message

...scripts, this page should probably be changed later, depending how useful it is. ...n any map file entry, MTA automatically recognizes it as a custom one when it starts. Its up to the script to decide how to deal with the information pro

local x, y, z = getElementPosition(player) [[IT:createBlip]]

This function destroys an [[element]] and all elements within it in the hierarchy (its children, the children of those children etc). [[play ...successfully, ''false'' if either the element passed to it was invalid or it could not be destroyed for some other reason (for example, clientside destr

...function is mainly useful for client side created peds however you can use it on a server side ped, though note that the weapon wouldn't be synced betwee ...d whether to set as the current weapon. If you don't specify an ammo value it will give 30 ammo by default and for a melee weapon you can specify just 1

{{RU/OOP||[[Элемент|element]]:setPosition|position|getElementPosition}} -- Make sure it exists!

..., -1684.0, 13.5, 20) -- create a ped at cjs house in grove street and give it an ak ...er) -- if an intruder exists, get its position and have the cj ped fire at it

It can also be used to interpolate 2D vectors or scalars by only setting some ...the beginning of the interpolation, 1 at the end). If it is higher than 1, it will start from the beginning.

...n ACL. Make sure to add the command to your ACL under the proper group for it to be usefull (i.e <right name="command.killEveryone" access="true"></right ...his will create a red marker at the position of the player player who uses it.

This function returns ''true'' if the vehicle is going backwards, otherwise it returns ''false'' if the vehicle is going forwards or is stoped. The client-side version is more trustable because it also checks the vehicle gear.

local t_PlayerPos = {getElementPosition(localPlayer)} local t_PedPos = {getElementPosition(t_Data.ped)}

...ate was not manually called by scripts - will see the ped teleport around. It will clearly look as if synchronization were broken. local x, y, z = getElementPosition(localPlayer)

local x,y,z = getElementPosition(hitElement) -- if a player triggered it, not the admin,

...ment to another element, so that the first one follows the second whenever it moves. ...ngle car, but you can attach car to the3DImage , If you attempt to do this it won't work .

...a "resource", and they will all be unzipped and loaded by the server when it starts. To create your own resource, simply make a folder with your preferr ...folder in our case. So create a text file and name it "meta.xml", and open it with notepad.

* Z argument isn't in use currently, but make your scripts like it is for future compatibility reasons. ...or:''' The [[interior]] you want to limit the search to. If not specified, it can return elements in any interior.

This function attempts to read a boolean (native type) from a file and return it. The amount of bytes read should be one. Returns a boolean if it was successfully read from the file, '''nil''' otherwise.

This function attempts to read a boolean (native type) from a file and return it. The amount of bytes read should be one. Returns a boolean if it was successfully read from the file, '''nil''' otherwise.

...n ACL. Make sure to add the command to your ACL under the proper group for it to be usefull (i.e <right name="command.killEveryone" access="true"></right ...his will create a red marker at the position of the player player who uses it.

local origX, origY, origZ = getElementPosition ( theObject ) --get the original position ...el (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds.

...n as being partly equivalent to a program running in an operating system - it can be started and stopped, and multiple resources can run at once. ...to do with scripting happens in resources, what a resource does defines if it is a gamemode, a map, or anything else. MTA comes with resources that you c

...atrix#getPosition|Matrix.getPosition]]''' and '''[[getElementMatrix]]'''. It's just: ...e opposite of matrix.forward you'll still use matrix.forward but you minus it instead of matrix.backward which doesn't exist. Same applies with matrix.ri

...hree floats indicating the position ''x'', ''y'' and ''z'' of given dummy. It returns ''false'' otherwise. ...ill draw rectangle over every dummy in vehicle player is currently sitting it.

...position underneath a vehicle. This is the position at any rotation. So if it was upside down, the Z value would be higher than the vehicle Z value. If t local pX, pY, pZ = getElementPosition(vehicle)

local x, y, z = getElementPosition ( luckyBugger ) -- pobiera pozycję powyższego gracza local x, y, z = getElementPosition ( luckyBugger ) -- pobiera pozycję powyższego gracza

...or performance, place it as close to the centre of the polygon as you can. It should be noted this shape is '''2D'''. There should be at least 3 bound po ...e collision polygon's position - the position that will be returned from [[getElementPosition]].

The 3D line with a large width value effectively becomes a rectangle, so it it possible to construct basic shapes such as boxes with several large width l local x,y,z = getElementPosition(localPlayer)

-- Retrieve the player's position and store it in the variables x, y and z local x, y, z = getElementPosition( myPlayer )

The 3D line with a large width value effectively becomes a rectangle, so it it possible to construct basic shapes such as boxes with several large width l local x,y,z = getElementPosition(localPlayer)

...or performance, place it as close to the centre of the polygon as you can. It should be noted this shape is '''2D'''. There should be at least 3 bound po ...kszög pozíciójának X pozíciója - the position that will be returned from [[getElementPosition]].

Returns an [[element]] of the [[blip]] if it was created successfully, ''false'' otherwise. x,y,z = getElementPosition ( myPlayer ) -- حضار احداثيات الاعب

...ch from this tutorial is [[Introduction to Scripting GUI]], you may follow it to see how Graphical User Interface in MTA:DM is drawn and scripted. ...tain "greet". Argument 3 is something extra the player typed, you'll learn it a little bit further in the tutorial. Never forget that the first 2 argumen

-- If a player triggered it (rather than the admin) then local x, y, z = getElementPosition ( playerSource )

It also returns ''false'' when trying to play a track deleted in the recent GT local x, y, z = getElementPosition(localPlayer)

* Remember that 99% of the time it's a bug in your script, not an MTA bug! Don't report something to GitHub Is ...he long run as you'll spend less time being confused when you come back to it in a weeks time to debug a problem.

This outputs the specified text string to the chatbox. It can be specified as a message to certain player(s) or all players. It can optionally allow you to embed color changes into the string by setting

-- Retrieve the player's position and store it in the variables x, y and z local x, y, z = getElementPosition( myPlayer )

local x, y, z = getElementPosition(randomPlayer) -- następnie pobieramy jego pozycję... [[IT:createBlip]]

local x, y, z = getElementPosition(myPlayer) -- Preluăm coordonatele X, Y, Z ale poziției jucătorului; [[IT:createBlip]]

...ordBreak:''' if set to ''true'', the text will wrap to a new line whenever it reaches the right side of the bounding box. If ''false'', the text will alw ...(so called '''text on raster optimisation'''). You can find out more about it [https://forum.mtasa.com/topic/132881-scaling-dx-elements-for-all-resolutio

x, y, z = getElementPosition(source) -- s يآتي بمكان الاعب x, y, z x, y, z = getElementPosition(source)

...issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground local x, y, z = getElementPosition ( thePlayer ) -- get the player's position

...rough" surfaces and will always behave as if the argument is set to FALSE (It will never hit).}} ...ecified element. This is usually set to the object you are tracing from so it does not interfere with the results.

x,y,z = getElementPosition ( miJugador ) [[IT:createBlip]]

-- this will add all the vehicle options onto the gridlist, it is explained later in this tutorial -- when the resource is started, create the GUI and hide it

...rzejdziemy najpierw do '''Element functions''', gdzie znajdziemy funkcję [[getElementPosition]]. Klikając nazwę funkcji na liście, pokaże się jej opis. Możemy tam Dla [[getElementPosition]], składnia wygląda tak:

...o, lo que nos lleva a buscar una '''Función de Elemento''', la cual es ''[[getElementPosition]]''. Haciendo click en ella, visitarás la documentación de ella, que cont Para la función [[getElementPosition]], el sintaxis sería:

...jump karte hain '''Element functions''' jahan par hameu pata chalta hai [[getElementPosition]] function ke baate meu. Function name ko click karne ke baad, hameu functi [[getElementPosition]] ke liye syntax ye hai:

...s la rubrique '''Element functions''' où l'on pourra trouver la fonction [[getElementPosition]]. En cliquant sur le nom de la fonction, le wiki va vous afficher sa descr Pour [[getElementPosition]], la syntaxe est:

<script src="script.lua" type="client"/> <!-- define it separately on client --> * It doesn't remove Lua files which were previously downloaded.

...ентами, мы сразу выбираем '''Element functions''', где и находим функцию [[getElementPosition]]. Кликнув по имени функции из списка, вы п Для [[getElementPosition]] синтаксис таков:

...lementek, először az '''Element funkcióhoz''' lépünk, ahol megtaláljuk a [[getElementPosition]] funkciót. A funkció nevére kattintással a listában, eljutsz a funkci A [[getElementPosition]] funkcióhoz szintaxis:

To use it, you need to add library to your class-path. It's included in the zip file below.

-- this will add all the vehicle options onto the gridlist, it is explained later in this tutorial -- when the resource is started, create the GUI and hide it

...mento, clicamos primeiro em '''Element functions''' onde haverá a função [[getElementPosition]] para tal fim. Ao clicar no link, uma página contendo detalhes sobre essa Para [[getElementPosition]], a sintaxe é: