QBESXStandalone
Agency-Shops Exports & API
Cada 24/7, LTD, Rob's Liquor, ferretería, Ammu-Nation y gasolinera del mapa en un solo script para FiveM.
v1.0.0De pago5 PáginasDesde October 19, 2026, 20:00 CEST
01Exports de cliente
| Export | Descripción |
|---|---|
GetFuel(vehicle) | El nivel de combustible de un vehículo de 0 a 100, de la misma forma que lo devuelve LegacyFuel. |
SetFuel(vehicle, level) | Establece el nivel de combustible de un vehículo, de 0 a 100. |
02Exports de servidor
| Export | Descripción |
|---|---|
GetOwner(id) | El identificador y el nombre del dueño de una tienda o gasolinera, o nil si nadie la posee. |
AddStock(id, item, amount) | Añade unidades al stock de una tienda en propiedad, hasta Config.Ownership.MaxStock. Devuelve true si tuvo éxito. |
AddFuelStock(id, litres) | Añade litros al depósito de una gasolinera en propiedad, hasta Config.GasStations.MaxFuel. Devuelve true si tuvo éxito. |
GetBalance(id) | El dinero en la caja de una tienda o gasolinera en propiedad, o nil. |
03Eventos
| Nombre | Lado | Descripción |
|---|---|---|
agency-shop:server:purchased | Servidor | Se dispara con (source, storeId, items, total, account) tras completarse una compra. items lista lo entregado y total es lo pagado, para que un script de estadísticas o misiones no tenga que hacer consultas constantes. |
agency-shop:server:shoplift | Servidor | Se dispara con (source, storeId, value, coords) cuando un jugador sale de una tienda con artículos sin pagar en la cesta o carrito. Con Config.Dispatch.System = 'event' esta es la única alerta, para que tu propio script de avisos pueda capturarla. |
+Conviene saber
Agency-Shops ofrece varios exports y dos eventos de servidor para que tus propios scripts de combustible, suministros, dispatch y estadísticas interactúen con las tiendas.
- Nivel de combustible
- GetFuel y SetFuel en el cliente funcionan igual que las llamadas de LegacyFuel, con un nivel de 0 a 100. Los scripts creados para LegacyFuel solo necesitan cambiar el nombre del recurso.
- Propietarios y stock
- GetOwner y GetBalance leen una tienda o gasolinera en propiedad según su id. AddStock y AddFuelStock añaden unidades o litros, por ejemplo desde tu propio script de suministros o trabajos.
- Eventos
- agency-shop:server:purchased se activa tras cada compra con el jugador, la tienda, los objetos, el total y la cuenta. agency-shop:server:shoplift se activa cuando un jugador sale de la tienda con productos sin pagar.
?Preguntas frecuentes
¿Cómo obtengo el propietario de una tienda?
En el servidor ejecuta exports['Agency-Shops']:GetOwner(id). Devuelve el identificador y el nombre del propietario, o nil si la tienda no tiene dueño.
¿Cómo envío mi propia alerta policial por hurto?
Establece Config.Dispatch.System = 'event' y escucha agency-shop:server:shoplift. Devuelve el jugador, el id de la tienda, el valor de los artículos y las coordenadas.