> ## 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.

# Verkauf ändern oder blockieren

> Lege den Preis eines Drogenverkaufs mit deinem eigenen Script fest oder brich ihn ab, bevor der Spieler bezahlt wird.

Jedes Mal, wenn Drogen verkauft werden, fragt Drugs Creator zuerst deinen Code, direkt bevor der Spieler bezahlt wird. Dein Code kann den Preis behalten, einen neuen festlegen oder den Verkauf abbrechen. Das funktioniert für jede Verkaufsmethode: NPC, Corner, Narcos, Pusher, Flugzeug, Boot und angeheuerte Dealer.

Hier bindest du deine eigene Wirtschaft an: Preise, die sich nach Gebiet, Angebot und Nachfrage, Gang-Aktivität oder Polizei im Dienst richten.

Es gibt zwei Wege. Nimm den, der dir lieber ist, oder beide.

## Der einfache Weg: sv\_integrations.lua

Unten in `integrations/sv_integrations.lua` steht ein auskommentiertes Beispiel. Hol die Funktion `BeforeDrugSale` aus dem Kommentar heraus und passe sie an:

```lua Function theme={null}
function BeforeDrugSale(sale)
    if sale.isHotZone then
        return sale.price * 2 -- doppelter Preis in Hot Zones
    end
end
```

Wenn du von einer älteren Version aktualisiert und deine eigene `sv_integrations.lua` behalten hast, füge die Funktion einfach unten in die Datei ein. Ohne sie funktionieren Verkäufe wie bisher.

## Aus deiner eigenen Resource

Wenn deine Wirtschaft in einer eigenen Resource läuft, registriere dort einen Hook:

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

Der zweite Parameter ist optional: Er beschränkt den Hook auf bestimmte Verkaufsmethoden und Drogen. Ohne ihn läuft der Hook bei jedem Verkauf.

`exports.drugs_creator:removeSaleHook(hookId)` entfernt ihn. Wenn deine Resource stoppt, werden ihre Hooks automatisch entfernt.

> [!NOTE]
>
> Starte deine Resource **nach** `drugs_creator`. Wenn du Drugs Creator neu startest, vergisst es die Hooks: Registriere sie beim Start erneut.
>
> ```lua theme={null}
> AddEventHandler("onResourceStart", function(resourceName)
>     if resourceName == "drugs_creator" then
>         -- registriere deinen Hook hier erneut
>     end
> end)
> ```

## Was du zurückgibst

| Du gibst zurück | Was passiert |
| - | - |
| nichts, oder `true` | Der Preis bleibt, wie er ist |
| eine Zahl, z. B. `500` | Das ist der neue Gesamtpreis des Verkaufs |
| `false` | Der Verkauf wird abgebrochen, der Spieler sieht die Standardmeldung |
| `{ cancel = true, message = "Markt geschlossen" }` | Der Verkauf wird abgebrochen, der Spieler sieht deine Nachricht |
| `{ price = 500 }` | Wie `500` zurückgeben |

Bei einem abgebrochenen Verkauf behält der Spieler die Drogen und bekommt kein Geld. Wenn du den Preis änderst, verwenden die Benachrichtigung, das Discord-Log, die Dashboard-Statistiken und die [Verkaufs-Events](https://docs.jaksam-scripts.com/de/drugs-creator/server/sellings) deinen Preis.

Wenn mehrere Hooks registriert sind, laufen sie nacheinander: Jeder bekommt den Preis, den der vorherige übrig gelassen hat.

## Der Verkauf

Deine Funktion bekommt eine Tabelle, `sale`, mit allem zum Verkauf:

| Name | Datentyp | Beschreibung |
| - | - | - |
| `method` | string | `npc`, `corner`, `narcos`, `pushers`, `plane`, `boat` oder `hired_dealer` |
| `drug` | string | Item-ID der Droge |
| `label` | string | Item-Label der Droge |
| `quantity` | integer | Verkaufte Menge |
| `price` | integer | Gesamtpreis, den der Spieler bekäme, inklusive Abzug bei wenig Polizei |
| `basePrice` | integer | Gesamtpreis vor dem Abzug bei wenig Polizei |
| `unitPrice` | integer | `price` geteilt durch `quantity` |
| `rewardObject` | table | Konto oder Item, mit dem der Spieler bezahlt wird |
| `playerId` | integer | Server-ID des verkaufenden Spielers (bei angeheuerten Dealern: der Besitzer, nur wenn online) |
| `identifier` | string | Charakter-Identifier des Spielers (bei angeheuerten Dealern: der Besitzer) |
| `job` | string | Job des Spielers (bei angeheuerten Dealern: der Job des Besitzers) |
| `gang` | string | Gang des Spielers, falls dein Gang-Modul eine hat |
| `coords` | vector3 | Wo der Spieler ist |
| `territory` | string | Name des Gebiets, in dem verkauft wird, `nil` außerhalb von Gebieten |
| `territoryOwner` | string | Wem das Gebiet gehört |
| `isHotZone` | boolean | `true`, wenn das Gebiet eine Hot Zone ist |
| `preview` | boolean | `true`, wenn das Narcos-Menü nur den Preis anzeigt, siehe unten |
| `pedNetId` | integer | Netzwerk-ID des Käufers (nur NPC und Corner) |
| `pusherId` | string | ID des Pushers (nur Pusher) |
| `dealer` | table | `id`, `name` und `type` des angeheuerten Dealers (nur angeheuerte Dealer) |

## Beispiel

```lua theme={null}
-- Hypothetisches Markt-Script: Preis aus deinem eigenen Markt, nachts geschlossen
function BeforeDrugSale(sale)
    local hour = os.date("*t").hour
    if hour >= 2 and hour < 6 then
        return { cancel = true, message = "Gerade kauft niemand, komm später wieder" }
    end

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

> [!WARNING]
>
> **Gib sofort etwas zurück.** Verwende im Hook kein `Wait` und kein `MySQL.await`: Ein Hook, der wartet, bricht den Verkauf ab, und die Server-Konsole meldet es. Halte deine Preise im Speicher und lies sie von dort.

> [!NOTE]
>
> * Wenn dein Hook einen Fehler wirft oder etwas zurückgibt, das kein Preis ist, läuft der Verkauf zum bisherigen Preis weiter, und die Konsole zeigt eine Warnung
> * **Narcos:** Wenn ein Spieler das Narcos-Menü öffnet, wird dein Hook mit `preview = true` aufgerufen, damit das Menü deinen Preis zeigt. Beim echten Verkauf wird er erneut mit `preview = false` aufgerufen: Ändere deinen Bestand oder dein Angebot nur dann
> * Flugzeug und Boot rufen den Hook einmal pro Droge auf: Du kannst eine Droge abbrechen und die anderen verkaufen lassen
> * Ein abgebrochener Verkauf eines angeheuerten Dealers lässt die Drogen im Bestand des Dealers


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