QBESXStandalone

Agency-Blackmarket V2 Installation

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

v2.0.0Bezahlt6 Seiten

Im Shop kaufen Zur Übersicht

01Installation

1Lege Agency-Blackmarket in deinen resources-Ordner
2Trage ensure Agency-Blackmarket in die server.cfg ein, nach deinem Framework, Inventar und Target-Script
3Mit oxmysql wird die Tabelle agency_blackmarket beim ersten Start angelegt. install/agency_blackmarket.sql brauchst du nur, wenn dein Datenbanknutzer keine Tabellen anlegen darf
4Gleiche die Items in Config.Items und Config.Sell.items mit deinem Inventar ab. Items, die dein Inventar nicht kennt, werden weggelassen, mit einer Zeile in der Serverkonsole
5Optional: add_ace group.admin agency.blackmarket allow für die Admin-Seite von /ablackmarket
6Update von V1: Ersetze den alten Ordner und nimm die neue config.lua. Der Ruf aus blackmarket_reputation wird beim ersten Start übernommen, und qb-menu wird nicht mehr gebraucht

02Abhängigkeiten

Keine Abhängigkeit erforderlich
QBCore, QBox oder ESX (optional, ohne Framework läuft es standalone)
Ein Inventar (optional: ox_inventory, qb-inventory, qs-inventory, ps, lj oder jpr)
oxmysql (optional, ohne wird alles im Key-Value-Speicher des Servers gesichert)
ox_target oder qb-target (optional, sonst ein Hinweis mit Taste)
Ein Dispatch-Script (optional: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch, lb-tablet oder origen_police)
Agency-Banking (optional, Geld im Standalone-Modus)
Agency-Notify (optional)
Agency Phone (optional, Spieler bezahlen mit Agency Pay)

03SQL Datei

Optional: Die Resource legt diese Tabellen beim Start selbst an. Importiere die Datei nur, wenn du die Datenbank von Hand einrichtest:

-- Agency Blackmarket V2
-- The resource creates this table by itself when oxmysql runs. Run this file
-- only if your database user may not create tables.

CREATE TABLE IF NOT EXISTS `agency_blackmarket` (
    `scope`   VARCHAR(16)  NOT NULL,
    `id`      VARCHAR(96)  NOT NULL,
    `data`    LONGTEXT     NOT NULL,
    `updated` INT UNSIGNED NOT NULL DEFAULT 0,
    PRIMARY KEY (`scope`, `id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- V1 kept reputation in `blackmarket_reputation`. V2 takes it over once on its
-- first start; the old table can be dropped afterwards:
-- DROP TABLE IF EXISTS `blackmarket_reputation`;

+Gut zu wissen

Agency-Blackmarket V2 läuft direkt nach der ensure-Zeile. Vor dem ersten Start lohnt ein Blick auf vier Punkte: die Items, das Schwarzgeld, die Datenbank und beim Update den Schritt von V1.

Items: Der Markt verkauft, was in Config.Items steht, und der Hehler kauft, was in Config.Sell.items steht. Items, die dein Inventar nicht kennt, werden beim Start weggelassen, mit einer Zeile in der Serverkonsole, die sie nennt. Für ox_inventory lässt sich je Item mit ox ein anderer Name setzen, zum Beispiel ammo-9 für pistol_ammo.
Schwarzgeld: QBCore nutzt markierte Scheine (markedbills) oder das Item black_money, wenn ox_inventory es kennt. Qbox nutzt das Item black_money und ESX das Konto black_money. Config.Money.dirty erzwingt einen Weg, und Config.Money.buyWith legt fest, was die Händler nehmen: Schwarzgeld, Bargeld oder Bank.
Datenbank: Mit oxmysql werden Ruf, Vorrat, Bestellungen und verbundene Handys in der Tabelle agency_blackmarket gespeichert, die das Script selbst anlegt. Ohne oxmysql landet alles im Key-Value-Speicher des Servers. install/agency_blackmarket.sql brauchst du nur, wenn dein Datenbanknutzer keine Tabellen anlegen darf.
Update von V1: Ersetze den alten Ordner durch den neuen und nimm die neue config.lua, die Config aus V1 passt nicht. Der Ruf wird beim ersten Start aus blackmarket_reputation übernommen. qb-menu und esx_menu_default werden nicht mehr gebraucht.

?Häufige Fragen

Woher kommen die Item-Bilder?

Mit Config.Images = 'auto' liest das Menü sie aus dem laufenden Inventar: ox_inventory, qs-inventory, qb-inventory, ps, lj oder jpr. Eine eigene Webadresse geht auch, und false zeigt stattdessen die Kategorie-Symbole.

Wer kann die Admin-Seite öffnen?

Spieler mit der ACE agency.blackmarket, group.admin oder group.superadmin, unter QBCore und ESX auch mit einer Gruppe aus Config.AdminGroups. add_ace group.admin agency.blackmarket allow in der server.cfg reicht für die meisten Server.