Recettes de craft (glisser-déposer)

Tu veux que les joueurs puissent fabriquer des items en glissant un item sur un autre ? Ce guide te montre comment faire, étape par étape. Cette fonctionnalité permet aux joueurs de fabriquer des items en glissant un item source sur un item cible dans le même inventaire. Quand la recette correspond, les items sont combinés et le résultat est créé.

Cette fonctionnalité est fournie par le hook _hooks/sv_craftings.lua. Tu as juste besoin d’ajouter tes recettes à la table CRAFTING_RECIPES.

Comment ça marche

Glisse la source sur la cible

Le joueur glisse un item source sur un item cible dans le même inventaire.

Vérification de la recette

Le système vérifie s’il existe une recette correspondante.

Le craft se produit

Si la recette correspond et que les quantités sont suffisantes, le craft se produit.

Les items sont consommés

Les items source et/ou cible sont retirés (selon les paramètres de la recette).

Le résultat est ajouté

L’item résultat est ajouté à l’inventaire.

Guide étape par étape

Ouvre le hook de craft

Va dans : jaksam_inventory/_hooks/sv_craftings.lua

Trouve la table des recettes

Trouve la table CRAFTING_RECIPES (elle se trouve près du haut du fichier).

Ajoute ta recette

Ajoute ta recette en suivant ce format :

    local CRAFTING_RECIPES = {
        ["source_item_name"] = {
            sourceQuantityRequired = 1,        -- Combien d'items source sont nécessaires
            sourceIsToRemove = true,           -- Retirer l'item source après le craft ?
            targetItem = "target_item_name",  -- Nom de l'item cible
            targetQuantity = 1,                -- Combien d'items cibles sont nécessaires
            targetIsToRemove = true,           -- Retirer l'item cible après le craft ?
            resultItem = "result_item_name",  -- Nom de l'item créé
            resultQuantity = 1,                -- Combien d'items résultats sont créés
        },
    }

Redémarre

Sauvegarde le fichier et redémarre le script/recharge le serveur.

C’est tout ! Maintenant les joueurs peuvent glisser l’item source sur l’item cible pour fabriquer.

Explication des propriétés de la recette

number

Combien d’items source sont nécessaires pour la recette

boolean

Mets true si l’item source doit être retiré après le craft, false pour le garder

string

Le nom exact (tel que défini dans items.lua) de l’item sur lequel tu glisses l’item source

number

Combien d’items cibles sont nécessaires pour la recette

boolean

Mets true si l’item cible doit être retiré après le craft, false pour le garder

string

Le nom exact (tel que défini dans items.lua) de l’item qui sera créé

number

Combien d’items résultats seront créés

Exemples

Améliorer une lunette en thermique
Combiner des matériaux

Combine une clé à molette avec une lunette avancée pour créer une lunette thermique :

    ["weapon_wrench"] = {
        sourceQuantityRequired = 1,
        sourceIsToRemove = false,              -- Garde la clé à molette (outil réutilisable)
        targetItem = "advanced_scope",
        targetQuantity = 1,
        targetIsToRemove = true,               -- Retire la lunette avancée
        resultItem = "thermal_scope",
        resultQuantity = 1,
    },

Comment l’utiliser : glisse la clé à molette sur la lunette avancée → la lunette thermique est créée, la clé à molette reste, la lunette avancée est retirée.

Combine 2 morceaux de bois avec 1 clou pour créer une planche en bois :

    ["wood"] = {
        sourceQuantityRequired = 2,
        sourceIsToRemove = true,               -- Retire les 2 morceaux de bois
        targetItem = "nail",
        targetQuantity = 1,
        targetIsToRemove = true,               -- Retire le clou
        resultItem = "wooden_plank",
        resultQuantity = 1,
    },

Comment l’utiliser : glisse 2 items bois sur 1 clou → la planche en bois est créée, les deux matériaux sont consommés.

Notes importantes

Même inventaire uniquement

Le craft ne fonctionne que quand les deux items sont dans le même inventaire (tu ne peux pas glisser depuis l’inventaire du joueur vers l’inventaire d’un véhicule)

Les noms d'items doivent correspondre

Les noms targetItem et resultItem doivent correspondre exactement aux noms d’items dans _data/items.lua

Vérification des quantités

Le système vérifie automatiquement si tu as assez d’items avant de fabriquer

Plusieurs recettes

Tu peux ajouter autant de recettes que tu veux à la table CRAFTING_RECIPES

Une source, plusieurs cibles : chaque item source ne peut avoir qu’une seule recette. Si tu as besoin de plusieurs recettes pour le même item source, tu devras utiliser des items source différents ou créer des systèmes de craft séparés.

​Comment ça marche

​Guide étape par étape

​Explication des propriétés de la recette

​Exemples

​Notes importantes

Même inventaire uniquement

Les noms d'items doivent correspondre

Vérification des quantités

Plusieurs recettes

Comment ça marche

Guide étape par étape

Explication des propriétés de la recette

Exemples

Notes importantes