Multi Theft Auto: Wiki - User contributions [en]

CountPlayersInRange

2011-06-15T14:25:56Z

MtaUser154:

{{Useful Function}}
This function allows you to set '''moving''' element speed in kph or mph units.
==Syntax==
<syntaxhighlight lang="lua">
bool setElementSpeed (element theElement, [ int/string unit="kph", int speed=0 ])
</syntaxhighlight>

===Required Arguments===
* '''theElement''': Element you want to set speed of

===Optional Arguments===
{{OptionalArg}}
* '''unit''': Units in which speed should be set. This can be 1 or "mph" for mph, any other value for kph.
* '''speed''': Speed in selected unit

==Code==
{{RequiredFunctions|getElementSpeed}}
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function setElementSpeed(element, unit, speed) -- only work if element is moving!
if (unit == nil) then unit = 0 end
if (speed == nil) then speed = 0 end
speed = tonumber(speed)
local acSpeed = getElementSpeed(element, unit)
if (acSpeed~=false) then -- if true - element is valid, no need to check again
local diff = speed/acSpeed
local x,y,z = getElementVelocity(element)
setElementVelocity(element,x*diff,y*diff,z*diff)
return true
end

return false
end
</syntaxhighlight>
</section>

==Example==
<section name="Server-side example" class="server" show="true">
This example adds command that set player vehicle speed to provided one (in predefined unit kph). Note: It doesn't care if player is driver or passenger.
<syntaxhighlight lang="lua">
addCommandHandler("setmyspeed",
function (player, cmd, arg1)
local veh = getPedOccupiedVehicle(player)
if (veh) then
setElementSpeed(veh, "kph", tonumber(arg1))
else
outputChatBox("You have to sit in vehicle", player)
end
end
)
</syntaxhighlight>
</section>

By '''varez'''.

==See Also==
{{Useful_Functions}}

GetVehicleEngineState

2011-05-23T11:15:27Z

MtaUser154: /* Required Arguments */

__NOTOC__
{{Server client function}}
This function returns a vehicle's engine state (on or off).

==Syntax==
<syntaxhighlight lang="lua">
bool getVehicleEngineState ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The [[vehicle]] you wish to get the engine state of.

===Returns===
Returns '''true''' if the vehicle's engine is started, '''false''' otherwise.

==Example==
<section name="Serverside example" class="server" show="true">
This example will switch the vehicle engine state with the command "/switchengine".
<syntaxhighlight lang="lua">
function switchEngine ( playerSource )
local theVehicle = getPedOccupiedVehicle ( playerSource )

-- Check if the player is in any vehicle and if he is the driver
if theVehicle and getVehicleController ( theVehicle ) == playerSource then
local state = getVehicleEngineState ( theVehicle )
setVehicleEngineState ( theVehicle, not state )
end
end
addCommandHandler ( "switchengine", switchEngine )
</syntaxhighlight>
</section>

==See Also==
{{Vehicle functions}}

[[Category:Changes_in_1.0]]

Talk:GetVehicleHandling

2011-05-23T06:16:20Z

MtaUser154:

Qais: Is this page correct?

MtaUser154: I get a nil-pointer error when I try to use this function with MTA:SA Server v1.1-unstable 2468

Talk:Weather

2011-05-09T16:49:02Z

MtaUser154:

The page lists ID's up to 45, however the setWeather() function returns false if you try to set an ID over 19, should those above 19 be removed?
It is possible to use all the IDs listed on the page by manually editing the memory of your game.
:Are the IDs over 19 useful? Remove them for now, but if they're useful we can consider re-adding them. [[User:EAi|eAi]] 17:34, 17 April 2008 (CDT)
::They could be usefull after a future build is released if the Weather scripting functions are changed to allow ID's over 19.--[[User:Stevvo|Stevvo]] 23:08, 17 April 2008 (CDT)

I discoverd, that using weather ID=100 with setWeather() causes all 3d-object to disapper. It seems like you have zero-sight with this weather. Should this be documentated here? [[User:MtaUser154|MtaUser154]] 18:49, 9 May 2011 (CEST)