TS-Lib - Librairie Bridge Universelle pour Frameworks FiveM

TS-Lib est un bridge framework FiveM complet et une librairie d'utilitaires universelle.

📌 Pourquoi utiliser un bridge framework FiveM

TS-Lib vous évite le casse-tête de la compatibilité avec plusieurs frameworks, inventaires, systèmes de garages et scripts de clés. Au lieu d'encombrer vos ressources avec des vérifications if/else à n'en plus finir, ts-lib gère tout sous un seul namespace unifié : TS.

Il est conçu pour être injecté dynamiquement dans n'importe quel script, ce qui garde le code de vos ressources propre, rapide et totalement indépendant.

📥 Téléchargement

Télécharger la dernière version

Les contributions sont les bienvenues : consultez la documentation si vous voulez proposer de nouveaux bridges ou des améliorations.

Vous pouvez aussi parcourir le code source sur GitHub.

🚀 Fonctionnalités

• Détection automatique du framework : prend en charge nativement qb-core, qbx_core, es_extended et standalone. Il choisit automatiquement le framework le plus moderne disponible, ou celui que vous forcez dans la config.
• Bridges unifiés :
  • Garages : prise en charge native de qb-garages, esx_garage, vms_garagesv2, jg-advancedgarages et standalone.
  • Clés : prise en charge native de qb-vehiclekeys, qs-vehiclekeys et standalone.
• Utilitaires centralisés : les prints, le debug et les vérifications de ressources sont entièrement centralisés (TS.Print, TS.DebugPrint, TS.ErrorPrint).
• Helpers d'UI intégrés : des helpers NUI simples pour les sous-titres et le texte à l'écran (TS.Lib.Subtitle, TS.Lib.TextUI), aussi appelables via des exports.

🛠️ Installation

1. Placez le dossier ts-lib dans votre dossier resources.
2. Dans le fxmanifest.lua du script qui doit utiliser ts-lib, ajoutez cette seule ligne à vos shared_scripts :

shared_scripts {
    '@ts-lib/import.lua',
    -- Vos autres shared scripts...
}

C'est tout ! ts-lib démarre automatiquement, détecte le framework du serveur, récupère la configuration, expose le namespace TS et charge dynamiquement les modules nécessaires.

⚙️ Configuration

Vous pouvez choisir précisément les systèmes utilisés par ts-lib dans ts-lib/config.lua.

Config = {
    debug = true,

    -- Framework selection: 'auto', 'qbcore', 'esx', 'qbox', 'standalone'
    Framework = 'auto',

    -- Garage system: 'auto', 'qb-garages', 'esx_garage', 'vms_garagesv2', 'jg-advancedgarages', 'standalone'
    Garages = 'auto',

    -- Vehicle keys system: 'auto', 'qb-vehiclekeys', 'qs-vehiclekeys', 'standalone'
    VehicleKeys = 'auto',

    Data = {
        Framework = {
            qbcore = 'qb-core',
            esx = 'es_extended',
            qbox = 'qbx_core',
            standalone = 'standalone',
        },
        Garages = {
            ['qb-garages']        = 'qb-garages',
            ['esx_garage']        = 'esx_garage',
            ['vms_garagesv2']     = 'vms_garagesv2',
            ['jg-advancedgarages']= 'jg-advancedgarages',
            ['standalone']        = 'standalone',
        },
        VehicleKeys = {
            ['qb-vehiclekeys'] = 'qb-vehiclekeys',
            ['qs-vehiclekeys'] = 'qs-vehiclekeys',
            ['standalone']     = 'standalone',
        },
    },
}

📖 Documentation

Pour les instructions complètes, des exemples d'utilisation (y compris les helpers d'UI) et la référence détaillée de l'API, consultez la documentation officielle de TS-Lib : docs.thunder-studio.net/scripts/ts-lib

📝 Licence

Distribué sous licence MIT. Voir LICENSE pour plus d'informations.

💬 Support

Si vous avez besoin d'aide ou voulez découvrir des scripts plus avancés, rejoignez le Discord : store.thunder-studio.net/discord