Browse docs

Inventory items

Every core Sky Pets item ID, default use, consumption rule, and ox_inventory integration note.

Register these IDs in the inventory provider configured by sky_base. The supplied docs/customer/ox_inventory.lua is a merge template for the existing ox_inventory/data/items.lua table. Copy images from docs/inventory-images into ox_inventory/web/images; do not replace the whole catalogue.

Item ID	Default use	Consumed?
`pet_food`	Food bowl; +20 hunger points	One on successful feeding
`pet_food_2`	Second food bowl; +20 hunger points	One on successful feeding
`pet_water_bottle`	Water bowl; +10 thirst points	One on successful drinking
`pet_treat`	Training reward; +5 hunger points	One on accepted reward
`pet_ball_1`	Fetch ball	Reusable
`pet_ball_2`	Fetch ball	Reusable
`pet_ball_3`	Fetch ball	Reusable
`pet_bone_1`	Chewing toy	Reusable
`pet_bone_2`	Chewing toy	Reusable
`pet_bandage`	Heal a living pet by 25 life points	One on successful use
`pet_rescue_kit`	Rescue a dying pet before its deadline; restores 50% life	One on successful rescue

The default food, water, treat, bandage and rescue IDs are configurable under Needs, Training and Health. Shop supply entries derive these core care IDs from those settings. If you rename an item, register the new inventory ID and ensure the inventory's usable event and shop stock still match it. Ball, bone and second-food IDs come from the shipped pet-item definitions.

ox_inventory example

ox_inventory/data/items.lua

["pet_treat"] = {
    label = "Pet treat", weight = 20, stack = true, close = true, consume = 0,
    client = { event = "sky_pets:useTreat" },
},
["pet_food"] = {
    label = "Pet food", weight = 500, stack = true, close = true, consume = 0,
    client = { event = "sky_pets:useFood", image = "pet_food.png" },
},

Keep consume = 0 for every Sky Pets item, including treats and medical items. The resource validates the action and removes a consumable server-side. Setting automatic inventory consumption can remove an item before Sky Pets decides whether use is allowed. The complete item entries and image names are in the customer package template.

The sky_pets:use... client events in item definitions are item entry points, not server mutation APIs. See Events for their scope and Care and health for usage conditions.

Animal form

Optional player transformation, access grants, safety rules, recovery, and its server exports.

Commands and permissions

Player controls, staff tools, configurator commands, and diagnostic permission groups.