📘Blueprint Items Guide

Blueprints are special items that control access to crafting specific recipes. When enabled, players must own a blueprint in their inventory to see or craft an item.

This system is great for:

• Controlling powerful or illegal item crafting

• Creating lootable or tradable crafting knowledge

• Adding progression and exclusivity to your server

---

🧩 How Blueprint Items Work

Each crafting recipe can require a blueprint item by setting:

UseBlueprint = true,
BlueprintItem = "blueprint_pistol",

• If the player doesn’t own the blueprint, the item will not appear in the crafting UI (unless ShowOnList = true)

• If RemoveBlueprint = true, the blueprint is consumed after crafting

---

🛠️ Step-by-Step: Creating a Blueprint Item

1️⃣ Add the Blueprint to Your Inventory System

For ox_inventory:

Add to your data/items.lua:

['blueprint_pistol'] = {
    label = 'Pistol Blueprint',
    weight = 1,
    stack = true,
    close = true,
    description = 'A schematic for crafting a basic pistol.',
    client = {},
}

For qb-inventory / ps-inventory:

Add to your shared.lua or database as:

["blueprint_pistol"] = {
    name = "blueprint_pistol",
    label = "Pistol Blueprint",
    weight = 1,
    type = "item",
    image = "blueprint_pistol.png",
    unique = true,
    useable = false,
    shouldClose = true,
    description = "A schematic for crafting a basic pistol."
}

💡 Don’t forget to add the corresponding image (blueprint_pistol.png) to your inventory image directory!

---

2️⃣ Add the Blueprint to a Recipe

In your crafting table config (PreSetTables or PlaceableTables), define the item like this:

["weapon_pistol"] = {
    Label = "Pistol",
    DefaultQuantity = 1,
    XPEnable = true,
    Level = 2,
    xpGain = 5,
    UseBlueprint = true,
    BlueprintItem = "blueprint_pistol",
    ShowOnList = false,
    RemoveBlueprint = false,
    ConsumeDurability = 0,

    ["Material"] = {
        ["rubber"] = { Label = "Rubber", amount = 3 },
        ["steel"] = { Label = "Steel", amount = 2 }
    }
}

---

🧠 Explanation of Key Fields

Field	Description
UseBlueprint	Enables blueprint requirement
BlueprintItem	Name of the required item
RemoveBlueprint	If true, consumes the item when crafting
ShowOnList	If false, hides the item until player owns the blueprint

---

🎁 How to Give Blueprints to Players

You can distribute blueprints through:

• Loot tables or crates

• Shop systems

• Crafting them from other recipes

• Job or gang rewards

• Admin commands or events:

exports.ox_inventory:AddItem(source, 'blueprint_pistol', 1)

---

💡 Tips

• Blueprints can be made tradable between players for an in-game economy.

• You can create tiered blueprints (e.g., blueprint_sniper, blueprint_explosive) for advanced items.

• Combine blueprints with XP and level requirements for full progression.