QBESXStandalone

Agency-Shops Kurulum

Haritadaki her 24/7, LTD, Rob's Liquor, yapı market, Ammu-Nation ve benzinlik FiveM için tek bir scriptte.

v1.0.0Ücretli5 Sayfalarİtibaren October 19, 2026, 20:00 CEST

Satın Al Kataloğa dön

01Kurulum

1Extract Agency-Shops into your resources folder
2Sunucunuzda OneSync özelliğinin etkin olduğundan emin olun
3Add ensure Agency-Shops to server.cfg, after your framework, your inventory and oxmysql
4Sunucuyu başlatın: veritabanı tabloları ilk başlatmada oluşturulur (install/agency_shop.sql yalnızca veritabanı kullanıcınız tablo oluşturma yetkisine sahip değilse gereklidir)
5Yöneticilere /ashops panelini vermek için add_ace group.admin agency.shop allow satırını ekleyin
6qb-shops, esx_shops veya ox_inventory mağazalarını mı kullanıyorsunuz? 24/7 kayıtlarını kaldırın, aksi takdirde aynı tezgâhın arkasında iki kasiyer durur
7qb-storerobbery veya benzeri bir script mi kullanıyorsunuz? Birini kapatın veya Config.Robbery.Enabled = false olarak ayarlayın
8Kendi pompalarına sahip bir yakıt scripti mi kullanıyorsunuz? Pompa etkileşimini kapatın veya Config.GasStations.Enabled = false olarak ayarlayın
9Standalone: para ve eşyalar için Config.Standalone alanını doldurun (yapılandırma sayfasına bakın)
10İsteğe bağlı: oyunculara hiçbir zaman gönderilmeyen config_server.lua içine Discord webhook adreslerinizi girin

02Bağımlılıklar

oxmysql (gerekli)
OneSync (gerekli)
QBCore, QBox veya ESX (isteğe bağlı, biri olmadan standalone çalışır)
Bir envanter (isteğe bağlı: ox_inventory, qs-inventory veya framework envanteriniz, otomatik bulunur)
Agency Phone (isteğe bağlı, ödeme yöntemi olarak Agency Pay ekler)
Agency-Notify (isteğe bağlı, aksi takdirde dükkan kendi bildirimlerini gösterir)
ox_target veya qb-target (isteğe bağlı, aksi takdirde tuş istemi kullanılır)
ps-dispatch veya cd_dispatch (isteğe bağlı, soygun ve hırsızlık bildirimleri için, aksi takdirde entegre bildirim kullanılır)
Bir yakıt scripti (isteğe bağlı: LegacyFuel, ox_fuel, cdn-fuel, ps-fuel, lc_fuel, Renewed-Fuel, okokGasStation veya qs-fuelstations, aksi takdirde entegre yakıt sistemi çalışır)

03SQL Dosyası

İsteğe bağlı: Resource başlatıldığında bu tabloları otomatik oluşturur. Bu dosyayı yalnızca veritabanını manuel kurduysanız içe aktarın:

-- =============================================================================
-- AGENCY SHOP - database tables
-- Created automatically on start (Config.AutoApplySql = true). Run this file by
-- hand only if your database user may not create tables.
-- =============================================================================

CREATE TABLE IF NOT EXISTS `agency_shop_owned` (
    `id`            VARCHAR(64)  NOT NULL,
    `kind`          VARCHAR(16)  NOT NULL DEFAULT 'store',
    `owner`         VARCHAR(80)  NOT NULL,
    `owner_name`    VARCHAR(120) NOT NULL DEFAULT '',
    `name`          VARCHAR(60)  NULL DEFAULT NULL,
    `balance`       INT          NOT NULL DEFAULT 0,
    `prices`        LONGTEXT     NULL,
    `stock`         LONGTEXT     NULL,
    `staff`         LONGTEXT     NULL,
    `fuel`          INT          NOT NULL DEFAULT 0,
    `fuel_prices`   LONGTEXT     NULL,
    `sales_total`   INT          NOT NULL DEFAULT 0,
    `revenue_total` BIGINT       NOT NULL DEFAULT 0,
    `last_sale`     TIMESTAMP    NULL DEFAULT NULL,
    `bought_at`     TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `owner` (`owner`)
);

CREATE TABLE IF NOT EXISTS `agency_shop_orders` (
    `id`           INT          NOT NULL AUTO_INCREMENT,
    `shop`         VARCHAR(64)  NOT NULL,
    `kind`         VARCHAR(16)  NOT NULL DEFAULT 'goods',
    `items`        LONGTEXT     NULL,
    `crates`       INT          NOT NULL DEFAULT 0,
    `litres`       INT          NOT NULL DEFAULT 0,
    `cost`         INT          NOT NULL DEFAULT 0,
    `fee`          INT          NOT NULL DEFAULT 0,
    `status`       VARCHAR(16)  NOT NULL DEFAULT 'open',
    `courier`      VARCHAR(80)  NULL DEFAULT NULL,
    `courier_name` VARCHAR(120) NULL DEFAULT NULL,
    `eta`          INT          NULL DEFAULT NULL,
    `created_at`   TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `shop` (`shop`),
    KEY `status` (`status`)
);

