> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jaksam-scripts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modifier ou bloquer une vente

> Fixe le prix d'une vente de drogue depuis ton propre script, ou annule-la, avant que le joueur soit payé.

À chaque vente de drogue, Drugs Creator interroge d'abord ton code, juste avant que le joueur soit payé. Ton code peut garder le prix, en fixer un nouveau ou annuler la vente. Ça marche pour toutes les méthodes de vente : NPC, corner, narcos, pushers, avion, bateau et dealers engagés.

C'est l'endroit pour brancher ta propre économie : des prix qui changent selon la zone, l'offre et la demande, l'activité des gangs ou la police en service.

Il y a deux façons de faire. Choisis celle que tu préfères, ou utilise les deux.

## La façon simple : sv\_integrations.lua

En bas de `integrations/sv_integrations.lua` se trouve un exemple en commentaire. Sors la fonction `BeforeDrugSale` du commentaire et modifie-la :

```lua Function theme={null}
function BeforeDrugSale(sale)
    if sale.isHotZone then
        return sale.price * 2 -- prix doublé dans les hot zones
    end
end
```

Si tu as mis à jour depuis une ancienne version en gardant ton propre `sv_integrations.lua`, colle simplement la fonction en bas du fichier. Sans elle, les ventes fonctionnent comme avant.

## Depuis ta propre resource

Si ton économie tourne dans sa propre resource, enregistre un hook depuis celle-ci :

```lua Export theme={null}
local hookId = exports.drugs_creator:registerSaleHook(function(sale)
    return sale.price + 100
end, { methods = { "npc", "corner" }, drugs = { "weed" } })
```

Le second paramètre est facultatif : il limite le hook à certaines méthodes de vente et certaines drogues. Sans lui, le hook s'exécute à chaque vente.

`exports.drugs_creator:removeSaleHook(hookId)` le supprime. Quand ta resource s'arrête, ses hooks sont supprimés automatiquement.

> [!NOTE]
>
> Démarre ta resource **après** `drugs_creator`. Si tu redémarres Drugs Creator, il oublie les hooks : enregistre-les à nouveau quand il démarre.
>
> ```lua theme={null}
> AddEventHandler("onResourceStart", function(resourceName)
>     if resourceName == "drugs_creator" then
>         -- enregistre ton hook à nouveau ici
>     end
> end)
> ```

## Ce que tu renvoies

| Tu renvoies | Ce qui se passe |
| - | - |
| rien, ou `true` | Le prix reste tel quel |
| un nombre, comme `500` | C'est le nouveau prix total de la vente |
| `false` | La vente est annulée, le joueur voit le message par défaut |
| `{ cancel = true, message = "Marché fermé" }` | La vente est annulée, le joueur voit ton message |
| `{ price = 500 }` | Comme renvoyer `500` |

Quand une vente est annulée, le joueur garde la drogue et ne reçoit pas d'argent. Quand tu changes le prix, la notification, le log Discord, les statistiques du dashboard et les [events de vente](https://docs.jaksam-scripts.com/fr/drugs-creator/server/sellings) utilisent ton prix.

Si plusieurs hooks sont enregistrés, ils s'exécutent l'un après l'autre : chacun reçoit le prix laissé par le précédent.

## La vente

Ta fonction reçoit une table, `sale`, avec tout ce qui concerne la vente :

| Nom | Type de donnée | Description |
| - | - | - |
| `method` | string | `npc`, `corner`, `narcos`, `pushers`, `plane`, `boat` ou `hired_dealer` |
| `drug` | string | ID de l'item de la drogue |
| `label` | string | Nom de l'item de la drogue |
| `quantity` | integer | Quantité vendue |
| `price` | integer | Prix total que le joueur recevrait, réduction faible police comprise |
| `basePrice` | integer | Prix total avant la réduction faible police |
| `unitPrice` | integer | `price` divisé par `quantity` |
| `rewardObject` | table | Compte ou item avec lequel le joueur est payé |
| `playerId` | integer | Server ID du joueur qui vend (pour les dealers engagés : le propriétaire, seulement s'il est en ligne) |
| `identifier` | string | Identifiant du personnage (pour les dealers engagés : le propriétaire) |
| `job` | string | Job du joueur (pour les dealers engagés : le job du propriétaire) |
| `gang` | string | Gang du joueur, si ton module de gangs en a un |
| `coords` | vector3 | Où se trouve le joueur |
| `territory` | string | Nom du territoire où a lieu la vente, `nil` hors des territoires |
| `territoryOwner` | string | Qui possède ce territoire |
| `isHotZone` | boolean | `true` quand le territoire est une hot zone |
| `preview` | boolean | `true` quand le menu des narcos affiche seulement le prix, voir plus bas |
| `pedNetId` | integer | Network ID de l'acheteur (NPC et corner seulement) |
| `pusherId` | string | ID du pusher (pushers seulement) |
| `dealer` | table | `id`, `name` et `type` du dealer engagé (dealers engagés seulement) |

## Exemple

```lua theme={null}
-- Script de marché hypothétique : prix de ton propre marché, fermé la nuit
function BeforeDrugSale(sale)
    local hour = os.date("*t").hour
    if hour >= 2 and hour < 6 then
        return { cancel = true, message = "Personne n'achète en ce moment, reviens plus tard" }
    end

    local marketPrice = exports["my_market"]:getCachedPrice(sale.drug, sale.territory)
    if marketPrice then
        return marketPrice * sale.quantity
    end
end
```

> [!WARNING]
>
> **Renvoie tout de suite.** N'utilise pas `Wait` ni `MySQL.await` dans le hook : un hook qui attend annule la vente, et la console du serveur le signale. Garde tes prix en mémoire et lis-les depuis là.

> [!NOTE]
>
> * Si ton hook lance une erreur ou renvoie autre chose qu'un prix, la vente continue au prix qu'elle avait et la console affiche un avertissement
> * **Narcos :** quand un joueur ouvre le menu des narcos, ton hook est appelé avec `preview = true` pour que le menu affiche ton prix. Il est rappelé avec `preview = false` quand la vente a vraiment lieu : modifie ton stock ou ton offre seulement à ce moment-là
> * L'avion et le bateau appellent le hook une fois par drogue : tu peux annuler une drogue et laisser les autres se vendre
> * Une vente annulée d'un dealer engagé laisse la drogue dans le stock du dealer


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.