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

# Cambiar o bloquear una venta

> Fija el precio de una venta de droga desde tu propio script, o cancélala, antes de que el jugador cobre.

Cada vez que se venden drogas, Drugs Creator pregunta primero a tu código, justo antes de que el jugador cobre. Tu código puede mantener el precio, poner uno nuevo o cancelar la venta. Funciona con todos los métodos de venta: NPC, corner, narcos, pushers, avión, barco y dealers contratados.

Es el lugar para conectar tu propia economía: precios que cambian según la zona, la oferta y la demanda, la actividad de las bandas o la policía de servicio.

Hay dos formas. Elige la que prefieras, o usa las dos.

## La forma fácil: sv\_integrations.lua

Al final de `integrations/sv_integrations.lua` hay un ejemplo comentado. Saca la función `BeforeDrugSale` del comentario y edítala:

```lua Function theme={null}
function BeforeDrugSale(sale)
    if sale.isHotZone then
        return sale.price * 2 -- precio doble en las hot zones
    end
end
```

Si actualizaste desde una versión anterior y conservaste tu propio `sv_integrations.lua`, pega la función al final del archivo. Sin ella, las ventas funcionan como antes.

## Desde tu propio resource

Si tu economía está en su propio resource, registra un hook desde allí:

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

El segundo parámetro es opcional: limita el hook a algunos métodos de venta y algunas drogas. Sin él, el hook se ejecuta en todas las ventas.

`exports.drugs_creator:removeSaleHook(hookId)` lo elimina. Cuando tu resource se detiene, sus hooks se eliminan solos.

> [!NOTE]
>
> Inicia tu resource **después** de `drugs_creator`. Si reinicias Drugs Creator, olvida los hooks: regístralos de nuevo cuando arranque.
>
> ```lua theme={null}
> AddEventHandler("onResourceStart", function(resourceName)
>     if resourceName == "drugs_creator" then
>         -- registra tu hook de nuevo aquí
>     end
> end)
> ```

## Qué devuelves

| Devuelves | Qué pasa |
| - | - |
| nada, o `true` | El precio se queda como está |
| un número, como `500` | Ese es el nuevo precio total de la venta |
| `false` | La venta se cancela, el jugador ve el mensaje por defecto |
| `{ cancel = true, message = "Mercado cerrado" }` | La venta se cancela, el jugador ve tu mensaje |
| `{ price = 500 }` | Igual que devolver `500` |

Cuando una venta se cancela, el jugador conserva las drogas y no recibe dinero. Cuando cambias el precio, la notificación, el log de Discord, las estadísticas del dashboard y los [eventos de venta](https://docs.jaksam-scripts.com/es/drugs-creator/server/sellings) usan tu precio.

Si hay varios hooks registrados, se ejecutan uno tras otro: cada uno recibe el precio que dejó el anterior.

## La venta

Tu función recibe una tabla, `sale`, con todo sobre la venta:

| Nombre | Tipo de dato | Descripción |
| - | - | - |
| `method` | string | `npc`, `corner`, `narcos`, `pushers`, `plane`, `boat` o `hired_dealer` |
| `drug` | string | ID del item de la droga |
| `label` | string | Nombre del item de la droga |
| `quantity` | integer | Cantidad vendida |
| `price` | integer | Precio total que recibiría el jugador, con la reducción por poca policía |
| `basePrice` | integer | Precio total antes de la reducción por poca policía |
| `unitPrice` | integer | `price` dividido por `quantity` |
| `rewardObject` | table | Cuenta o item con el que se paga al jugador |
| `playerId` | integer | Server ID del jugador que vende (con dealers contratados: el dueño, solo si está conectado) |
| `identifier` | string | Identificador del personaje (con dealers contratados: el dueño) |
| `job` | string | Trabajo del jugador (con dealers contratados: el trabajo del dueño) |
| `gang` | string | Banda del jugador, si tu módulo de bandas tiene una |
| `coords` | vector3 | Dónde está el jugador |
| `territory` | string | Nombre del territorio donde ocurre la venta, `nil` fuera de territorios |
| `territoryOwner` | string | Quién controla ese territorio |
| `isHotZone` | boolean | `true` cuando el territorio es una hot zone |
| `preview` | boolean | `true` cuando el menú de narcos solo muestra el precio, ver abajo |
| `pedNetId` | integer | Network ID del comprador (solo NPC y corner) |
| `pusherId` | string | ID del pusher (solo pushers) |
| `dealer` | table | `id`, `name` y `type` del dealer contratado (solo dealers contratados) |

## Ejemplo

```lua theme={null}
-- Script de mercado hipotético: precio de tu propio mercado, cerrado de noche
function BeforeDrugSale(sale)
    local hour = os.date("*t").hour
    if hour >= 2 and hour < 6 then
        return { cancel = true, message = "Ahora nadie compra, vuelve más tarde" }
    end

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

> [!WARNING]
>
> **Devuelve al momento.** No uses `Wait` ni `MySQL.await` dentro del hook: un hook que espera cancela la venta, y la consola del servidor lo avisa. Guarda tus precios en memoria y léelos de ahí.

> [!NOTE]
>
> * Si tu hook lanza un error o devuelve algo que no es un precio, la venta sigue con el precio que tenía y la consola muestra un aviso
> * **Narcos:** cuando un jugador abre el menú de narcos, tu hook se llama con `preview = true` para que el menú muestre tu precio. Se llama otra vez con `preview = false` cuando la venta ocurre de verdad: cambia tu stock u oferta solo entonces
> * El avión y el barco llaman al hook una vez por cada droga: puedes cancelar una droga y dejar que las demás se vendan
> * Una venta cancelada de un dealer contratado deja las drogas en el stock del dealer


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