Accueil › Documentation › Configuration · origen_inventory

Configuration · origen_inventory

origen_inventory se configure via config.lua, config_sv.lua et les fichiers modulaires du dossier config/. Cette page documente toutes les variables, regroupées par domaine.

Général — `config.lua`

Variable	Type	Par défaut	Description
`Config.Debug`	`boolean`	`true`	Active les logs de débogage dans tous les sous-systèmes. Désactive-le en production.
`Config.Language`	`string`	`"es"`	Langue chargée depuis `locales/translations/`. Accepte `es` ou `en`.
`Config.Framework`	`string`	détection automatique	`"qbx"`, `"esx"`, `"qbcore"` ou `"NONE"`. Renvoyé par `AutoSelectFramework()`.
`Config.Phone.Resource`	`string`	`"qs-smartphone-pro"`	Intégration du téléphone. Accepte `"qs-smartphone-pro"`, `"lb-phone"`, `"none"`.
`Config.Progressbar`	`string`	`"default"`	Fournisseur de barre de progression. L’un de `default`, `esx_progressbar`, `qb-core`, `qs-progressbar`, `ox_lib`.
`Config.UseInventoryComsumables`	`boolean`	`true`	Active la gestion intégrée des consommables manger/boire/alcool.
`Config.CreateStashIfNoExists`	`boolean`	`true`	Crée automatiquement une ligne de stash quand un ID de stash inconnu est ouvert.
`Config.DefaultOpenKey`	`string`	`"F2"`	Touche attribuée uniquement la première fois pour ouvrir l’inventaire. Une fois enregistrée, les joueurs la modifient depuis les raccourcis clavier de FiveM.
`Config.HotbarOpenKey`	`string`	`"TAB"`	Touche attribuée pour afficher/masquer la hotbar. Utilisée uniquement quand `Config.UI.Hotbar = true`.
`Config.DisableEscOnInventoryOpen`	`boolean`	`true`	Désactive `ESC` tant que l’interface de l’inventaire est ouverte.
`Config.DisableMovementOnInventoryOpen`	`boolean`	`false`	Immobilise le joueur tant que l’interface est ouverte.
`Config.DisablePKey`	`boolean`	`true`	Désactive la touche de carte par défaut (`P`) tant que l’inventaire est ouvert.
`Config.NotifyExports.GiveItem`	`boolean`	`true`	Envoie une notification au joueur quand `giveItem` est utilisé.
`Config.NotifyExports.RemoveItem`	`boolean`	`true`	Envoie une notification au joueur quand `removeItem` est utilisé.

Réglages des drops

Variable	Type	Par défaut	Description
`Config.Drop.MaxWeight`	`number`	`100000`	Poids total maximal par drop au sol.
`Config.Drop.MaxSlots`	`number`	`10`	Nombre maximal de slots par drop au sol.

Couleurs des marqueurs

lua

Config.MarkerColors = {
    give_player = vec4(0, 0, 0, 255),
}

Flags expérimentaux

Variable	Type	Par défaut	Description
`Config.Experimentals.giveItemAlgorithm`	`string`	`"no_stack"`	Algorithme utilisé pour donner des objets. `stack_unique` permet de donner des stacks d’objets uniques, `slot_based` attribue automatiquement des slots aux armes et `no_stack` est l’ancien comportement à un seul objet.

Les flags expérimentaux peuvent corrompre les données de l’inventaire dans certains cas limites. Active-les d’abord uniquement sur un serveur de test.

Joueur — `config/player.lua`

Variable	Type	Par défaut	Description
`Config.Player.GiveDistance`	`number`	`3.5`	Distance maximale en mètres pour donner des objets à un autre joueur.
`Config.Player.DropMarkerDistance`	`number`	`3.0`	Distance à partir de laquelle le marqueur du drop au sol devient visible.
`Config.Player.MaxWeight`	`number`	`120000`	Poids total maximal de l’inventaire (grammes).
`Config.Player.MaxInventorySlots`	`number`	`40`	Nombre maximal de slots.
`Config.Player.SaveInterval`	`number`	`40`	Intervalle de sauvegarde automatique en minutes.
`Config.Player.ShopTimeout`	`number`	`2`	Délai d’attente en secondes avant de pouvoir rouvrir une boutique.

