Multi Theft Auto: Wiki - User contributions [en]

OnClientVehicleExit

2023-08-31T14:24:58Z

Szampan: /* Example */

{{Client event}}
__NOTOC__
This event gets fired when a [[ped]] or [[player]] gets out of a vehicle.

==Parameters==
<syntaxhighlight lang="lua">
ped thePed, int seat
</syntaxhighlight>
*'''thePed:''' the [[player]] or [[ped]] element that exited the vehicle
*'''seat:''' the number of the seat that the player was sitting on. 0 = driver, higher numbers are passenger seats.

==Source==
The source of the event is the vehicle that the ped exited.

==Example==
This code updates a GUI label with the name of the vehicle the local player is in.
<syntaxhighlight lang="lua">
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Currently on foot", false)
addEventHandler("onClientVehicleEnter", getRootElement(),
function(thePlayer, seat)
if thePlayer == localPlayer then
guiSetText(lblVehicle, "Currently in a " .. getVehicleName(source))
end
end
)

addEventHandler("onClientVehicleExit", getRootElement(),
function(thePlayer, seat)
if thePlayer == localPlayer then
guiSetText(lblVehicle, "Currently on foot")
end
end
)
</syntaxhighlight>

==See Also==
===Client vehicle events===
{{Client_vehicle_events}}
===Client event functions===
{{Client_event_functions}}
[[es:onClientVehicleExit]]

OnClientSoundBeat

2023-08-28T14:13:19Z

Szampan: /* Example */

{{Client event}}
__NOTOC__
{{New feature|3.0131|1.3.1|
This event is triggered when a '''sound''' beats.
}}
{{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 time at which the beat occurs
}}
==Parameters==
<syntaxhighlight lang="lua">
double theTime
</syntaxhighlight>

*'''theTime''': the position in the song of the beat

==Source==
The [[event system#Event source|source]] of this event is the [[Element/Sound|sound's element]].

==Example==
<section name="Client" class="client" show="true">
This code will change the vehicle color to a random value if the sound beats and the localPlayer is inside a vehicle
<syntaxhighlight lang="lua">
function playMySound()
playSound("sound.mp3") -- play the sound used for onClientSoundBeat
addEventHandler("onClientSoundBeat", getRootElement(), changeVehicleColorOnSoundBeat)
end
addEventHandler("onClientResourceStart", getRootElement(), playMySound)

function changeVehicleColorOnSoundBeat()
if getPedOccupiedVehicle(localPlayer) then -- if the player is inside a vehicle
setVehicleColor( getPedOccupiedVehicle(localPlayer), math.random(0,255), math.random(0,255), math.random(0,255) ) -- apply the color to the vehicle
outputChatBox("The color of your vehicle was changed.")
else
outputChatBox("Could not change the vehicle color, the localPlayer is not inside a vehicle.")
return end;
end
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.04162}}

==See Also==
===Client sound events===
{{Sound_events}}
===Client event functions===
{{Client_event_functions}}

OnClientSoundBeat

2023-08-28T14:12:58Z

Szampan: /* Example */

{{Client event}}
__NOTOC__
{{New feature|3.0131|1.3.1|
This event is triggered when a '''sound''' beats.
}}
{{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 time at which the beat occurs
}}
==Parameters==
<syntaxhighlight lang="lua">
double theTime
</syntaxhighlight>

*'''theTime''': the position in the song of the beat

==Source==
The [[event system#Event source|source]] of this event is the [[Element/Sound|sound's element]].

==Example==
<section name="Client" class="client" show="true">
This code will change the vehicle color to a random value if the sound beats and the localPlayer is inside a vehicle
<syntaxhighlight lang="lua">
function playMySound()
playSound("sound.mp3") -- play the sound used for onClientSoundBeat
addEventHandler("onClientSoundBeat", getRootElement(), changeVehicleColorOnSoundBeat)
end
addEventHandler("onClientResourceStart", getRootElement(), playMySound)

function changeVehicleColorOnSoundBeat()
if getPedOccupiedVehicle(localPlayer) then -- if the player is inside a vehicle
setVehicleColor( getPedOccupiedVehicle(localPlayer), math.random(0,255), math.random(0,255), math.random(0,255)) -- apply the color to the vehicle
outputChatBox("The color of your vehicle was changed.")
else
outputChatBox("Could not change the vehicle color, the localPlayer is not inside a vehicle.")
return end;
end
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.04162}}

==See Also==
===Client sound events===
{{Sound_events}}
===Client event functions===
{{Client_event_functions}}

OnClientSoundBeat

2023-08-27T17:49:32Z

Szampan:

{{Client event}}
__NOTOC__
{{New feature|3.0131|1.3.1|
This event is triggered when a '''sound''' beats.
}}
{{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 time at which the beat occurs
}}
==Parameters==
<syntaxhighlight lang="lua">
double theTime
</syntaxhighlight>

*'''theTime''': the position in the song of the beat

==Source==
The [[event system#Event source|source]] of this event is the [[Element/Sound|sound's element]].

==Example==
<section name="Client" class="client" show="true">
This code will change the vehicle color to a random value if the sound beats and the localPlayer is inside a vehicle
<syntaxhighlight lang="lua">
function playMySound()
playSound("sound.mp3") -- play the sound used for onClientSoundBeat
addEventHandler("onClientSoundBeat", getRootElement(), changeVehicleColorOnSoundBeat)
end
addEventHandler("onClientResourceStart", getRootElement(), playMySound)

function changeVehicleColorOnSoundBeat()
if getPedOccupiedVehicle(localPlayer) then -- if the player is inside a vehicle
local randomcolor = math.random(0,255) -- generate a random color value
setVehicleColor( getPedOccupiedVehicle(localPlayer), randomcolor, randomcolor, randomcolor ) -- apply the color to the vehicle
outputChatBox("The color of your vehicle was changed.")
else
outputChatBox("Could not change the vehicle color, the localPlayer is not inside a vehicle.")
return end;
end
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.04162}}

==See Also==
===Client sound events===
{{Sound_events}}
===Client event functions===
{{Client_event_functions}}