Installation générale

Ordre de démarrage, droits staff, asset escrow et base de données : ce qui est commun à tous les scripts.

#1. Copier les ressources

Place chaque dossier (tc-ui, tc-mechanic…) dans ton dossier resources. Ne renomme pas les dossiers : les scripts se référencent entre eux par leur nom (tc-ui en particulier).

#2. Ordre dans le server.cfg

L'ordre compte : un script ne peut pas démarrer avant ses dépendances, et le framework est détecté au chargement du script.

ensure oxmysql
ensure ox_lib

# ton framework : core (Vision) / es_extended / qb-core / qbx_core
ensure es_extended

# ton inventaire et ton système de cibles, si tu en as
ensure ox_inventory
ensure ox_target

# la bibliothèque d'interface, AVANT tous les scripts TC
ensure tc-ui

# les scripts TC
ensure tc-contextmenu
ensure tc-divisions
ensure tc-forensic
ensure tc-mechanic
ensure tc-banana_defuse

#3. Droits staff (ACE)

Hors Vision, les accès staff (/mecagestion, /divgestion, /forensicgestion, /gestioncontexte, /banana stop…) reposent sur la permission ACE command. Ajoute dans ton server.cfg :

add_ace group.admin command allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin

Tu peux aussi lister des identifiants dans Config.Bridge.Admins de chaque script :

Config.Bridge = {
    Admins   = { 'license:xxxxxxxx', 'discord:123456789012345678' },
    AdminAce = 'command',
}

Sur Vision, les accès passent par les permissions du panneau staff (précisées dans la page Commandes de chaque script).

#4. Base de données

Chaque script qui stocke des données crée ses tables tout seul au démarrage (requêtes CREATE TABLE IF NOT EXISTS, sans risque de doublon). Tu peux aussi importer à la main le sql/install.sql fourni, ce que la page Base de données de chaque script met à disposition en copier / télécharger.

Les scripts sans stockage persistant (tc-ui, tc-banana_defuse) n'ont aucune table.

#5. Asset escrow

Les scripts sont protégés par l'asset escrow FiveM (FXAP). Concrètement :

• La clé de licence de ton serveur (sv_licenseKey) doit être générée avec le compte Cfx.re qui a reçu le script.
• Le chiffrement ne touche que la logique (client/, server/, shared/). config.lua, bridge/, web/, sql/ et install/ restent lisibles et modifiables.
• Après l'ajout d'un script à ton compte, redémarre le serveur (pas seulement la ressource) pour que la licence soit relue.

#6. Vérifier

1. Démarre le serveur et regarde la console : aucune ligne rouge liée à tc-*.
2. Active Debug = true dans Config.Bridge du script pour afficher le framework et l'inventaire détectés (remets false ensuite).
3. En jeu, essaie la commande principale du script (voir sa page Commandes).

En cas de problème : Dépannage commun.