Give a random item from category

random.lua

local function GiveRandomItemFromCategory( ply, categoryName )
    local factory = Pointshop2.ItemFromCategoryFactory:new()
    factory.settings =  {
        ["ManualSettings.CategoryName"] = categoryName,
        ["BasicSettings.WeightedRandom"] = true
    }

    local item = factory:CreateItem( true )
    return ply:PS2_EasyAddItem( item.class.className )
end

e.g.

GiveRandomItemFromCategory( player.GetByID( 1 ), "Hats" )