QBESXStandalone

Agency-Gangs Installation

Das komplette Gang-System für FiveM in einem Skript.

v1.0.0Bezahlt5 Seiten

Im Shop kaufen Zur Übersicht

01Installation

1Entpacke Agency-Gangs in deinen resources-Ordner
2Füge ensure Agency-Gangs in die server.cfg ein, nach deinem Framework, deinem Inventar und oxmysql
3Starte den Server: Die Datenbanktabellen werden beim ersten Start automatisch erstellt (sql/install.sql wird nur benötigt, wenn dein Datenbank-Benutzer keine Tabellen erstellen darf)
4Kopiere die fünf Item-Bilder aus install/images in den Bildordner deines Inventars
5ox_inventory: Füge die fünf Items aus der README in ox_inventory/data/items.lua ein. QBCore- und QBox-Inventare erhalten die Items zur Laufzeit, ESX führt das INSERT am Ende von sql/install.sql aus
6Gib Admins das Panel mit add_ace group.admin agency.gangs allow
7Öffne im Spiel /agangs, erstelle eine Gang und platziere ihre Versteckpunkte im Gang-Editor, oder importiere deine bestehenden Gangs auf der Import-Seite

02Abhängigkeiten

oxmysql (erforderlich)
OneSync (erforderlich)
QBCore, QBox oder ESX (optional, ohne Framework läuft es standalone)
Ein Inventar (optional: ox_inventory, qb-inventory, ps-inventory, lj-inventory, jpr-inventory, qs-inventory oder codem-inventory, wird automatisch erkannt)
Agency Phone und Agency Pad (optional, fügt die Gangs-App hinzu)
Agency Housing (optional, Ganghaus)
Agency Blackmarket (optional, Gang-Rabatt und Bezahlung per Gang-Bank)
Agency-Garage oder jg-advancedgarages (optional, eigene Fahrzeuge der Mitglieder in der Gang-Garage)
ox_target oder qb-target (optional, andernfalls wird die Tastenaufforderung genutzt)
Agency-Notify (optional, andernfalls werden die Benachrichtigungen deines Frameworks genutzt)
Agency-Companion (optional, kostenlos: verbindet das Script über /app mit der Agency Companion App)

03SQL Datei

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

-- 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);