Protection anti-triche

Variable	Type	Par défaut	Description
`Config.Player.CheatProtect.Enable`	`boolean`	`true`	Interrupteur général des mesures anti-triche. Ignoré pour les administrateurs reconnus par `Bridge.IsAdmin`.
`Config.Player.CheatProtect.MaxDistanceRemoteOpen`	`number`	`10.0`	Distance maximale autorisée entre le joueur et l’inventaire qu’il ouvre.
`Config.Player.CheatProtect.EnableNoItemWeapons`	`boolean`	`true`	Retire les armes données au joueur sans passer par l’inventaire (scripts tiers).

Clothes-As-Item (CAI)

Variable	Type	Par défaut	Description
`Config.Player.ClothesAsItem.Enable`	`boolean`	`true`	Active le sous-système Clothes-As-Item. Nécessite `origen_clothing`.

Money-As-Item (MAI)

Variable	Type	Par défaut	Description
`Config.Player.MoneyAsItem.Enable`	`boolean`	`true`	Active Money-As-Item. L’objet d’argent est enregistré automatiquement par la ressource.
`Config.Player.MoneyAsItem.Accounts`	`table`	voir ci-dessous	Comptes associés à des objets d’inventaire.

lua

Config.Player.MoneyAsItem.Accounts = {
    [DetectMoneyOrCash()] = {
        account = DetectMoneyOrCash(),
        label = 'Dinero',
        description = 'El mundo gira a su alrededor',
        weight = 0,
    },
    -- black_money = {
    --     account = 'black_money',
    --     label = 'Black Money',
    --     description = 'Black Money',
    --     weight = 0,
    -- }
}

Interface

Variable	Type	Par défaut	Description
`Config.UI.Mini`	`boolean`	`true`	Quand un inventaire secondaire (stash, coffre, etc.) est ouvert, masque l’inventaire du joueur jusqu’à sa fermeture.
`Config.UI.ShowPlayerNameOnGiveItem`	`boolean`	`true`	Affiche le nom du destinataire dans l’invite de don d’objet.
`Config.UI.Hotbar`	`boolean`	`true`	Active la hotbar.
`Config.UI.ShowCraftingIndicator`	`boolean`	`true`	Affiche un petit indicateur pendant qu’une action de craft est en cours.
`Config.UI.PlayerInventoryLabel`	`string`	`"Inventory"`	Libellé affiché en haut de l’onglet de l’inventaire du joueur.
`Config.UI.Color`	`string`	`"default"`	Thème de couleurs de l’interface.
`Config.UI.DelayNuiFocusForTabKey`	`boolean`	`false`	Retarde le focus NUI quand on appuie sur TAB (corrige des problèmes de saisie sur certains clients).
`Config.UI.EnableTabs`	`table`	voir ci-dessous	Active ou désactive la visibilité et les sous-actions des onglets de l’inventaire.

lua

Config.UI.EnableTabs = {
    personal = {
        enable = true,
        clothes = true,
        enableActions = true,
        actions = {
            toggleHair = true,
            searchPlayer = true,
            carry = true,
            piggyback = true,
            rockstarEditor = true,
        }
    },
    settings = {
        enable = true,
        keybinds = true,
        appearance = true
    },
    vehicle = {
        enable = true,
    }
}

Animations

Config.Animations.Carry et Config.Animations.Piggyback définissent les dictionnaires et clips d’animation utilisés par les actions Porter et Porter sur le dos. Consulte config/player.lua pour la table complète.

Véhicules — `config/vehicles.lua`

