GetVehicleDummyPosition

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

BETA: NEW FEATURE (BUILD: 1.5.8 r20797)
This function returns the position of the dummy for the given vehicle.

Syntax

float, float, float getVehicleDummyPosition ( vehicle theVehicle, string dummy )

OOP Syntax Help! I don't understand this!

Method: vehicle:getDummyPosition(...)
Counterpart: setVehicleDummyPosition

Required Arguments

  • theVehicle: The vehicle you want to get the dummy positions from.
  • dummy: The dummy whose position you want to get.

Allowed Dummies

  • light_front_main: Primary front lights position.
  • light_rear_main: Primary rear lights position.
  • light_front_second: Secondary front lights position.
  • light_rear_second: Secondary rear lights position.
  • seat_front: Front seat position.
  • seat_rear: Rear seat position.
  • exhaust: Exhaust fumes start position.
  • engine: Engine smoke start position.
  • gas_cap: Vehicle gas cap position (shooting it will explode vehicle).
  • trailer_attach: Point at which trailers will be attached to vehicle.
  • hand_rest: Point at which the steer of a bike is held.
  • exhaust_second: Secondary exhaust position (for example in NRG-500)
  • wing_airtrail: Point from which air trail will show in airplanes, visible while in sharp turns.
  • veh_gun: Vehicle gun position (ex. Rustler).

Returns

Returns 3 floats indicating the position X, Y and Z of the vehicle's dummy. It returns false otherwise.

Example

This is a command to get the position of the player's vehicle dummy position specified as an argument.

function getDummyPosition (commandName, dummy)
    if not dummy then
        return false
    end
    local veh = getPedOccupiedVehicle (localPlayer)

    if not veh then
        outputChatBox ("You should be in a vehicle to use this command", 255, 25, 25)
        return false
    end

    local x, y, z = getVehicleDummyPosition (veh, dummy)
    outputChatBox ("X: "..x..", Y: "..y..", Z: "..z, 0, 255, 0)
end

addCommandHandler ("getdummy", getDummyPosition)

Requirements

Minimum server version n/a
Minimum client version 1.5.8-9.20797

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.5.8-9.20797" />

See Also

BETA: NEW FEATURE (BUILD: 1.5.8 r20797)
BETA: NEW FEATURE (BUILD: 1.5.8 r20797)
BETA: NEW FEATURE (BUILD: 1.5.8 r20726)
BETA: NEW FEATURE (BUILD: 1.5.8 r20797)
BETA: NEW FEATURE (BUILD: 1.5.8 r20797)
BETA: UPDATED FEATURE (BUILD: 1.5.8 r20693)