Browse docs

Inventory items

Copyable inventory definitions for all 72 Sky Treasure Hunt items in eight supported inventory formats.

The default installation uses 72 items: 12 pieces of equipment and 60 collectible finds. Register the full catalogue before starting Treasure Hunt. Startup checks the configured tools and sale items against Sky Base's item catalogue.

Choose your inventory tab and merge its entries into the existing item catalogue. The snippets use English labels; the German ox_inventory download below is available separately.

scuba_gear = { label = "Scuba set · Basic", weight = 8000, stack = false, close = true, consume = 0, client = { image = "scuba_gear.png" } },
scuba_gear_standard = { label = "Scuba set · Standard", weight = 10000, stack = false, close = true, consume = 0, client = { image = "scuba_gear_standard.png" } },
scuba_gear_premium = { label = "Scuba set · Professional", weight = 12000, stack = false, close = true, consume = 0, client = { image = "scuba_gear_premium.png" } },
metaldetector = { label = "Rusty metal detector", weight = 2500, stack = false, close = true, consume = 0, client = { image = "metaldetector.png" } },
metaldetector_standard = { label = "Standard metal detector", weight = 2500, stack = false, close = true, consume = 0, client = { image = "metaldetector_standard.png" } },
metaldetector_premium = { label = "Premium metal detector", weight = 2500, stack = false, close = true, consume = 0, client = { image = "metaldetector_premium.png" } },
shovel = { label = "Old shovel", weight = 2000, stack = false, close = true, consume = 0, client = { image = "shovel.png" } },
shovel_standard = { label = "Standard shovel", weight = 2000, stack = false, close = true, consume = 0, client = { image = "shovel_standard.png" } },
shovel_premium = { label = "Premium shovel", weight = 2000, stack = false, close = true, consume = 0, client = { image = "shovel_premium.png" } },

-- Iron / steel
treasure_rusty_nail = {
    label = "Rusty nail",
    weight = 15,
    stack = true,
    close = false,
    client = { image = "treasure_rusty_nail.png" },
},
treasure_steel_screw = {
    label = "Steel screw",
    weight = 20,
    stack = true,
    close = false,
    client = { image = "treasure_steel_screw.png" },
},
treasure_steel_chain = {
    label = "Steel chain",
    weight = 500,
    stack = true,
    close = false,
    client = { image = "treasure_steel_chain.png" },
},
treasure_tool_fragment = {
    label = "Tool fragment",
    weight = 250,
    stack = true,
    close = false,
    client = { image = "treasure_tool_fragment.png" },
},
treasure_horseshoe = {
    label = "Horseshoe",
    weight = 400,
    stack = true,
    close = false,
    client = { image = "treasure_horseshoe.png" },
},

-- Copper
treasure_copper_cable = {
    label = "Copper cable",
    weight = 150,
    stack = true,
    close = false,
    client = { image = "treasure_copper_cable.png" },
},
treasure_copper_pipe = {
    label = "Copper pipe",
    weight = 300,
    stack = true,
    close = false,
    client = { image = "treasure_copper_pipe.png" },
},
treasure_copper_coil = {
    label = "Copper coil",
    weight = 350,
    stack = true,
    close = false,
    client = { image = "treasure_copper_coil.png" },
},
treasure_copper_sheet = {
    label = "Copper sheet",
    weight = 200,
    stack = true,
    close = false,
    client = { image = "treasure_copper_sheet.png" },
},

-- Aluminium
treasure_aluminium_can = {
    label = "Aluminium can",
    weight = 15,
    stack = true,
    close = false,
    client = { image = "treasure_aluminium_can.png" },
},
treasure_aluminium_sheet = {
    label = "Aluminium sheet",
    weight = 150,
    stack = true,
    close = false,
    client = { image = "treasure_aluminium_sheet.png" },
},
treasure_aluminium_profile = {
    label = "Aluminium profile",
    weight = 250,
    stack = true,
    close = false,
    client = { image = "treasure_aluminium_profile.png" },
},
treasure_aluminium_lid = {
    label = "Aluminium lid",
    weight = 20,
    stack = true,
    close = false,
    client = { image = "treasure_aluminium_lid.png" },
},

-- Brass
treasure_brass_key = {
    label = "Brass key",
    weight = 25,
    stack = true,
    close = false,
    client = { image = "treasure_brass_key.png" },
},
treasure_brass_casing = {
    label = "Brass cartridge casing",
    weight = 10,
    stack = true,
    close = false,
    client = { image = "treasure_brass_casing.png" },
},
treasure_brass_fitting = {
    label = "Brass fitting",
    weight = 100,
    stack = true,
    close = false,
    client = { image = "treasure_brass_fitting.png" },
},
treasure_brass_button = {
    label = "Brass button",
    weight = 10,
    stack = true,
    close = false,
    client = { image = "treasure_brass_button.png" },
},