Variable	Type	Par défaut	Description
`Config.OpenTrunkAnywhere`	`boolean`	`false`	Permet d’ouvrir le coffre quelle que soit la position du joueur autour de la voiture.
`Config.TrunkOpenDistance`	`number`	`3.0`	Distance maximale au coffre pour l’ouvrir (quand `OpenTrunkAnywhere = false`).
`Config.BackEngineVehicles`	`string[]`	voir fichier	Véhicules dont le moteur/coffre est à l’avant. La position du coffre est inversée automatiquement pour eux.
`Config.Trunks.vehicles`	`table`	voir ci-dessous	Capacité du coffre par véhicule. La clé `default` s’applique à tout véhicule sans configuration propre.
`Config.Gloveboxes.vehicles`	`table`	voir ci-dessous	Capacité de la boîte à gants par véhicule.

lua

Config.Trunks.vehicles = {
    default = {
        slots = 35,
        maxweight = 60000,
        label = 'Maletero',
    },
    [`speedo`] = {
        slots = 2,
        maxweight = 40000,
        label = 'Speedo Trunk',
        bone = 'door_dside_r',
    }
}
 
Config.Gloveboxes.vehicles = {
    default = {
        slots = 5,
        maxweight = 12500,
        label = 'Glovebox',
    },
    [`sultan`] = {
        slots = 5,
        maxweight = 12500,
        label = 'Sultan Glovebox',
    },
}