CREATE TABLE IF NOT EXISTS `agency_shop_points` (
    `id`       INT          NOT NULL AUTO_INCREMENT,
    `shop`     VARCHAR(64)  NOT NULL,
    `kind`     VARCHAR(16)  NOT NULL,
    `x`        DOUBLE       NOT NULL,
    `y`        DOUBLE       NOT NULL,
    `z`        DOUBLE       NOT NULL,
    `h`        DOUBLE       NOT NULL DEFAULT 0,
    `category` VARCHAR(40)  NULL DEFAULT NULL,
    PRIMARY KEY (`id`),
    KEY `shop` (`shop`)
);

CREATE TABLE IF NOT EXISTS `agency_shop_ledger` (
    `id`         INT          NOT NULL AUTO_INCREMENT,
    `shop`       VARCHAR(64)  NOT NULL,
    `kind`       VARCHAR(24)  NOT NULL,
    `amount`     INT          NOT NULL DEFAULT 0,
    `note`       VARCHAR(160) NULL DEFAULT NULL,
    `created_at` TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `shop` (`shop`)
);

-- What admins change with /ashops: catalogs and store settings, laid over config.lua.
CREATE TABLE IF NOT EXISTS `agency_shop_overrides` (
    `kind`       VARCHAR(16)  NOT NULL,
    `id`         VARCHAR(64)  NOT NULL,
    `data`       LONGTEXT     NULL,
    `updated_at` TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (`kind`, `id`)
);

-- Every sale of an owned store or station, line by line: the owner's analytics.
CREATE TABLE IF NOT EXISTS `agency_shop_sales` (
    `id`         INT          NOT NULL AUTO_INCREMENT,
    `shop`       VARCHAR(64)  NOT NULL,
    `sale`       VARCHAR(24)  NOT NULL,
    `item`       VARCHAR(64)  NOT NULL,
    `qty`        INT          NOT NULL DEFAULT 0,
    `amount`     INT          NOT NULL DEFAULT 0,
    `account`    VARCHAR(16)  NOT NULL DEFAULT 'cash',
    `created_at` TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `shop_time` (`shop`, `created_at`)
);

+Bilmenizde fayda var

Agency-Shops ensure satırından hemen sonra çalışır. İlk başlatmadan önce dört noktaya göz atmakta fayda vardır: başlatma sırası, veritabanı, yönetici erişimi ve diğer mağaza, soygun veya yakıt scriptleri.

Başlatma Sırası ve OneSync: server.cfg içinde framework, envanter ve oxmysql satırlarından sonra ensure Agency-Shops ekleyin. OneSync açık olmalıdır ve oxmysql gereklidir.
Veritabanı: agency_shop_owned, agency_shop_orders, agency_shop_points, agency_shop_ledger, agency_shop_overrides ve agency_shop_sales tabloları ilk başlatmada oluşturulur. install/agency_shop.sql yalnızca veritabanı kullanıcınız tablo oluşturma yetkisine sahip olmadığında gereklidir ve Config.AutoApplySql = false otomatik adımı kapatır.
Yönetici Erişimi: Yöneticiler; agency.shop ACE iznine, group.admin veya group.superadmin yetkisine ya da Config.Admin.Groups içindeki bir gruba sahip oyunculardır. add_ace group.admin agency.shop allow komutu admin grubunuza /ashops panelini verir. Standalone sunucularda Config.Standalone.admins lisansları listeler.
Diğer Mağaza Scriptleri: qb-shops, esx_shops veya ox_inventory mağazalarının 24/7 girdilerini kaldırın, aksi takdirde aynı kasanın arkasında iki kasiyer durur. qb-storerobbery ve benzeri scriptleri kapatın veya Config.Robbery.Enabled = false yapın. Kendi pompalarına sahip bir yakıt scripti için pompa etkileşimini kapatın veya Config.GasStations.Enabled = false olarak ayarlayın.

?Sıkça sorulan sorular

Discord webhook'ları nereye eklenir?

Ownership, Register, Deliveries, Shoplift ve Robbery için config_server.lua dosyasına eklenir. Bu dosya oyunculara asla gönderilmez.

Agency Phone gerekli mi?

Hayır. agency-phone çalışırken kasada ve pompada Agency Pay otomatik olarak sunulur. O olmadan oyuncular nakit veya kartla öder.