Crafting

Want players to craft items by dragging one item over another? This guide shows you how, step-by-step

This feature allows players to craft items by dragging a source item over a target item in the same inventory. When the recipe matches, the items are combined and the result is created.

Note: This functionality is provided by the _hooks/sv_craftings.lua hook. You just need to add your recipes to the CRAFTING_RECIPES table.

How it works

1. Player drags a source item over a target item in the same inventory

2. The system checks if there's a matching recipe

3. If the recipe matches and quantities are sufficient, the crafting happens

4. Source and/or target items are removed (based on recipe settings)

5. The result item is added to the inventory

Step-by-step guide

1. Open your server files and navigate to: jaksam_inventory/_hooks/sv_craftings.lua

2. Find the CRAFTING_RECIPES table (it's near the top of the file)

3. Add your recipe following this format:

local CRAFTING_RECIPES = {
    ["source_item_name"] = {
        sourceQuantityRequired = 1,        -- How many source items needed
        sourceIsToRemove = true,           -- Remove source item after crafting?
        targetItem = "target_item_name",  -- Name of the target item
        targetQuantity = 1,                -- How many target items needed
        targetIsToRemove = true,           -- Remove target item after crafting?
        resultItem = "result_item_name",  -- Name of the item created
        resultQuantity = 1,                -- How many result items created
    },
}

1. Save the file and restart the script/reload the server

That's it! Now players can drag the source item over the target item to craft.

Recipe properties explained

• sourceQuantityRequired: How many of the source item are needed for the recipe

• sourceIsToRemove: Set to true if the source item should be removed after crafting, false to keep it

• targetItem: The exact name (as defined in items.lua) of the item you drag the source item onto

• targetQuantity: How many of the target item are needed for the recipe

• targetIsToRemove: Set to true if the target item should be removed after crafting, false to keep it

• resultItem: The exact name (as defined in items.lua) of the item that will be created

• resultQuantity: How many result items will be created

Examples

Example 1: Upgrade scope to thermal scope

Combine a wrench with an advanced scope to create a thermal scope:

["weapon_wrench"] = {
    sourceQuantityRequired = 1,
    sourceIsToRemove = false,              -- Keep the wrench (reusable tool)
    targetItem = "advanced_scope",
    targetQuantity = 1,
    targetIsToRemove = true,               -- Remove the advanced scope
    resultItem = "thermal_scope",
    resultQuantity = 1,
},

How to use: Drag the wrench over the advanced scope → thermal scope is created, wrench stays, advanced scope is removed.

Example 2: Combine materials

Combine 2 pieces of wood with 1 nail to create a wooden plank:

["wood"] = {
    sourceQuantityRequired = 2,
    sourceIsToRemove = true,               -- Remove the 2 wood pieces
    targetItem = "nail",
    targetQuantity = 1,
    targetIsToRemove = true,               -- Remove the nail
    resultItem = "wooden_plank",
    resultQuantity = 1,
},

How to use: Drag 2 wood items over 1 nail → wooden plank is created, both materials are consumed.

Important notes

• Same inventory only: Crafting only works when both items are in the same inventory (you can't drag from player inventory to vehicle inventory)

• Item names must match: The targetItem and resultItem names must exactly match the item names in _data/items.lua

• Quantity checks: The system automatically checks if you have enough items before crafting

• Multiple recipes: You can add as many recipes as you want to the CRAFTING_RECIPES table

• One source, multiple targets: Each source item can only have one recipe. If you need multiple recipes for the same source item, you'll need to use different source items or create separate crafting systems