Utilise des accents graves (`) autour du nom du modèle du véhicule, pas des guillemets simples ou doubles. Le script calcule en interne le hash du nom de spawn.

Stashes — `config/stashes.lua`

lua

Config.Stashes = {
    default = {
        slots = 30,
        maxweight = 120000,
    },
    ['example'] = {
        label = 'ORIGEN TEST',
        slots = 8,
        marker = {
            type = 20,
            size = vector3(0.3, 0.3, 0.3),
            color = { r = 0, g = 0, b = 0, a = 255 },
        },
        locations = { vector3(-1319.3, -2493.41, 14.95) },
        -- job = 'police',
        -- job_gradeup = 0,
        -- job_gradedown = 2,
        -- gang = 'origen',
        -- gang_gradeup = 0,
        -- gang_gradedown = 3,
    },
}

Champ	Description
`slots`	Nombre de slots de ce stash.
`maxweight`	Poids total autorisé (valable uniquement sur `default`).
`label`	Libellé affiché.
`locations`	Array de `vector3`. Le stash est créé à chaque position.
`marker`	`type`, `size` et `color` facultatifs pour le marqueur dans le monde.
`job` / `job_gradeup` / `job_gradedown`	Restreint l’accès à une plage de grades de métier.
`gang` / `gang_gradeup` / `gang_gradedown`	Identique à ce qui précède, pour les gangs.

Boutiques — `config/shops.lua`

Le fichier des boutiques est divisé en trois parties :

Config.Shop — définit l’objet de paiement de chaque ID de boutique ('money' si MAI est activé, sinon un nom de compte).
Config.ShopItems — listes d’objets, réutilisables d’une boutique à l’autre.
Config.Shops — les emplacements réels des boutiques, avec marqueurs, blips et attribution des objets.

lua

Config.Shops = {
    ['weapons'] = {
        label = 'Shop',
        slots = 4,
        marker = {
            type = 20,
            size = vector3(0.3, 0.3, 0.3),
            color = { r = 0, g = 0, b = 0, a = 255 },
            distanceView = 5,
            distanceInteract = 1,
        },
        blip = {
            enabled = true,
            sprite = 52,
            color = 2,
            scale = 0.8,
            name = 'ORIGEN Shop Armas',
        },
        locations = { vector3(-1299.95, -2458.56, 13.94) },
        items = Config.ShopItems['weapons'],
    },
}

Chaque entrée d’objet dans Config.ShopItems accepte :

Champ	Type	Description
`name`	`string`	Nom de l’objet ou de l’arme.
`price`	`number`	Coût à l’unité.
`amount`	`number`	Stock affiché dans la boutique.
`metadata`	`table`	Métadonnées facultatives appliquées à l’objet acheté (p. ex. le numéro de série d’une arme).
`type`	`string`	`'item'` par défaut.

Les restrictions de métier et de gang (job, job_gradeup, job_gradedown, gang, gang_gradeup, gang_gradedown) fonctionnent comme pour les stashes.

World Points — `config/worldpoints.lua`

Le système de world points est le moteur qui affiche les sprites et marqueurs des stashes, boutiques, établis de craft et drops.

Variable	Type	Par défaut	Description
`Config.WorldPoints.Enabled`	`boolean`	`true`	Interrupteur général. Le désactiver supprime tous les world points.
`Config.WorldPoints.ForceGroundZ`	`boolean`	`true`	Force les points au niveau du sol lors de la copie des coordonnées.
`Config.WorldPoints.BlipsShortRange`	`boolean`	`true`	Les blips ne sont visibles qu’à proximité au lieu d’apparaître en permanence sur la minicarte.
`Config.WorldPoints.UseDropModel`	`boolean`	`true`	Fait apparaître un prop sur les sacs d’objets lâchés.
`Config.WorldPoints.DefaultDropModel`	`hash`	`prop_med_bag_01b`	Prop utilisé lorsque `UseDropModel = true`, c’est-à-dire le prop généré sur les sacs.
`Config.WorldPoints.MarkerColors`	`table`	voir fichier	Couleurs des marqueurs par type de point.
`Config.WorldPoints.DefaultMarkers`	`table`	voir fichier	Définitions de marqueurs par défaut pour `stash`, `shop` et `crafting`.
`Config.WorldPoints.PointTypes`	`table`	voir fichier	Sprite, marqueur, hooks et comportement par type de point.
`Config.WorldPoints.Initialization`	`table`	voir fichier	Délais de démarrage en millisecondes.
`Config.WorldPoints.Interaction.keys.interact`	`number`	`38` (E)	Touche d’interaction.
`Config.WorldPoints.Interaction.behavior.cooldownMs`	`number`	`100`	Délai entre deux interactions.
`Config.WorldPoints.Interaction.behavior.allowInteractionInVehicle`	`boolean`	`false`	Indique si les interactions sont autorisées dans un véhicule.
`Config.WorldPoints.Interaction.feedback.playSounds`	`boolean`	`true`	Active les sons d’interaction.
`Config.WorldPoints.VisualEffects.sprites.enableFloatingLight`	`boolean`	`true`	Ajoute une lumière flottante sous les sprites.
`Config.WorldPoints.Debug.enabled`	`boolean`	`Config.Debug`	Active les logs détaillés et les éléments visuels de débogage.
`Config.WorldPoints.Security.maxInteractionsPerSecond`	`number`	`1`	Limite de fréquence anti-spam.
`Config.WorldPoints.Security.checkPlayerState`	`boolean`	`true`	Désactive les interactions tant que le joueur est mort.

Armes — `config/weaponoptions.lua`

Variable	Type	Par défaut	Description
`Config.Weapons.InventoryWeaponSystem`	`boolean`	`true`	Active le système d’armes intégré (accessoires, synchronisation, réparation, rechargement, gilet). Ne le désactive que si tu utilises un système d’armes externe.
`Config.Weapons.DisableDecay`	`boolean`	`false`	Désactive l’usure de la durabilité des armes.
`Config.Weapons.RepairSystem.enabled`	`boolean`	`true`	Active les ateliers de réparation d’armes.
`Config.Weapons.RepairSystem.points`	`table`	voir fichier	Définitions des points de réparation : `location`, `restrictions` (métier/objets) et `time` en minutes.
`Config.Weapons.Draw.enabled`	`boolean`	`true`	Active le sous-système de dégainage des armes.
`Config.Weapons.Draw.variants`	`number[]`	`{ 130, 122, 3, 6, 8 }`	Variantes de composant affichées sur le holster.
`Config.Weapons.Draw.weapons`	`string[]`	voir fichier	Armes compatibles avec le dégainage depuis le holster.
`Config.Weapons.Draw.weapon_reload_animation.enable`	`boolean`	`true`	Joue une animation de rechargement. Désactive-le si tu veux que l’arme se recharge instantanément.
`Config.Weapons.Draw.weapon_reload_animation.progress`	`boolean`	`true`	Affiche une barre de progression pendant l’animation de rechargement.
`Config.Weapons.AmmoReloadTime`	`table`	voir fichier	Temps de rechargement par type de munition, en millisecondes.
`Config.Weapons.FastReload.enabled`	`boolean`	`true`	Active la touche de rechargement rapide.
`Config.Weapons.FastReload.key`	`string`	`"R"`	Touche de rechargement rapide.
`Config.Weapons.FastReload.NeedAmmoInHotbar`	`boolean`	`false`	Si `true`, exige des munitions dans les slots 1 à 6 pour le rechargement rapide.
`Config.Weapons.Throwables`	`table`	voir fichier	Liste blanche des armes de jet.
`Config.Weapons.Melee`	`table`	voir fichier	Liste blanche des armes de mêlée.
`Config.Weapons.AmmoTypes`	`table`	voir fichier	Associe les objets de munitions à des types de munitions et à une taille de chargeur.
`Config.DurabilityMultiplier`	`table`	voir fichier	Multiplicateur de durabilité par arme (plus bas = s’use plus lentement).
`Config.DurabilityBlockedWeapons`	`string[]`	voir fichier	Armes exemptées de durabilité.
`Config.WeaponTints`	`table`	voir fichier	Correspondance nom d’objet → ID de teinte.
`Config.Armors`	`table`	`armor = 50, heavyarmor = 100`	Quantité d’armure par objet d’armure.
`Config.MaximumAmmoValues`	`table`	`weapon_pistol = 10`	Plafond d’affichage uniquement dans la NUI.
`Config.WeaponAttachments`	`table`	voir fichier	Objets d’accessoire associés aux hashes de composant par arme.
`Config.Weapons.list`	`string[]`	voir fichier	Registre principal des armes.

Craft — `config/crafting.lua`

Variable	Type	Par défaut	Description
`Config.Crafting.enable`	`boolean`	`true`	Active le système de craft.
`Config.Crafting.items`	`table`	voir fichier	Recettes. Chaque entrée définit `ingredients`, un `resultItem` facultatif, `resultCount` et `time` en millisecondes.
`Config.Crafting.zones`	`table`	voir fichier	Zones de craft avec `enable`, `locations`, `radius`, `label` et la liste des `items` disponibles.

lua

["tosti"] = {
    ingredients = {
        ["sandwich"]     = 2,
        ["water_bottle"] = 1,
        ["weapon_pistol"] = 1,
    },
    resultCount = 1,
    time = 5000,
}

Airdrops — `config/airdrops.lua`

Le système d’airdrops est marqué comme WIP dans le code source. Utilise-le d’abord sur des environnements de test.

Variable	Type	Par défaut	Description
`Config.Airdrop.CrateModel`	`string`	`"prop_box_wood02a_pu"`	Modèle du prop de la caisse.
`Config.Airdrop.ParachuteModel`	`string`	`"prop_v_parachute"`	Modèle du prop du parachute.
`Config.Airdrop.DropHeight`	`number`	`100.0`	Hauteur de largage en mètres au-dessus du sol.
`Config.Airdrop.LandingTime`	`number`	`10000`	Durée d’atterrissage en millisecondes (`0` = placement instantané au sol).
`Config.Airdrop.StashSlots`	`number`	`20`	Nombre maximal de slots dans le stash de l’airdrop.
`Config.Airdrop.Smoke.enable`	`boolean`	`true`	Active la fumée à l’atterrissage.
`Config.Airdrop.Smoke.particle`	`table`	`dict = "scr_ar_planes", name = "scr_ar_trail_smoke"`	Dictionnaire et nom de la particule.
`Config.Airdrop.Smoke.scale`	`number`	`0.8`	Échelle de la particule.
`Config.Airdrop.Smoke.color`	`table`	`{ r = 170, g = 30, b = 80 }`	Couleur de la particule (limitée par la prise en charge de la particule).

Drift — `config/drift.lua`

Variable	Type	Par défaut	Description
`Config.EnableDriftMode`	`boolean`	`false`	Active la bascule du mode drift (`exports.origen_inventory:ToggleDriftMode(true)`).
`Config.DriftHandling.InitialDragCoeff`	`number`	`90.22`	Traînée aérodynamique pendant le drift.
`Config.DriftHandling.DriveInertia`	`number`	`0.31`	Inertie de transmission. Plus élevé = accélération plus lente.
`Config.DriftHandling.SteeringLock`	`number`	`22`	Angle de braquage maximal.
`Config.DriftHandling.TractionCurveMax`	`number`	`-1.1`	Adhérence maximale en virage. Les valeurs négatives sont voulues.
`Config.DriftHandling.TractionCurveMin`	`number`	`-0.4`	Adhérence minimale en virage.
`Config.DriftHandling.TractionCurveLateral`	`number`	`2.5`	Adhérence latérale dans les virages.
`Config.DriftHandling.LowSpeedTractionLossMult`	`number`	`-0.57`	Multiplicateur de perte d’adhérence à basse vitesse.

Animations de fouille — `config/search.lua`

Config.SearchAnims est une liste de paires d’animations (dict, anim) utilisées au hasard quand un joueur est fouillé. Modifie le fichier pour ajouter ou retirer des animations.

Webhooks — `config_sv.lua`

URLs de webhooks Discord réservées au serveur. Remplace chaque valeur WEBHOOK_URL_HERE par ton URL réelle ou laisse l’espace réservé pour désactiver ce canal.

lua

Config.Webhook = {
    default  = "WEBHOOK_URL_HERE",
    giveItem = "WEBHOOK_URL_HERE",
    search   = "WEBHOOK_URL_HERE",
    stash    = "WEBHOOK_URL_HERE",
    trunks   = "WEBHOOK_URL_HERE",
    glovebox = "WEBHOOK_URL_HERE",
    drops    = "WEBHOOK_URL_HERE",
    money    = "WEBHOOK_URL_HERE",
}

Drawables de vêtements — `config/clothes.lua`

Définit Config.Clothings.Standalone, Config.Clothings.DefaultHairy, Config.Clothings.Variations, Config.Clothings.Drawables et Config.Clothings.Props. Ces tables pilotent les changements de composants vestimentaires utilisés par l’onglet vêtements de l’inventaire.

Ce fichier est volumineux car il liste toutes les variations de composants par genre. Tu ne le modifies généralement que pour ajouter des variations personnalisées via AddNewVariation(category, gender, source, target, single).

Configuration · origen_inventory

Général — config.lua

Réglages des drops

Couleurs des marqueurs

Flags expérimentaux

Joueur — config/player.lua

Protection anti-triche

Clothes-As-Item (CAI)

Money-As-Item (MAI)

Interface

Animations

Véhicules — config/vehicles.lua

Stashes — config/stashes.lua

Boutiques — config/shops.lua

World Points — config/worldpoints.lua

Armes — config/weaponoptions.lua

Craft — config/crafting.lua

Airdrops — config/airdrops.lua

Drift — config/drift.lua

Animations de fouille — config/search.lua

Webhooks — config_sv.lua

Drawables de vêtements — config/clothes.lua

Général — `config.lua`

Joueur — `config/player.lua`

Véhicules — `config/vehicles.lua`

Stashes — `config/stashes.lua`

Boutiques — `config/shops.lua`

World Points — `config/worldpoints.lua`

Armes — `config/weaponoptions.lua`

Craft — `config/crafting.lua`

Airdrops — `config/airdrops.lua`

Drift — `config/drift.lua`

Animations de fouille — `config/search.lua`

Webhooks — `config_sv.lua`

Drawables de vêtements — `config/clothes.lua`