Accueil › Documentation › Installation · origen_ilegalv2

Installation · origen_ilegalv2

1. Téléchargement

Télécharge la ressource depuis ton panneau client et extrais-la dans ton dossier de ressources.

bash
cd resources/
unzip origen_ilegalv2.zip -d [origen]/origen_ilegalv2

2. Importe la base de données

Le schéma se trouve dans database.sql, à la racine de la ressource.

La ressource vérifie aussi le schéma automatiquement à chaque démarrage via server/classes/database.lua. Si une table ou une colonne est manquante, elle est créée automatiquement. Le fichier database.sql fait foi : garde-le synchronisé si tu modifies le modèle de données.

database.sql inclut la table origen_gang_announcements, nécessaire au système d’annonces d’administration. Si tu mets à jour depuis une version antérieure, exécute manuellement l’instruction suivante :

sql
CREATE TABLE IF NOT EXISTS `origen_gang_announcements` (
  `id`               int(11)      NOT NULL AUTO_INCREMENT,
  `title`            varchar(255) NOT NULL,
  `description`      text         DEFAULT NULL,
  `image_url`        varchar(512) DEFAULT NULL,
  `target_all_gangs` tinyint(1)   NOT NULL DEFAULT 1,
  `sent_by`          varchar(60)  NOT NULL,
  `sent_by_name`     varchar(150) NOT NULL,
  `sent_at`          timestamp    NOT NULL DEFAULT current_timestamp(),
  PRIMARY KEY (`id`),
  KEY `sent_at` (`sent_at`),
  KEY `target_all_gangs` (`target_all_gangs`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

3. Configure

Ouvre config/general.lua et définis ta langue :

luaconfig/general.lua
Config.Debug    = false
Config.Language = 'en'  -- 'en' | 'es'

Ouvre éventuellement config_sv.lua pour les réglages côté serveur, comme les tokens de logs Fivemanage.

config_sv.lua contient des tokens sensibles. **N’**expose pas son contenu dans des logs ni dans des dépôts publics.

4. Enregistre l’item ilegal_cad

Ajoute l’item du CAD à la liste d’items de ta ressource d’inventaire :

luaExample — ox_inventory/data/items.lua
['ilegal_cad'] = {
    label  = 'Gang CAD',
    weight = 100,
    stack  = false,
},

Le premier CAD est remis automatiquement lors de la création d’un gang. Les unités supplémentaires s’achètent depuis le tableau de bord du gang.

5. Ajoute à server.cfg

Démarre ton framework (es_extended, qb-core ou qbx_core), ton inventaire (si tu utilises l’un des bridges pris en charge) et toutes les autres ressources dont origen_ilegalv2 dépend pour la détection automatique — target, dispatch, voix, etc. — avant origen_ilegalv2. La détection ne voit que les fournisseurs déjà démarrés. Consulte Dépendances pour la matrice complète.

bashserver.cfg
# Framework + inventory + optional bridges (examples — use your actual resource names)
# ensure qbx_core
# ensure ox_inventory
 
# Optional integrations — must start BEFORE origen_ilegalv2 if used
# ensure origen_graffiti   # standalone graffiti system
# ensure origen_police     # police integration (Robbery Requests)
 
ensure oxmysql
ensure ox_lib
ensure origen_ilegalv2

L’ordre de chargement est important. oxmysql et ox_lib doivent démarrer avant origen_ilegalv2, et ton framework / inventaire / ressources avec bridge doivent démarrer avant origen_ilegalv2 pour que la détection automatique puisse les résoudre.

origen_graffiti — prévention manuelle des conflits obligatoire

Si tu utilises origen_graffiti, tu dois désactiver manuellement le système de graffitis interne de origen_ilegalv2. Ouvre config/graffiti.lua et définis Enable = false :

luaconfig/graffiti.lua
Config.Graffiti = {
    Enable = false, -- Disable internal graffiti — using origen_graffiti instead
    ...
}

Cela désactive la bombe de peinture, l’éditeur NUI, le chiffon de nettoyage et le rendu des graffitis posés. L’intégration de la réputation des territoires (graffiti_external.lua) reste active et continue de traiter les tags d’origen_graffiti.

origen_police — Demandes de braquage

L’onglet des demandes de braquage du panneau de gang n’est visible que lorsque origen_police est en cours d’exécution. Démarre origen_police avant origen_ilegalv2 pour que l’onglet soit visible dès la première connexion. Si origen_police démarre après, l’onglet apparaît automatiquement dès qu’il passe en ligne.

6. Vérifie

Démarre le serveur et consulte la console. Au premier démarrage, tu devrais voir :

text
[origen_ilegalv2]
* Framework: qb-core
* Inventory: ox_inventory
* Language: en
* Debug: Disabled
* Version: 1.0.0  Latest Version

Toutes les dépendances détectées s’affichent avec le nom de leur fournisseur actif. Tout ✗ indique une ressource manquante ou non démarrée.