-- Lead
treasure_fishing_sinker = {
    label = "Fishing sinker",
    weight = 50,
    stack = true,
    close = false,
    client = { image = "treasure_fishing_sinker.png" },
},
treasure_lead_weight = {
    label = "Lead weight",
    weight = 200,
    stack = true,
    close = false,
    client = { image = "treasure_lead_weight.png" },
},
treasure_lead_ball = {
    label = "Lead ball",
    weight = 30,
    stack = true,
    close = false,
    client = { image = "treasure_lead_ball.png" },
},

-- Silver
treasure_silver_ring = {
    label = "Silver ring",
    weight = 10,
    stack = true,
    close = false,
    client = { image = "treasure_silver_ring.png" },
},
treasure_silver_chain = {
    label = "Silver necklace",
    weight = 25,
    stack = true,
    close = false,
    client = { image = "treasure_silver_chain.png" },
},
treasure_silver_pendant = {
    label = "Silver pendant",
    weight = 15,
    stack = true,
    close = false,
    client = { image = "treasure_silver_pendant.png" },
},
treasure_silver_coin = {
    label = "Silver coin",
    weight = 20,
    stack = true,
    close = false,
    client = { image = "treasure_silver_coin.png" },
},

-- Gold
treasure_gold_ring = {
    label = "Gold ring",
    weight = 10,
    stack = true,
    close = false,
    client = { image = "treasure_gold_ring.png" },
},
treasure_gold_chain = {
    label = "Gold necklace",
    weight = 25,
    stack = true,
    close = false,
    client = { image = "treasure_gold_chain.png" },
},
treasure_gold_earring = {
    label = "Gold earring",
    weight = 5,
    stack = true,
    close = false,
    client = { image = "treasure_gold_earring.png" },
},
treasure_gold_coin = {
    label = "Gold coin",
    weight = 20,
    stack = true,
    close = false,
    client = { image = "treasure_gold_coin.png" },
},

-- Mystical artifacts
treasure_silent_king_mask = {
    label = "Mask of the Silent King",
    weight = 650,
    stack = true,
    close = false,
    client = { image = "treasure_silent_king_mask.png" },
},
treasure_star_heart = {
    label = "Heart of the Star",
    weight = 850,
    stack = true,
    close = false,
    client = { image = "treasure_star_heart.png" },
},
treasure_queen_diamond_necklace = {
    label = "A Queen's Diamond Necklace",
    weight = 180,
    stack = true,
    close = false,
    client = { image = "treasure_queen_diamond_necklace.png" },
},

