Crafting Recipes (Drag & Drop)

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.

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

Drag source onto target

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

Recipe check

The system checks if there’s a matching recipe.

Crafting happens

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

Items are consumed

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

Result is added

The result item is added to the inventory.

Step-by-step guide

Open the crafting hook

Navigate to: jaksam_inventory/_hooks/sv_craftings.lua

Find the recipes table

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

Add your recipe

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
        },
    }

Restart

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

number

How many of the source item are needed for the recipe

boolean

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

string

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

number

How many of the target item are needed for the recipe

boolean

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

string

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

number

How many result items will be created

Examples

Upgrade scope to thermal
Combine materials

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.

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.

​How it works

​Step-by-step guide

​Recipe properties explained

​Examples

​Important notes

Same inventory only

Item names must match

Quantity checks

Multiple recipes

How it works

Step-by-step guide

Recipe properties explained

Examples

Important notes