Multi Theft Auto: Wiki - User contributions [en]

OnPlayerLogin

2021-04-01T07:10:11Z

Ramzes: /* Example */

{{Server event}}
__NOTOC__
This event is triggered when a player logs into their account in-game.

==Parameters==
<syntaxhighlight lang="lua">
account thePreviousAccount, account theCurrentAccount
</syntaxhighlight>

*'''thePreviousAccount''': the [[account]] the player was logged into before.
*'''theCurrentAccount''': the [[account]] the player logged into just now.

==Source==
The [[event system#Event source|source]] of this event is the player [[element]] that just logged in.

==Cancel effect==
If this event is canceled the player will not be logged in.

==Example==
This example just outputs to the player console that a player in one account logged into an another account:
<syntaxhighlight lang="lua">
-- root = getElementRoot()
addEventHandler("onPlayerLogin", root,
function()
outputChatBox(getPlayerName(source).." has logged in!", root)
end
)
</syntaxhighlight>
This example allows only hardcoded serials to access given accounts.
<syntaxhighlight lang="lua">
Firewall =
{
-- [ 'accountName' ] = 'playerSerial',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if Serial and Serial ~= getPlayerSerial ( source ) then
outputChatBox( "Sorry, you're not allowed to access this account.", source)
cancelEvent( true )
end
end
)
</syntaxhighlight>

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

[[ru:onPlayerLogin]]

AddElementDataSubscriber

2021-01-30T11:34:05Z

Ramzes: /* Example */

{{Server function}}
__NOTOC__
{{New items|3.0158|1.5.7-9.20477|This function subscribes a [[player]] to specific [[element data]].
This function is used together with [[setElementData]] in ''"subscribe"'' mode.
}}

==Syntax==

<syntaxhighlight lang="lua">
bool addElementDataSubscriber ( element theElement, string key, player thePlayer )
</syntaxhighlight>
{{OOP||[[element]]:addDataSubscriber||removeElementDataSubscriber}}

===Required Arguments===
*'''theElement:''' The [[element]] you wish to subscribe the [[player]] to.
*'''key:''' The key you wish to subscribe the player to.
*'''thePlayer:''' The [[player]] you wish to subscribe.

===Returns===
Returns ''true'' if the player was subscribed, ''false'' otherwise.

==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addEventHandler("onVehicleEnter", getRootElement(), function(thePlayer, seat)
if seat==0 then -- if the player is a driver
addElementDataSubscriber(source, "id", thePlayer) -- subscribe the player to element
end
end)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.5.7-9.20477|n/a|}}

==See Also==
{{Element_functions}}

User:Ramzes

2021-01-29T11:30:46Z

Ramzes: Created page with "== LUA == I am learning lua for a year with a little break"

== LUA ==
I am learning lua for a year with a little break

OnPedVehicleExit

2021-01-29T11:15:19Z

Ramzes: /* Example */

__NOTOC__
{{Server event}}
{{New feature/item|3.0160|1.5.8|20740|This event is triggered when a ped leaves a vehicle.}}

==Parameters==
<syntaxhighlight lang="lua">
vehicle theVehicle, int seat, ped jacker, bool forcedByScript
</syntaxhighlight>

*'''theVehicle''': a [[vehicle]] element representing the vehicle in which the ped exited from.
*'''seat''': an [[int]] representing the seat in which the ped was before exiting.
*'''jacker''': a [[player]] or [[ped]] element representing who jacked the driver.
*'''forcedByScript:''' a [[boolean]] representing whether the exit was forced using [[removePedFromVehicle]] or by the ped.

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that left the vehicle.

==Example==
{{Needs Example}}
<section name="Example 1" class="server" show="true">
Destroy the vehicle when ped has been jacked and kick the jacker if exists
<syntaxhighlight lang="lua">
function destroyVehicle(theVehicle, seat, jacker, forcedByScript)
if seat==0 then -- If ped was a driver
if forcedByScript then
destroyElement(theVehicle) -- If the exit was forced using removePedFromVehicle then destroy the vehicle
elseif jacker then
kickPlayer(jacker)
destroyElement(theVehicle)
end
end
end
addEventHandler("onPedVehicleExit", root, destroyVehicle)
</syntaxhighlight>
</section>
{{See also/Server event|Ped events}}