-- Additional album finds; loot pools are configured separately.
treasure_brass_seal = {
    label = "Brass seal",
    weight = 120,
    stack = true,
    close = false,
    client = { image = "treasure_brass_seal.png" },
},
treasure_old_dog_tag = {
    label = "Old dog tag",
    weight = 20,
    stack = true,
    close = false,
    client = { image = "treasure_old_dog_tag.png" },
},
treasure_ornate_belt_buckle = {
    label = "Ornate belt buckle",
    weight = 150,
    stack = true,
    close = false,
    client = { image = "treasure_ornate_belt_buckle.png" },
},
treasure_bicycle_frame = {
    label = "Rusty bicycle frame",
    weight = 3500,
    stack = true,
    close = false,
    client = { image = "treasure_bicycle_frame.png" },
},
treasure_boat_anchor = {
    label = "Small boat anchor",
    weight = 2500,
    stack = true,
    close = false,
    client = { image = "treasure_boat_anchor.png" },
},
treasure_steel_cable = {
    label = "Steel cable remnant",
    weight = 600,
    stack = true,
    close = false,
    client = { image = "treasure_steel_cable.png" },
},
treasure_steel_padlock = {
    label = "Rusty steel padlock",
    weight = 300,
    stack = true,
    close = false,
    client = { image = "treasure_steel_padlock.png" },
},
treasure_old_handcuffs = {
    label = "Old handcuffs",
    weight = 350,
    stack = true,
    close = false,
    client = { image = "treasure_old_handcuffs.png" },
},
treasure_bent_crowbar = {
    label = "Bent crowbar",
    weight = 1800,
    stack = true,
    close = false,
    client = { image = "treasure_bent_crowbar.png" },
},
treasure_brake_disc = {
    label = "Rusty brake disc",
    weight = 4500,
    stack = true,
    close = false,
    client = { image = "treasure_brake_disc.png" },
},
treasure_empty_steel_cashbox = {
    label = "Empty steel cashbox",
    weight = 1200,
    stack = true,
    close = false,
    client = { image = "treasure_empty_steel_cashbox.png" },
},
treasure_mother_of_pearl_shell = {
    label = "Large mother-of-pearl shell",
    weight = 200,
    stack = true,
    close = false,
    client = { image = "treasure_mother_of_pearl_shell.png" },
},
treasure_sea_glass = {
    label = "Rare sea glass",
    weight = 30,
    stack = true,
    close = false,
    client = { image = "treasure_sea_glass.png" },
},
treasure_fossil_shark_tooth = {
    label = "Fossil shark tooth",
    weight = 40,
    stack = true,
    close = false,
    client = { image = "treasure_fossil_shark_tooth.png" },
},
treasure_amber = {
    label = "Amber specimen",
    weight = 35,
    stack = true,
    close = false,
    client = { image = "treasure_amber.png" },
},
treasure_ceramic_amphora = {
    label = "Antique ceramic amphora",
    weight = 1600,
    stack = true,
    close = false,
    client = { image = "treasure_ceramic_amphora.png" },
},
treasure_brass_ship_plaque = {
    label = "Historic ship plaque",
    weight = 400,
    stack = true,
    close = false,
    client = { image = "treasure_brass_ship_plaque.png" },
},
treasure_old_sextant = {
    label = "Old sextant",
    weight = 1000,
    stack = true,
    close = false,
    client = { image = "treasure_old_sextant.png" },
},
treasure_message_bottle = {
    label = "Antique message bottle",
    weight = 500,
    stack = true,
    close = false,
    client = { image = "treasure_message_bottle.png" },
},
treasure_collectible_card = {
    label = "Rare collectible card",
    weight = 5,
    stack = true,
    close = false,
    client = { image = "treasure_collectible_card.png" },
},
treasure_compact_camera = {
    label = "Analog compact camera",
    weight = 300,
    stack = true,
    close = false,
    client = { image = "treasure_compact_camera.png" },
},
treasure_signed_film_program = {
    label = "Signed film programme",
    weight = 100,
    stack = true,
    close = false,
    client = { image = "treasure_signed_film_program.png" },
},
treasure_crystal_perfume_bottle = {
    label = "Vintage crystal perfume bottle",
    weight = 250,
    stack = true,
    close = false,
    client = { image = "treasure_crystal_perfume_bottle.png" },
},
treasure_limited_model_car = {
    label = "Limited model car",
    weight = 150,
    stack = true,
    close = false,
    client = { image = "treasure_limited_model_car.png" },
},
treasure_retro_game_console = {
    label = "Retro game console",
    weight = 1300,
    stack = true,
    close = false,
    client = { image = "treasure_retro_game_console.png" },
},
treasure_rare_record = {
    label = "Rare vinyl record",
    weight = 180,
    stack = true,
    close = false,
    client = { image = "treasure_rare_record.png" },
},
treasure_antique_porcelain_cup = {
    label = "Antique porcelain cup",
    weight = 180,
    stack = true,
    close = false,
    client = { image = "treasure_antique_porcelain_cup.png" },
},
treasure_limited_sneakers = {
    label = "Limited sneakers",
    weight = 900,
    stack = true,
    close = false,
    client = { image = "treasure_limited_sneakers.png" },
},
treasure_holographic_dragon_card = {
    label = "Holographic dragon collectible card",
    weight = 5,
    stack = true,
    close = false,
    client = { image = "treasure_holographic_dragon_card.png" },
},

-- Magnet sets; use is registered by Sky.FW.RegisterUsableItem.
["fishing_magnet"] = { label = "Magnet set · Basic", weight = 1500, stack = false, close = true, consume = 0, client = { image = "fishing_magnet.png" } },
["fishing_magnet_standard"] = { label = "Magnet set · Standard", weight = 1500, stack = false, close = true, consume = 0, client = { image = "fishing_magnet_standard.png" } },
["fishing_magnet_premium"] = { label = "Magnet set · Premium", weight = 1500, stack = false, close = true, consume = 0, client = { image = "fishing_magnet_premium.png" } },

ox_inventory

The resource includes complete import templates:

Item languageFile in the resourceDownload
Englishconfig/inventory/items_ox_en.luaEnglish item definitions
Germanconfig/inventory/items_ox.luaGerman item definitions

Merge the entries from one template into the existing return { ... } table in ox_inventory/data/items.lua. Keep other items and avoid duplicate IDs. Copy the 72 matching PNGs from sky_treasurehunt/config/inventory/images/ into ox_inventory/web/images/.

Equipment is reusable and uses consume = 0. Treasure Hunt registers equipment use through Sky Base; do not add another client.export or client.event. Collectible finds stack and have no use action.

Other inventory providers

