GetVehicleUpgradeOnSlot: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
(4 intermediate revisions by 3 users not shown)
Line 6: Line 6:


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">getVehicleUpgradeOnSlot ( vehicle theVehicle, int slot )</syntaxhighlight>
<syntaxhighlight lang="lua">int getVehicleUpgradeOnSlot ( vehicle theVehicle, int slot )</syntaxhighlight>


===Returns===
===Returns===
Line 13: Line 13:
===Required Arguments===
===Required Arguments===
*'''theVehicle''': The [[vehicle]] whose upgrade you want to retrieve.
*'''theVehicle''': The [[vehicle]] whose upgrade you want to retrieve.
*'''slot''': The slot id of the upgrade.
*'''slot''': The slot id of the upgrade. ''([[Upgrade list]] ordered by slot number)''


==Example==
==Example==
Line 23: Line 23:
         local upgrade = getVehicleUpgradeOnSlot ( theVehicle, i )
         local upgrade = getVehicleUpgradeOnSlot ( theVehicle, i )
         if ( upgrade ) then
         if ( upgrade ) then
             outputChatBox ( i .. ": " .. upgrade)
             outputChatBox ( getVehicleUpgradeSlotName ( i ) .. ": " .. upgrade)
         end
         end
     end
     end
end
end
addEventHandler ( "onPlayerEnterVehicle", getRootElement(), scriptOnPlayerEnterVehicle )
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), scriptOnPlayerEnterVehicle )
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>

Revision as of 17:19, 4 April 2009

Description

This function returns the current upgrade id on the specified vehicle's 'upgrade slot' An upgrade slot is a certain type of upgrade (eg: exhaust, spoiler), there are 17 slots (0 to 16).

Syntax

int getVehicleUpgradeOnSlot ( vehicle theVehicle, int slot )

Returns

Returns an integer with the upgrade on the slot if correct arguments were passed, false otherwise.

Required Arguments

  • theVehicle: The vehicle whose upgrade you want to retrieve.
  • slot: The slot id of the upgrade. (Upgrade list ordered by slot number)

Example

Click to collapse [-]
Server

This example prints the name and upgrades on each slot of an entered vehicle to the chat.

function scriptOnPlayerEnterVehicle ( theVehicle, seat, jacked )
    for i=0, 16 do
        local upgrade = getVehicleUpgradeOnSlot ( theVehicle, i )
        if ( upgrade ) then
            outputChatBox ( getVehicleUpgradeSlotName ( i ) .. ": " .. upgrade)
        end
    end
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), scriptOnPlayerEnterVehicle )

See Also