QBESXStandalone

Agency-Blackmarket V2 Exports & API

Un mercado negro vivo para FiveM en QBCore, Qbox, ESX o totalmente standalone.

v2.0.0De pago6 Páginas

01Exports de cliente

Export	Descripción
`OpenMenu()`	Abre el menú de /ablackmarket, por ejemplo desde un menú radial o una app de móvil. Se aplican las mismas comprobaciones que con el comando.
`CloseMenu()`	Cierra el menú y devuelve el ratón al juego.
`IsMenuOpen()`	Devuelve true mientras el menú del mercado negro está abierto, en un dealer o en cualquier parte.

02Exports de servidor

Export	Descripción
`GetReputation(source)`	Los puntos de reputación de un jugador, 0 para quien aún no tiene ninguno.
`SetReputation(source, value)`	Fija la reputación de un jugador en un valor, nunca por debajo de 0. Devuelve true si tiene éxito.
`AddReputation(source, amount)`	Suma reputación, o la resta con una cantidad negativa. Un nuevo nivel se anuncia al jugador y a la app Companion. Devuelve true si tiene éxito.
`GetLevel(source)`	Devuelve dos valores: el número del nivel del jugador (de 1 a 5 por defecto) y su nombre.
`AddCredit(source, amount)`	Añade crédito de dealer, que el jugador puede usar en su próxima compra o pedido. Devuelve true si tiene éxito.
`RelocateDealer(dealerId)`	Mueve al momento a un dealer a otro de sus lugares. Devuelve true si se ha movido.
`SendDealerAway(dealerId, minutes)`	El dealer desaparece durante los minutos indicados y luego aparece en otro de sus lugares, como tras una visita de la policía.
`IsDealerPresent(dealerId)`	True mientras el dealer está en uno de sus lugares y no se ha ido.
`StartFlashSale(minutes)`	Inicia una oferta relámpago con objetos al azar con descuento. Sin minutos se usa el tiempo de Config.FlashSale.

03Eventos

Nombre	Lado	Descripción
`agency-blackmarket:deal`	Servidor	Se dispara en el servidor con (source, kind, data) tras cada trato. kind es buy, sell, launder, order, pickup o job, y data contiene los detalles del trato, como el dealer, los objetos y el total.
`agency-blackmarket:dealerMoved`	Servidor	Se dispara en el servidor con (dealerId, pos, reason) cuando un dealer cambia de lugar. reason es rotate, return, admin o export.
`agency-blackmarket:flashSale`	Servidor	Se dispara en el servidor con (items, minutes) cuando empieza una oferta relámpago. items asigna a cada objeto rebajado su descuento en porcentaje.

+Conviene saber

Agency-Blackmarket V2 ofrece exports y eventos para que tus propios scripts puedan dar reputación y crédito, controlar a los dealers y reaccionar a los tratos.

Reputación y crédito: GetReputation, SetReputation, AddReputation y GetLevel leen y cambian la posición de un jugador, y AddCredit paga crédito de dealer. Reciben el id de servidor de un jugador conectado.
Dealers y ofertas relámpago: RelocateDealer, SendDealerAway e IsDealerPresent controlan a los dealers con el id de Config.Dealers, y StartFlashSale inicia una oferta desde tu propio evento.
Eventos: agency-blackmarket:deal se dispara tras cada trato, agency-blackmarket:dealerMoved tras cada traslado y agency-blackmarket:flashSale cuando empieza una oferta. Los tres se disparan solo en el servidor y sirven para logs, herramientas de policía o tus propios trabajos.

?Preguntas frecuentes

¿Cómo abro el menú desde mi menú radial?

Llama a exports['Agency-Blackmarket']:OpenMenu() en el cliente. Se aplican las mismas comprobaciones que con el comando, incluido un objeto de Config.Menu.item.