Multi Theft Auto: Wiki - User contributions [en]

OnElementInteriorChange

2021-04-06T18:42:11Z

WilQ:

__NOTOC__
{{Server event}}
{{New feature/item|3.0159|1.5.9|20837|This event is triggered when the interior of an [[element]] is changed using [[setElementInterior]].}}

==Parameters==
<syntaxhighlight lang="lua">
int oldInterior, int newInterior
</syntaxhighlight>
*'''oldInterior''': an [[int]] representing the interior the [[element]] was in before.
*'''newInterior''': an [[int]] representing the interior the [[element]] is in now.

==Source==
The [[event system#Event source|source]] of this event is the [[element]] that changed its interior.

==Example==
<syntaxhighlight lang="lua">
local vehicle = createVehicle(411, 0, 0, 3)
setTimer(setElementInterior, 1000, 1, vehicle, 10)

addEventHandler("onElementInteriorChange", vehicle, function(oldInterior, newInterior)
outputChatBox(inspect(source).."'s interior changed from "..oldInterior.." to "..newInterior)
end)
</syntaxhighlight>

==Requirements==
{{Requirements|1.5.8-9.20837|n/a|}}

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

PL/takeWeapon

2018-09-13T17:54:51Z

WilQ: /* Przykład */

__NOTOC__
{{PL/Server function}}
Ta funkcja usuwa wybraną broń i / lub amunicję z ekwipunku wskazanego gracza.

==Składnia==
<syntaxhighlight lang="lua">bool takeWeapon ( player thePlayer, int weaponId [, int ammo ] )</syntaxhighlight>

===Wymagane argumenty===
*'''thePlayer''': wskazany [[player|gracz]]
*'''weaponId''': [[weapon|ID broni]], które chcesz usunąć z ekwipunku

===Dodatkowe argumenty===
*'''ammo''': jeśli podane, podana ilość amunicji zostanie usunięta zamiast [[weapon|broni]].

===Wynik===
Zwraca true jeśli broń została poprawnie nadana, false jeśli nie.

==Przykład==
Ten przykład dodaje komendę "usungranatdymny", która usuwa granat dymny z ekwipunku wskazanego gracza.
<syntaxhighlight lang="lua">
addCommandHandler( 'usungranatdymny',
function( player , theCommand, thePlayer)
if ( thePlayer ) then
takeWeapon ( getPlayerFromName( thePlayer ), 17 ) -- usuwa broń wskazanego gracza w komendzie
outputChatBox ( "Gracz " .. getPlayerName ( player ) .. " usuwa granat dymny z Twojego ekwipunku.", getPlayerFromName( thePlayer ) ) -- gracz, na którym wykonaliśmy operacje zostaje o fakcie poinformowany
end
end
)
</syntaxhighlight>

==Zobacz również==
{{Weapon functions}}
[[en:takeWeapon]]
[[ru:takeWeapon]]

2018-01-15T19:53:57Z

WilQ: Undo revision 53340 by WilQ (talk)

{{Server client function}}
__NOTOC__
This function sets the ID of an element to a string. This can be anything from an identifying number, to a name.
You can only change the ID of an element clientside if that element has been created clientside as well.
==Syntax==
<syntaxhighlight lang="lua">
bool setElementID ( element theElement, string name )
</syntaxhighlight>
{{OOP||[[element]]:setID|id|getElementID}}

===Required Arguments===
*'''theElement:''' The [[element]] you want to set the ID of.
*'''name:''' The new ID for theElement.

===Returns===
This returns ''true'' if successful. It will return ''false'' if '''theElement''' is invalid, or does not exist, or if '''name''' is invalid, or is not a string.

==Example==
<syntaxhighlight lang="lua">
local players = getElementsByType( "player" )

for i=1,#players do
setElementID( players[i], "player" .. i ) -- Change element IDs to 'player1', 'players2', 'players3'...
outputDebugString( "Player[" .. i .. "] = " .. getElementID( players[i] ) ) -- Output all the new element IDs
end

[[PL:setElementID]]

-- Could also be --

for i=1,#players do
setElementID( players[i], getPlayerName( players[i] ) ) -- Change the element ID to the players name.
outputDebugString( "Player[" .. i .. "] = " .. getElementID( players[i] ) )
end
</syntaxhighlight>

==See Also==
{{element_functions}}

SetElementID

2018-01-15T19:52:16Z

WilQ:

SetElementID

2018-01-15T19:51:50Z

WilQ:

{{Server client function}}
__NOTOC__
This function sets the ID of an element to a string. This can be anything from an identifying number, to a name.
You can only change the ID of an element clientside if that element has been created clientside as well.
==Syntax==
<syntaxhighlight lang="lua">
bool setElementID ( element theElement, string name )
</syntaxhighlight>
{{OOP||[[element]]:setID|id|getElementID}}

===Required Arguments===
*'''theElement:''' The [[element]] you want to set the ID of.
*'''name:''' The new ID for theElement.

===Returns===
This returns ''true'' if successful. It will return ''false'' if '''theElement''' is invalid, or does not exist, or if '''name''' is invalid, or is not a string.

==Example==
<syntaxhighlight lang="lua">
local players = getElementsByType( "player" )

for i=1,#players do
setElementID( players[i], "player" .. i ) -- Change element IDs to 'player1', 'players2', 'players3'...
outputDebugString( "Player[" .. i .. "] = " .. getElementID( players[i] ) ) -- Output all the new element IDs
end

[[PL:setElementID]]

-- Could also be --

for i=1,#players do
setElementID( players[i], getPlayerName( players[i] ) ) -- Change the element ID to the players name.
outputDebugString( "Player[" .. i .. "] = " .. getElementID( players[i] ) )
end
</syntaxhighlight>

==See Also==
{{element_functions}}

CreateBlip

2018-01-15T19:49:57Z

WilQ:

__NOTOC__
{{Server client function}}
This function creates a [[blip]] [[element]], which is displayed as an icon on the client's radar.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
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, int ordering = 0, float visibleDistance = 99999.0, visibleTo = getRootElement( ) ] )
</syntaxhighlight>
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
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, int ordering = 0, float visibleDistance = 99999.0 ] )
</syntaxhighlight>
</section>
{{OOP||[[Blip]]}}
===Required Arguments===
*'''x:''' The x position of the blip, in world coordinates.
*'''y:''' The y position of the blip, in world coordinates.
*'''z:''' The z position of the blip, in world coordinates.

