QBESXStandalone

Agency-Shops Exports & API

Cada 24/7, LTD, Rob's Liquor, loja de ferragens, Ammu-Nation e posto de combustível no mapa em um único script.

v1.0.0Pago5 PáginasA partir de October 19, 2026, 20:00 CEST

01Exports do cliente

Export	Descrição
`GetFuel(vehicle)`	O nível de combustível de um veículo de 0 a 100, da mesma forma que o LegacyFuel retorna.
`SetFuel(vehicle, level)`	Define o nível de combustível de um veículo, de 0 a 100.

02Exports do servidor

Export	Descrição
`GetOwner(id)`	O identificador e o nome do proprietário de uma loja ou posto de combustível, ou nil quando ninguém é dono.
`AddStock(id, item, amount)`	Adiciona unidades ao estoque de uma loja comprada, até Config.Ownership.MaxStock. Retorna true quando concluído com sucesso.
`AddFuelStock(id, litres)`	Adiciona litros ao tanque de um posto de combustível comprado, até Config.GasStations.MaxFuel. Retorna true quando concluído com sucesso.
`GetBalance(id)`	O dinheiro no caixa de uma loja ou posto de combustível comprado, ou nil.

03Eventos

Nome	Lado	Descrição
`agency-shop:server:purchased`	Servidor	Dispara com (source, storeId, items, total, account) após a conclusão de uma compra. items lista o que foi entregue e total é o valor pago, para que um script de estatísticas ou missões não precise fazer polling.
`agency-shop:server:shoplift`	Servidor	Dispara com (source, storeId, value, coords) quando um jogador sai de uma loja com itens não pagos na cesta ou carrinho. Com Config.Dispatch.System = 'event' este é o único alerta, para que seu próprio script de dispatch possa capturá-lo.

+Bom saber

Agency-Shops oferece alguns exports e dois eventos de servidor, para que os seus próprios scripts de combustível, fornecimento, dispatch e estatísticas possam funcionar com as lojas.

Nível de Combustível: GetFuel e SetFuel no client funcionam como as chamadas do LegacyFuel, com um nível de 0 a 100. Scripts feitos para o LegacyFuel só precisam da alteração do nome do resource.
Proprietários e Stock: GetOwner e GetBalance leem uma loja ou posto de combustível com proprietário pelo respetivo id. AddStock e AddFuelStock adicionam unidades ou litros, por exemplo a partir do seu próprio script de fornecimento ou de trabalho.
Eventos: agency-shop:server:purchased é acionado após cada compra com o jogador, a loja, os itens, o total e a conta. agency-shop:server:shoplift é acionado quando um jogador sai com artigos não pagos.

?Perguntas frequentes

Como leio o proprietário de uma loja?

No server, chame exports['Agency-Shops']:GetOwner(id). Devolve o identifier e o nome do proprietário, ou nil quando a loja não tem proprietário.

Como envio o meu próprio alerta policial para furtos?

Defina Config.Dispatch.System = 'event' e escute agency-shop:server:shoplift. Fornece o jogador, o id da loja, o valor dos artigos e as coordenadas.