TradeX
TradeX (Lo TradeX / Lo Crypto) est une application de trading pour lb-phone. Vos joueurs investissent dans des cryptomonnaies et des actions d'entreprises directement depuis leur téléphone : achat, vente, suivi du portefeuille en direct et graphiques de cours. Transformez votre serveur en véritable Wall Street.
Présentation
L'application se télécharge depuis l'App Store du téléphone (ou s'installe automatiquement) et donne accès à deux marchés : un marché crypto entièrement personnalisable et un marché d'actions lié soit à la volatilité, soit au revenu hebdomadaire des entreprises. Chaque joueur dispose d'un solde de trading dédié, alimenté depuis sa banque, et suit en temps réel la valeur de ses positions.
Fonctionnalités
Marché crypto
- Coins entièrement personnalisables (symbole, nom, prix de départ, icône).
- Simulation de prix en temps réel recalculée à intervalle configurable.
- Volatilité et tendance par coin : amplitude des variations et biais haussier/baissier.
- Plancher et plafond par coin : le prix ne descend ni ne monte au-delà des bornes.
- Frais de transaction appliqués à chaque achat/vente.
Marché d'actions
- Actions d'entreprises échangeables comme des cryptos.
- Deux modes de prix : volatilité (aléatoire, par défaut) ou revenu (lié au chiffre d'affaires hebdomadaire).
- Sensibilité par entreprise en mode revenu : réactivité du cours au revenu.
- Frais de transaction dédiés aux actions.
Portefeuille
- P&L en direct (gains/pertes latents).
- Prix d'achat moyen par actif.
- Variation sur 24 h et valeur totale des positions.
- Historique de la valeur du portefeuille.
Graphiques
- Historiques de cours sur 1 h / 24 h / 7 j / 30 j.
- Graphiques interactifs pour les cryptos, les actions et le portefeuille.
- Watchlist : suivez vos coins et actions favoris en accès rapide.
Wallet
- Dépôt et retrait entre la banque du joueur et son solde de trading.
- Historique complet des transactions : crypto, actions et opérations bancaires.
Modes de prix des actions
TradeX propose deux façons de faire évoluer le cours des actions, choisies via Config.StockPriceMode :
| Mode | Comportement | Dépendance |
|---|---|---|
volatility (par défaut) | Les prix fluctuent aléatoirement, exactement comme les cryptos (volatilité + tendance par action). | Aucune — recommandé. |
revenue | Les prix sont calculés à partir du revenu hebdomadaire réel de chaque entreprise, lu depuis un script bancaire. Plus immersif. | Un script bancaire compatible. |
NOTE
Si revenue est sélectionné mais qu'aucun script bancaire n'est détecté, TradeX bascule automatiquement en mode volatility. En mode revenu, le symbol de l'action doit correspondre au nom du job en jeu.
Compatibilité & dépendances
Le framework est détecté automatiquement au démarrage — aucun réglage manuel.
| Framework | Statut |
|---|---|
QBCore (qb-core) | Pris en charge |
QBox (qbx_core) | Pris en charge |
ESX (es_extended) | Pris en charge |
| Dépendance | Statut | Rôle |
|---|---|---|
| lb-phone | Requise | Téléphone hôte de l'application |
| ox_lib | Requise | Callbacks et utilitaires |
| oxmysql | Requise | Persistance des données |
| Un framework | Requis | qb-core, qbx_core ou es_extended |
Scripts bancaires pris en charge (uniquement pour le mode revenue des actions, sinon optionnels) :
| Banking | Détection |
|---|---|
lo_banking | Auto |
esx_society | Auto |
qb-banking | Auto |
qb-management | Auto |
Renewed-Banking | Auto |
TIP
En mode volatility (par défaut), aucun script bancaire n'est nécessaire : TradeX fonctionne avec lb-phone, ox_lib, oxmysql et un framework seulement.
Aperçu technique
| Élément | Détail |
|---|---|
| Frontend | Interface pré-compilée servie au téléphone (ui/dist/) |
| Backend | Lua (client + serveur) |
| Persistance | oxmysql — tables phone_trade_* créées automatiquement au démarrage |
| Langues | 2 fichiers locales/*.json (en, fr) |
| Extras | Migration depuis une ancienne app crypto, nettoyage automatique de l'historique, thème sombre |
Le serveur recalcule les cours à intervalle régulier, enregistre périodiquement des instantanés de prix et de portefeuille pour tracer les graphiques, puis purge automatiquement les données plus anciennes que Config.MaxHistoryDays.
Étapes suivantes
- Installation — ajouter la ressource et préparer la base de données.
- Configuration — toutes les options de
shared/config.lua.