Installation

Suivez ces étapes pour ajouter TradeX à votre serveur. L'application s'installe comme toute app lb-phone, dans le dossier [phone] de vos ressources.

Prérequis

Élément	Détail
lb-phone	Requis, installé et fonctionnel
ox_lib	Requis (callbacks)
oxmysql	Requis (persistance des données)
Un framework	Requis — qb-core, qbx_core ou es_extended
Un script bancaire	Optionnel — uniquement pour le mode revenue des actions

NOTE

Le framework est détecté automatiquement au démarrage. Aucun script bancaire n'est nécessaire tant que vous restez en mode volatility (réglage par défaut).

1. Ajouter la ressource

Placez le dossier lo_tradex dans resources/[phone]/ :

resources/
└── [phone]/
    └── lo_tradex/
        ├── fxmanifest.lua
        ├── shared/
        │   ├── config.lua
        │   ├── locales.lua
        │   ├── utils.lua
        │   └── framework.lua
        ├── client/client.lua
        ├── server/
        │   ├── db.lua
        │   └── server.lua
        ├── locales/          ← 2 fichiers de langue (en, fr)
        └── ui/
            └── dist/         ← interface déjà compilée

2. Ordre de démarrage

Dans server.cfg, démarrez TradeX après ses dépendances :

ensure oxmysql
ensure ox_lib
ensure lb-phone
ensure lo_tradex

WARNING

Si lo_tradex démarre avant lb-phone, l'application ne s'enregistrera pas dans le téléphone. Respectez l'ordre : oxmysql → ox_lib → lb-phone → lo_tradex. Votre framework (et, le cas échéant, votre script bancaire) doivent eux aussi être démarrés avant.

3. Base de données

Le schéma est créé automatiquement au premier démarrage via oxmysql — aucun import SQL n'est nécessaire. TradeX crée toutes ses tables (comptes joueurs, état des marchés crypto et actions, positions, transactions, watchlists, historiques de prix et de portefeuille, opérations bancaires).

NOTE

Les tables sont préfixées par phone_trade_ afin d'éviter tout conflit. Les données d'historique plus anciennes que Config.MaxHistoryDays sont purgées automatiquement.

4. Interface (UI)

L'interface est déjà compilée : le dossier ui/dist/ est fourni et servi au téléphone par fxmanifest.lua. Aucune compilation n'est requise pour utiliser l'application.

TIP

Vous n'avez rien à faire ici dans le cas standard : l'UI livrée est prête à l'emploi. Pour ajouter vos propres icônes de coins, déposez-les dans ui/dist/assets/coins/ et référencez-les en nui://lo_tradex/ui/dist/assets/coins/votrefichier.png.

Vérification

1. Démarrez le serveur (ou ensure lo_tradex à chaud).
2. Vérifiez la console : les tables phone_trade_* doivent être créées sans erreur au premier lancement, et la ligne Framework: ... doit indiquer votre framework détecté.
3. Sur le téléphone en jeu, ouvrez l'App Store : TradeX doit y apparaître, prête à être téléchargée.
4. Installez-la, créez un compte de trading et passez un premier ordre d'achat pour valider le fonctionnement.

TIP

Pour préinstaller l'application sur le téléphone de tous les joueurs (sans passer par l'App Store), réglez Config.DefaultApp = true dans shared/config.lua.

Une fois l'installation validée, ajustez le comportement via la Configuration.