QBESXStandalone
Agency-Gangs التثبيت
نظام العصابات المتكامل لـ FiveM في سكربت واحد.
v1.0.0مدفوع5 صفحات

01التثبيت
- 1فك ضغط Agency-Gangs في مجلد resources الخاص بك
- 2أضف ensure Agency-Gangs إلى server.cfg بعد إطار العمل والحقيبة وoxmysql
- 3شغل السيرفر: يتم إنشاء جداول قاعدة البيانات عند أول تشغيل (ملف sql/install.sql مطلوب فقط إذا كان مستخدم قاعدة البيانات لا يملك صلاحية إنشاء الجداول)
- 4انسخ صور العناصر الخمسة من install/images إلى مجلد الصور في حقيبتك
- 5ox_inventory: أضف العناصر الخمسة من README إلى ox_inventory/data/items.lua. حقائب QBCore وQBox تحصل على العناصر أثناء التشغيل، بينما ينفذ ESX أمر INSERT في نهاية sql/install.sql
- 6امنح الإداريين اللوحة عبر add_ace group.admin agency.gangs allow
- 7افتح /agangs داخل اللعبة، أنشئ عصابة وحدد نقاط مخبئها في محرر العصابات، أو استورد عصاباتك الحالية من صفحة Import
02المتطلبات
oxmysql (مطلوب)OneSync (مطلوب)QBCore أو QBox أو ESX (اختياري، يعمل بدونها في الوضع المستقل)حقيبة (اختياري: ox_inventory أو qb-inventory أو ps-inventory أو lj-inventory أو jpr-inventory أو qs-inventory أو codem-inventory، يتم التعرف عليها تلقائياً)Agency Phone وAgency Pad (اختياري، يضيف تطبيق Gangs)Agency Housing (اختياري، منزل العصابة)Agency Blackmarket (اختياري، خصم للعصابة ودفع من بنك العصابة)Agency-Garage أو jg-advancedgarages (اختياري، سيارات الأعضاء الخاصة في كراج العصابة)ox_target أو qb-target (اختياري، وإلا يتم استخدام موجه الأزرار)Agency-Notify (اختياري، وإلا ستُستخدم إشعارات إطار العمل الخاص بك)Agency-Companion (اختياري ومجاني: يربط السكربت بتطبيق Agency Companion عبر /app)
03ملف SQL
اختياري: ينشئ المورد هذه الجداول بنفسه عند بدء التشغيل. استورد هذا الملف فقط إذا كنت تُعدّ قاعدة البيانات يدويًا:
-- Agency Gangs: the script creates these tables by itself on the first start.
-- Run this file only if your database user may not create tables.
CREATE TABLE IF NOT EXISTS `agency_gangs` (
`id` INT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(50) NOT NULL,
`label` VARCHAR(64) NOT NULL,
`leader` VARCHAR(64) NULL,
`bank` BIGINT NOT NULL DEFAULT 0,
`dirty` BIGINT NOT NULL DEFAULT 0,
`xp` INT NOT NULL DEFAULT 0,
`data` LONGTEXT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `name` (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `agency_gang_members` (
`identifier` VARCHAR(64) NOT NULL,
`gang_id` INT NOT NULL,
`grade` INT NOT NULL DEFAULT 0,
`name` VARCHAR(100) NULL,
`joined_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
`last_seen` TIMESTAMP NULL DEFAULT NULL,
PRIMARY KEY (`identifier`),
KEY `gang_id` (`gang_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `agency_gang_logs` (
`id` BIGINT NOT NULL AUTO_INCREMENT,
`gang_id` INT NOT NULL,
`category` VARCHAR(20) NOT NULL,
`actor` VARCHAR(100) NULL,
`message` VARCHAR(255) NOT NULL,
`amount` BIGINT NULL,
`created_at` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `gang_id` (`gang_id`, `id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `agency_gang_territories` (
`id` INT NOT NULL AUTO_INCREMENT,
`name` VARCHAR(50) NOT NULL,
`label` VARCHAR(64) NOT NULL,
`x` DOUBLE NOT NULL, `y` DOUBLE NOT NULL, `z` DOUBLE NOT NULL,
`radius` DOUBLE NOT NULL DEFAULT 150,
`income` INT NOT NULL DEFAULT 0,
`owner` INT NULL DEFAULT NULL,
`captured_at` INT NULL DEFAULT NULL,
`data` LONGTEXT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `name` (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `agency_gang_graffiti` (
`id` INT NOT NULL AUTO_INCREMENT,
`gang_id` INT NOT NULL,
`x` DOUBLE NOT NULL, `y` DOUBLE NOT NULL, `z` DOUBLE NOT NULL,
`nx` DOUBLE NOT NULL, `ny` DOUBLE NOT NULL, `nz` DOUBLE NOT NULL,
`territory` INT NULL DEFAULT NULL,
`created_at` INT NOT NULL,
`text` VARCHAR(24) NULL,
`style` VARCHAR(12) NULL,
`size` VARCHAR(2) NULL,
PRIMARY KEY (`id`),
KEY `gang_id` (`gang_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `agency_gang_wars` (
`id` INT NOT NULL AUTO_INCREMENT,
`kind` VARCHAR(10) NOT NULL,
`attacker` INT NULL, `defender` INT NULL,
`wager` BIGINT NOT NULL DEFAULT 0,
`status` VARCHAR(12) NOT NULL,
`started` INT NULL, `ends` INT NULL,
`winner` INT NULL,
`data` LONGTEXT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-- ESX only: the new items (QBCore / QBox get them automatically, ox_inventory see README).
-- INSERT IGNORE INTO `items` (`name`, `label`, `weight`) VALUES
-- ('spraycan', 'Spray Can', 1), ('spray_remover', 'Spray Remover', 1), ('zipties', 'Zip Ties', 1),
-- ('head_bag', 'Head Bag', 1), ('gang_contract', 'Gang Contract', 1);