Fonctions et variables importantes

Cette section détaille les principales fonctions et variables utilisées ou exposées par le script.
Comprendre ces éléments vous aidera à personnaliser ou à intégrer le script à d’autres ressources.

Fonctions modifiables (client)

Ces fonctions se situent dans le fichier : /client/opensource.lua. Vous pouvez les modifier librement pour adapter le script à votre serveur.

Afficher une notification

function OS_Notify(msg, kind)
    -- msg  : texte traduit
    -- kind : 'info' | 'success' | 'error'
end

Remplacez le contenu de cette fonction pour utiliser votre propre système de notification.

Jouer un son d’interface

function OS_PlaySound(name)
    -- name : 'Place' ou 'Detonate' (voir Config.Sounds)
end

Afficher la touche d’une commande

function OS_KeyLabel(command)
    -- Retourne l'icône de la touche associée à une commande (ex. dans les notifications)
end

Exports serveur

Ces exports permettent d’intégrer le script à n’importe quel inventaire ou système de boutique.

Ajouter des bombes au stock d’un joueur

exports['intense_smoke_grenade']:AddBombs(source, amount)

Connaître le stock d’un joueur

local count = exports['intense_smoke_grenade']:GetBombs(source)

Lancer la pose d’une bombe

exports['intense_smoke_grenade']:StartPlacing(source)

Utile pour un inventaire autre qu’ox_inventory : appelez cet export lorsque le joueur utilise l’item. Pensez à passer Config.Inventory.enabled à false et Config.Stock.enabled à true ou false selon votre logique de retrait d’item.

Callback ox_inventory

Le script expose automatiquement un export portant le nom de l’item (Config.Inventory.item), utilisé par ox_inventory :

server = { export = 'intense_smoke_grenade.intense_smoke_grenade' }

L’item n’est retiré de l’inventaire que si la pose est validée par le serveur.

Bonnes pratiques

• Utilisez les variables locales (local) pour limiter la portée à la fonction ou au script concerné.
• Vous pouvez modifier uniquement les fichiers client/opensource.lua, shared/config.lua et les fichiers de locales/ : les autres fichiers peuvent être écrasés lors d’une mise à jour.