QBESXStandalone

Agency-Blackmarket V2 Exports & API

Ein lebendiger Schwarzmarkt für FiveM auf QBCore, Qbox, ESX oder komplett standalone.

v2.0.0Bezahlt6 Seiten

01Client-Exports

Export	Beschreibung
`OpenMenu()`	Öffnet das Menü von /ablackmarket, zum Beispiel aus einem Radialmenü oder einer Handy-App. Es gelten dieselben Prüfungen wie beim Befehl.
`CloseMenu()`	Schließt das Menü und gibt die Maus zurück ans Spiel.
`IsMenuOpen()`	Gibt true zurück, solange das Schwarzmarkt-Menü offen ist, beim Händler oder unterwegs.

02Server-Exports

Export	Beschreibung
`GetReputation(source)`	Die Rufpunkte eines Spielers, 0 für einen Spieler, der noch keine hat.
`SetReputation(source, value)`	Setzt den Ruf eines Spielers auf einen festen Wert, nie unter 0. Gibt bei Erfolg true zurück.
`AddReputation(source, amount)`	Gibt Ruf dazu oder nimmt ihn mit einem negativen Betrag weg. Eine neue Stufe wird dem Spieler und der Companion-App gemeldet. Gibt bei Erfolg true zurück.
`GetLevel(source)`	Gibt zwei Werte zurück: die Nummer der Stufe des Spielers (standardmäßig 1 bis 5) und ihren Namen.
`AddCredit(source, amount)`	Gibt Händlerguthaben dazu, das der Spieler beim nächsten Kauf oder der nächsten Bestellung einsetzen kann. Gibt bei Erfolg true zurück.
`RelocateDealer(dealerId)`	Lässt einen Händler sofort an einen anderen seiner Orte ziehen. Gibt true zurück, wenn er umgezogen ist.
`SendDealerAway(dealerId, minutes)`	Der Händler verschwindet für die angegebenen Minuten und taucht dann an einem anderen seiner Orte auf, wie nach einem Polizeibesuch.
`IsDealerPresent(dealerId)`	True, solange der Händler an einem seiner Orte steht und nicht weg ist.
`StartFlashSale(minutes)`	Startet einen Flash Sale mit zufälligen Items zum Sonderpreis. Ohne Minuten gilt die Zeit aus Config.FlashSale.

03Events

Name	Seite	Beschreibung
`agency-blackmarket:deal`	Server	Wird nach jedem Deal auf dem Server mit (source, kind, data) ausgelöst. kind ist buy, sell, launder, order, pickup oder job, und data enthält die Einzelheiten des Deals, etwa den Händler, die Items und die Summe.
`agency-blackmarket:dealerMoved`	Server	Wird auf dem Server mit (dealerId, pos, reason) ausgelöst, wenn ein Händler seinen Ort wechselt. reason ist rotate, return, admin oder export.
`agency-blackmarket:flashSale`	Server	Wird auf dem Server mit (items, minutes) ausgelöst, wenn ein Flash Sale startet. items ordnet jedem reduzierten Item seinen Rabatt in Prozent zu.

+Gut zu wissen

Agency-Blackmarket V2 bietet Exports und Events, damit deine eigenen Scripts Ruf und Guthaben vergeben, die Händler steuern und auf Deals reagieren können.

Ruf und Guthaben: GetReputation, SetReputation, AddReputation und GetLevel lesen und ändern das Ansehen eines Spielers, und AddCredit zahlt Händlerguthaben aus. Sie nehmen die Server-ID eines Spielers, der online ist.
Händler und Flash Sales: RelocateDealer, SendDealerAway und IsDealerPresent steuern die Händler über die ID aus Config.Dealers, und StartFlashSale startet einen Sale aus deinem eigenen Event.
Events: agency-blackmarket:deal wird nach jedem Deal ausgelöst, agency-blackmarket:dealerMoved nach jedem Umzug und agency-blackmarket:flashSale, wenn ein Sale startet. Alle drei gibt es nur auf dem Server, nutzbar für Logs, Polizeiwerkzeuge oder eigene Jobs.

?Häufige Fragen

Wie öffne ich das Menü aus meinem Radialmenü?

Rufe exports['Agency-Blackmarket']:OpenMenu() auf dem Client auf. Es gelten dieselben Prüfungen wie beim Befehl, auch ein Item aus Config.Menu.item.