OnPedVehicleEnter

2021-01-29T11:01:06Z

Ramzes: /* Example */

__NOTOC__
{{Server event}}
{{New feature/item|3.0160|1.5.8|20740|This event is triggered when a ped enters a vehicle.}}

==Parameters==
<syntaxhighlight lang="lua">
vehicle theVehicle, int seat, ped jacked
</syntaxhighlight>

*'''theVehicle''': a [[vehicle]] element representing the vehicle that was entered.
*'''seat''': an [[int]] representing the seat in which the ped is entering.
*'''jacked''': a [[player]] or [[ped]] element representing who has been jacked.

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that entered the vehicle.

==Example==
{{Needs Example}}
<section name="Example 1" class="server" show="true">
Sending a message to every player when ped has entered to a vehicle
<syntaxhighlight lang="lua">
function sendMessage(theVehicle, seat)
local vehicleName = getVehicleName(theVehicle) -- Get name of the vehicle
if seat==0 then -- if the ped is a driver
outputChatBox("Ped is now a driver of "..vehicleName, root)
else -- if not
outputChatBox("Ped has entered to "..vehicleName, root)
end
end
addEventHandler("onPedVehicleEnter", root, sendMessage)
</syntaxhighlight>
</section>
{{See also/Server event|Ped events}}

OnPedVehicleEnter

2021-01-29T10:58:29Z

Ramzes: /* Example */

__NOTOC__
{{Server event}}
{{New feature/item|3.0160|1.5.8|20740|This event is triggered when a ped enters a vehicle.}}

==Parameters==
<syntaxhighlight lang="lua">
vehicle theVehicle, int seat, ped jacked
</syntaxhighlight>

*'''theVehicle''': a [[vehicle]] element representing the vehicle that was entered.
*'''seat''': an [[int]] representing the seat in which the ped is entering.
*'''jacked''': a [[player]] or [[ped]] element representing who has been jacked.

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that entered the vehicle.

==Example==
{{Needs Example}}
<section name="Server" class="server" show="true">
Sending a message to every player when ped has entered to a vehicle
<syntaxhighlight lang="lua">
function sendMessage(theVehicle, seat)
local vehicleName = getVehicleName(theVehicle) -- Get name of the vehicle
if seat==0 then -- if the ped is a driver
outputChatBox("Ped is now a driver of "..vehicleName, root)
else -- if not
outputChatBox("Ped has entered to "..vehicleName, root)
end
end
addEventHandler("onPedVehicleEnter", root, sendMessage)
</syntaxhighlight>
</section>
{{See also/Server event|Ped events}}

OnPedVehicleEnter

2021-01-29T10:53:22Z

Ramzes: /* Example */

__NOTOC__
{{Server event}}
{{New feature/item|3.0160|1.5.8|20740|This event is triggered when a ped enters a vehicle.}}

==Parameters==
<syntaxhighlight lang="lua">
vehicle theVehicle, int seat, ped jacked
</syntaxhighlight>

*'''theVehicle''': a [[vehicle]] element representing the vehicle that was entered.
*'''seat''': an [[int]] representing the seat in which the ped is entering.
*'''jacked''': a [[player]] or [[ped]] element representing who has been jacked.

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that entered the vehicle.

==Example==
{{Needs Example}}
<section name="Server" class="server" show="true">
Sending a message to every player when ped has entered to a vehicle
<syntaxhighlight lang="lua">
function sendMessage()
for _, player in pairs(getElementsByType("player")) do
outputChatBox("Ped has entered to a vehicle", player)
end
end
addEventHandler("onPedVehicleEnter", root, sendMessage)
</syntaxhighlight>
</section>
{{See also/Server event|Ped events}}