GetValidPedModels

This function returns all valid ped models. The syntax is different for server and client sides.

Syntax

Click to collapse [-]

Client

table getValidPedModels ( [ bool includeCustom = true ] )

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

ADDED/UPDATED IN VERSION 1.6.0 r22780:

• includeCustom: Specifies if the table returned should contain custom model IDs allocated with engineRequestModel.

Returns

Returns a table with all valid ped models that exist on the client, containing the custom model IDs unless includeCustom is false.

Click to collapse [-]

Server

table getValidPedModels ( )

Returns

Returns a table with all valid ped models that exist on the server.

Examples

This example will check if the specified skin ID is a valid skin via a command.

function isValidSkin( thePlayer, command, specifiedSkin )
    specifiedSkin = tonumber ( specifiedSkin )
    if ( specifiedSkin ) then -- If skin specified
        local allSkins = getValidPedModels ( ) -- Get valid skin IDs
        local result = false -- Define result, it is currently false
        for _, skin in ipairs( allSkins ) do -- Check all skins
            if skin == specifiedSkin then -- If skin equals specified one, it is valid
                result = true -- So set it as result
                break -- stop looping through a table after we found the skin
            end
        end
        if ( result ) then -- If we got results
            outputChatBox( specifiedSkin .. " is a valid skin ID.", thePlayer, 0, 255, 0 ) -- It is valid, output it
        else -- If we didn't get results
            outputChatBox( specifiedSkin .. " is not a valid skin ID.", thePlayer, 0, 255, 0 ) -- No result, it is not valid
        end
    else
        outputChatBox( "Please specify a valid number to check!", thePlayer, 255, 0, 0 )
    end
end
addCommandHandler("checkskin",isValidSkin) -- bind 'checkskin' command to 'isValidSkin' function

See Also

• addPedClothes
• getPedClothes
• removePedClothes
• createPed
• getPedAmmoInClip
• getPedArmor
• getPedFightingStyle
• getPedOccupiedVehicle
• getPedOccupiedVehicleSeat
• getPedStat
• getPedTarget
• getPedTotalAmmo
• getPedWalkingStyle
• getPedWeapon
• getPedWeaponSlot
• getPedContactElement
• getValidPedModels
• isPedChoking
• isPedDead
• isPedDoingGangDriveby
• isPedDucked
• isPedHeadless
• isPedInVehicle
• isPedOnGround
• isPedReloadingWeapon
• isPedWearingJetpack
• killPed
• removePedFromVehicle
• setPedAnimation
• setPedAnimationProgress
• setPedAnimationSpeed
• setPedArmor
• setPedDoingGangDriveby
• setPedFightingStyle
• setPedHeadless
• setPedStat
• setPedWalkingStyle
• setPedWeaponSlot
• warpPedIntoVehicle