===Optional Arguments===
{{OptionalArg}}
*'''icon:''' The icon that the radar blips should be. Valid values can be seen at [[Blip Icons]]
*'''size:''' The size of the radar blip. Only applicable to the ''Marker'' icon. Default is 2.
*'''r:''' The amount of red in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
*'''g:''' The amount of green in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''b:''' The amount of blue in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 0.
*'''a:''' The amount of alpha in the blip's color (0 - 255). Only applicable to the ''Marker'' icon. Default is 255.
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' The maximum distance from the camera at which the blip is still visible
}}
<section name="Server" class="server" show="true">
*'''visibleTo:''' This defines which elements can see the blip. Defaults to visible to everyone. See [[visibility]].
</section>

==Returns==
Returns an [[element]] of the [[blip]] if it was created successfully, ''false'' otherwise.

==Example==
<section name="Server" class="server" show="true">
'''Example 1:''' This example creates a radar blip at a random player's position and makes it so that it is only visible to that player.
<syntaxhighlight lang="lua">
-- Pick a random player
local myPlayer = getRandomPlayer( )
-- Retrieve the player's position and store it in the variables x, y and z
local x, y, z = getElementPosition( myPlayer )
-- Create a radar blip at the player's position, with a 'cash' icon and only visible to the player
local myBlip = createBlip( x, y, z, 51, 0, 0, 0, 255, myPlayer )
</syntaxhighlight>

'''Example 2:''' This example attaches a blip to a player. You can attach a blip to an element by just setting the blip's parent to that element.
<syntaxhighlight lang="lua">
-- Pick a random player
local myPlayer = getRandomPlayer( )
-- Create a radar blip in the middle of the map
local myBlip = createBlip( 0, 0, 0 )
-- Make the player the parent of the blip, so that the blip follows the player around
setElementParent( myBlip, myPlayer )
</syntaxhighlight>
</section>

==See Also==
{{Blip_functions}}

[[AR:createBlip]]
[[es:createBlip]]
[[DE:createBlip]]
[[PL:createBlip]]