QBESXStandalone

Agency-Blackmarket V2 Exports & API

Um mercado negro vivo para FiveM em QBCore, Qbox, ESX ou totalmente standalone.

v2.0.0Pago6 Páginas

01Exports do cliente

Export	Descrição
`OpenMenu()`	Abre o menu do /ablackmarket, por exemplo a partir de um menu radial ou de uma aplicação de telemóvel. Aplicam-se as mesmas verificações que no comando.
`CloseMenu()`	Fecha o menu e devolve o mouse para o jogo.
`IsMenuOpen()`	Devolve true enquanto o menu do mercado negro estiver aberto, junto de um dealer ou em qualquer sítio.

02Exports do servidor

Export	Descrição
`GetReputation(source)`	Os pontos de reputação de um jogador, 0 para quem ainda não tem nenhum.
`SetReputation(source, value)`	Define a reputação de um jogador para um valor fixo, nunca abaixo de 0. Devolve true em caso de sucesso.
`AddReputation(source, amount)`	Adiciona reputação, ou retira-a com um valor negativo. Um novo nível é anunciado ao jogador e à aplicação Companion. Devolve true em caso de sucesso.
`GetLevel(source)`	Devolve dois valores: o número do nível do jogador (de 1 a 5 por predefinição) e o nome dele.
`AddCredit(source, amount)`	Adiciona crédito de dealer, que o jogador pode usar na próxima compra ou encomenda. Devolve true em caso de sucesso.
`RelocateDealer(dealerId)`	Muda de imediato um dealer para outro dos seus locais. Devolve true se ele mudou.
`SendDealerAway(dealerId, minutes)`	O dealer desaparece durante os minutos indicados e depois aparece noutro dos seus locais, como após uma visita da polícia.
`IsDealerPresent(dealerId)`	True enquanto o dealer estiver num dos seus locais e não tiver saído.
`StartFlashSale(minutes)`	Inicia uma promoção relâmpago com itens ao acaso com desconto. Sem minutos, usa-se o tempo de Config.FlashSale.

03Eventos

Nome	Lado	Descrição
`agency-blackmarket:deal`	Servidor	Dispara no servidor com (source, kind, data) após cada negócio. kind é buy, sell, launder, order, pickup ou job, e data contém os detalhes do negócio, como o dealer, os itens e o total.
`agency-blackmarket:dealerMoved`	Servidor	Dispara no servidor com (dealerId, pos, reason) quando um dealer muda de local. reason é rotate, return, admin ou export.
`agency-blackmarket:flashSale`	Servidor	Dispara no servidor com (items, minutes) quando começa uma promoção relâmpago. items associa cada item em promoção ao seu desconto em percentagem.

+Bom saber

O Agency-Blackmarket V2 oferece exports e eventos para que os teus próprios scripts possam dar reputação e crédito, controlar os dealers e reagir aos negócios.

Reputação e crédito: GetReputation, SetReputation, AddReputation e GetLevel leem e alteram a posição de um jogador, e AddCredit paga crédito de dealer. Recebem o id de servidor de um jogador online.
Dealers e promoções relâmpago: RelocateDealer, SendDealerAway e IsDealerPresent controlam os dealers com o id de Config.Dealers, e StartFlashSale inicia uma promoção a partir do teu próprio evento.
Eventos: agency-blackmarket:deal dispara após cada negócio, agency-blackmarket:dealerMoved após cada mudança e agency-blackmarket:flashSale quando começa uma promoção. Os três disparam só no servidor e servem para logs, ferramentas da polícia ou os teus próprios trabalhos.

?Perguntas frequentes

Como abro o menu a partir do meu menu radial?

Chama exports['Agency-Blackmarket']:OpenMenu() no cliente. Aplicam-se as mesmas verificações que no comando, incluindo um item de Config.Menu.item.