The tabs above use the same item IDs and weights as the English template. Weights are in grams except for jaksam_inventory, which uses kilograms. Equipment is non-stackable and reusable; finds stack and have no use action. Sky Base registers equipment use, so keep CodeM V2 entries free of client events or exports and use consume = 0.

Merge Lua entries into your provider's existing item table and copy the matching PNGs to its item-image directory. For an ESX database inventory, run the esx_inventory (DB) tab against its items table. Treasure Hunt's import.sql creates its persistence tables and does not register inventory items.

config/inventory/catalogue.json supplies the 60 find names, example weights, categories and image filenames. If you rename configured equipment or reward IDs, update the matching inventory entries and images too.

Reload the catalogue

Apply the changes through your inventory's normal restart procedure. If Sky Base was already running when items were added, refresh its server item catalogue with the documented Sky.FW.RefreshItems() API before restarting Treasure Hunt, or perform a planned full server restart in the correct dependency order. Restarting only the inventory may leave Sky Base's cached catalogue unchanged.

Resource language and inventory language are separate. Built-in Treasure Hunt labels follow Config.Locale; the external inventory shows the labels from the template you installed.

Equipment IDs

EquipmentItem ID
Rusty detectormetaldetector
Standard detectormetaldetector_standard
Premium detectormetaldetector_premium
Old shovelshovel
Standard shovelshovel_standard
Premium shovelshovel_premium
Basic magnet setfishing_magnet
Standard magnet setfishing_magnet_standard
Premium magnet setfishing_magnet_premium
Basic scuba setscuba_gear
Standard scuba setscuba_gear_standard
Professional scuba setscuba_gear_premium

Each ID has its own same-named .png image. Owning an advanced item does not bypass its skill requirement. Scuba air is saved separately per character and tier; an externally granted set may need a paid refill before first use.

Collectible find IDs

The following names and IDs come from the supplied inventory catalogue. An item's presence here does not make it available in every method; the reward pools and learned find tiers determine where it can be discovered.

FindItem ID
Rusty nailtreasure_rusty_nail
Steel screwtreasure_steel_screw
Steel chaintreasure_steel_chain
Tool fragmenttreasure_tool_fragment
Horseshoetreasure_horseshoe
Copper cabletreasure_copper_cable
Copper pipetreasure_copper_pipe
Copper coiltreasure_copper_coil
Copper sheettreasure_copper_sheet
Aluminium cantreasure_aluminium_can
Aluminium sheettreasure_aluminium_sheet
Aluminium profiletreasure_aluminium_profile
Aluminium lidtreasure_aluminium_lid
Brass keytreasure_brass_key
Brass cartridge casingtreasure_brass_casing
Brass fittingtreasure_brass_fitting
Brass buttontreasure_brass_button
Fishing sinkertreasure_fishing_sinker
Lead weighttreasure_lead_weight
Lead balltreasure_lead_ball
Silver ringtreasure_silver_ring
Silver necklacetreasure_silver_chain
Silver pendanttreasure_silver_pendant
Silver cointreasure_silver_coin
Gold ringtreasure_gold_ring
Gold necklacetreasure_gold_chain
Gold earringtreasure_gold_earring
Gold cointreasure_gold_coin
Mask of the Silent Kingtreasure_silent_king_mask
Heart of the Startreasure_star_heart
A Queen's Diamond Necklacetreasure_queen_diamond_necklace
Brass sealtreasure_brass_seal
Old dog tagtreasure_old_dog_tag
Ornate belt buckletreasure_ornate_belt_buckle
Rusty bicycle frametreasure_bicycle_frame
Small boat anchortreasure_boat_anchor
Steel cable remnanttreasure_steel_cable
Rusty steel padlocktreasure_steel_padlock
Old handcuffstreasure_old_handcuffs
Bent crowbartreasure_bent_crowbar
Rusty brake disctreasure_brake_disc
Empty steel cashboxtreasure_empty_steel_cashbox
Large mother-of-pearl shelltreasure_mother_of_pearl_shell
Rare sea glasstreasure_sea_glass
Fossil shark toothtreasure_fossil_shark_tooth
Amber specimentreasure_amber
Antique ceramic amphoratreasure_ceramic_amphora
Historic ship plaquetreasure_brass_ship_plaque
Old sextanttreasure_old_sextant
Antique message bottletreasure_message_bottle
Rare collectible cardtreasure_collectible_card
Analog compact cameratreasure_compact_camera
Signed film programmetreasure_signed_film_program
Vintage crystal perfume bottletreasure_crystal_perfume_bottle
Limited model cartreasure_limited_model_car
Retro game consoletreasure_retro_game_console
Rare vinyl recordtreasure_rare_record
Antique porcelain cuptreasure_antique_porcelain_cup
Limited sneakerstreasure_limited_sneakers
Holographic dragon collectible cardtreasure_holographic_dragon_card