Personnalisation
Tout ce qui est prévu pour être modifié se trouve dans quatre dossiers ouverts : config/, locales/, bridge/ et items/. Le reste du code Lua est sous escrow.
Quel fichier décide de quoi
Section intitulée « Quel fichier décide de quoi »| Fichier | Ce qu’il contrôle | Ouvert ? |
|---|---|---|
config/config.lua | Langue, système d’interaction, notifications, livraisons, minage hors ligne, PNJ revendeur et son blip | Oui |
config/warehouses.lua | Les trois entrepôts : prix, emplacements de rigs, image, point d’arrivée, point de livraison ; paramètres de sortie et blip d’entrepôt possédé | Oui |
config/shop.lua | Chaque composant de la boutique du portable : prix, watts, hashrate, catégorie | Oui |
config/cryptos.lua | Les cryptomonnaies : nom, prix de base, volatilité, difficulté, couleur, icône | Oui |
config/webhook.lua | Les deux webhooks Discord. Chargé uniquement côté serveur | Oui |
locales/*.lua | Tous les textes, en jeu et sur l’ordinateur portable | Oui |
bridge/bridge_client.lua | Notifications, textes d’aide, callbacks et wrapper pour ox_target / qb-target / drawtext | Oui |
bridge/bridge_server.lua | Joueurs, argent, noms et items via fmLib | Oui |
items/ | Définitions d’items pour ox, qb et ESX, et icônes des items | Oui |
html/ | La boutique du revendeur et l’écran du portable, plus les images d’entrepôt dans html/img/ | Oui, sans escrow |
mic_crypto_props/ | Modèles 3D streamés et prévisualisations 3D affichées sur le portable | Assets uniquement |
Général — config/config.lua
Section intitulée « Général — config/config.lua »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.Locale | Fichier de langue utilisé dans locales/ | 'en' |
Config.Interaction | ox_target, qb-target ou drawtext (invite Appuyez sur E) | 'ox_target' |
Config.CustomLaptopNotificacions | true : messages de boutique et d’échange sous forme de toasts sur l’écran du portable. false : notifications normales de votre framework | true |
Config.ReceiveProductsDirectlyToInventory | true : composants achetés sur le portable envoyés directement dans l’inventaire. false : un colis est déposé dans l’entrepôt à ramasser | false |
Config.OfflineMining | Détermine si les rigs minent pendant que le propriétaire est déconnecté | true |
Config.OfflineRate | Vitesse du minage hors ligne. 1.0 correspond à la vitesse maximale, 0.5 à la moitié | 1.0 |
Le nom de l’option CustomLaptopNotificacions est orthographié ainsi dans le fichier — conservez cette orthographe.
Le revendeur — Config.NPC et Config.Blip
Section intitulée « Le revendeur — Config.NPC et Config.Blip »| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.NPC.model | Modèle de ped du revendeur | s_m_y_ammucity_01 |
Config.NPC.coords | Position du revendeur, avec direction | Près du port |
Config.NPC.scenario | Activité du revendeur | WORLD_HUMAN_CLIPBOARD |
Config.NPC.interactDistance | Distance d’interaction requise | 2.5 |
Config.Blip.enable | Affiche le revendeur sur la carte | true |
Config.Blip.sprite / color / scale | Apparence du blip | 478 / 5 / 0.8 |
Config.Blip.name | Libellé du blip | Crypto Warehouse Shop |
Entrepôts — config/warehouses.lua
Section intitulée « Entrepôts — config/warehouses.lua »| Entrepôt | id | Prix | Emplacements de rigs (rigSlots) |
|---|---|---|---|
| Petit | warehouse_small | 50 000 | 8 |
| Moyen | warehouse_medium | 150 000 | 21 |
| Grand | warehouse_large | 350 000 | 37 |
Chaque entrepôt dispose des champs suivants :
| Champ | Rôle |
|---|---|
id | Nom interne. Conservez les trois identifiants tels quels |
name, description | Textes de boutique, provenant du fichier de langue |
price | Coût, payable en liquide ou banque au choix de l’acheteur |
rigSlots | Nombre affiché dans la boutique |
image | Image dans la boutique, issue de html/img/ |
security, power | Labels affichés dans la boutique |
viewCoords | Où le bouton View envoie l’acheteur pour visiter |
insideCoords | Point d’arrivée dans l’entrepôt ; la sortie est ici aussi |
packageCoords | Emplacement où apparaît le colis livré |
Au-dessus de la liste :
| Option | Ce qu’elle fait | Valeur par défaut |
|---|---|---|
Config.ExitCoords | Point de sortie commun à tous les entrepôts | À côté du revendeur |
Config.WarehouseBlips | Sprite, couleur et taille du blip pour les entrepôts possédés | 478, vert, 0.7 |
La boutique — config/shop.lua
Section intitulée « La boutique — config/shop.lua »Config.Shop.Categories définit les quatre onglets de la boutique du portable (GPU, PSU, ventilateurs, racks). Config.Shop.Items liste les pièces. Les achats sur le portable sont toujours réglés par banque.
| Champ | Rôle |
|---|---|
id | Nom de l’item. Doit correspondre à un item de votre inventaire et à un modèle dans mic_crypto_props |
category | gpus, psus, fans ou racks |
label, description | Textes de la boutique, issus du fichier de langue |
price | Prix |
image | Nom du fichier d’icône |
watts | Pour GPU et ventilateurs : ce qu’il consomme. Pour PSU : ce qu’il fournit |
hashrate | GPU uniquement : GH/s par carte |
temperature, cooling | Chaleur par GPU et refroidissement par ventilateur, servant à l’équilibrage en haut du fichier. Cette version ne les applique pas en jeu — seule la puissance est contrôlée |
Prix par défaut :
| Pièce | Prix | Pièce | Prix |
|---|---|---|---|
| Badger Comm-100 | 450 | PostOP 500W | 150 |
| Wiwang PC-G | 900 | Whiz Wireless 850W | 350 |
| eCola OC Edition | 1 600 | Merryweather 1600W | 800 |
| iFruit Pro Max | 2 800 | Darrell Brother Fan | 45 |
| Sprunk Xtreme | 4 500 | FlyUS Aero Fan | 120 |
| Standard 5-Slot Rig | 1 200 | Atomic Vortex 120mm | 250 |
Le bloc de commentaires en haut de config/shop.lua détaille quelles alimentations et quels ventilateurs sont nécessaires pour chaque gamme de GPU sur un rig complet. Lisez-le avant de modifier les valeurs de watts — c’est le moyen le plus simple de conserver toutes les configurations réalisables.
Vérification de la puissance. Lors de l’installation d’un GPU ou d’un ventilateur, la consommation totale du rig (l’ensemble des GPU et ventilateurs) plus le nouveau composant doit rester inférieure ou égale à la capacité totale de ses alimentations. Si ce n’est pas le cas, l’installation est refusée avec un message puissance insuffisante.
Les cryptomonnaies — config/cryptos.lua
Section intitulée « Les cryptomonnaies — config/cryptos.lua »Quatre monnaies sont fournies d’origine. Ajoutez ou retirez des entrées librement ; toute nouvelle cryptomonnaie est automatiquement créée dans la table du marché au redémarrage suivant.
| Monnaie | Nom | Prix de base | range | difficulty |
|---|---|---|---|---|
MWX | Merryweather Crypto | 850,50 | 10 | 1.0 |
FLK | Fleeca Token | 45,20 | 5 | 0.5 |
PEG | Pegassi Coin | 12 500,00 | 25 | 5.0 |
LIFE | LifeInvader Chain | 120,75 | 15 | 0.8 |
| Champ | Ce qu’il fait |
|---|---|
label | Nom affiché sur le portable, issu du fichier de langue |
short | Symbole boursier (ticker) |
basePrice | Prix pivot autour duquel la valeur oscille |
range | Amplitude maximale de variation, en pourcentage |
difficulty | Plus elle est élevée, plus le minage est lent |
color, icon | Couleur et icône Font Awesome sur le portable |
Évolution du marché. Toutes les 15 minutes, chaque monnaie reçoit un nouveau cours : son basePrice ajusté à la hausse ou à la baisse d’une valeur aléatoire comprise dans le pourcentage défini par range. Le prix est sauvegardé et persiste après redémarrage.
Rémunération du minage. Les propriétaires répartissent le hashrate de leur entrepôt entre les monnaies à l’aide des curseurs du portable. Chaque minute, chaque crypto génère GH/s alloués × 0,01 ÷ difficulté. Une carte Badger (0,10 GH/s) sur MWX produit 0,001 MWX par minute. Le hashrate non alloué à une monnaie ne rapporte rien.
Transactions. L’achat d’une monnaie débite le compte bancaire du joueur installé devant le portable ; la vente crédite ce même compte. Les soldes appartiennent à l’entrepôt, ainsi toute personne avec qui vous le partagez peut trader avec ces fonds.
Webhooks — config/webhook.lua
Section intitulée « Webhooks — config/webhook.lua »| Option | Événement consigné |
|---|---|
Config.WebhookBuy | Chaque achat de crypto sur l’exchange |
Config.WebhookSell | Chaque vente de crypto sur l’exchange |
Chaque message contient le nom du personnage, ses identifiants license, steam et discord (celui de Discord sous forme de mention), la monnaie, la quantité et le montant total. Laissez l’URL vide pour désactiver le log. Le texte du message est configuré dans le fichier de langue (webhook_buy, webhook_sell).
Ce fichier est chargé uniquement sur le serveur, les URL ne sont donc jamais transmises aux joueurs.
Onze langues sont incluses dans locales/ : en, es, fr, de, it, pt, nl, ar, ja, ko, ru. Définissez le code dans Config.Locale.
Pour en ajouter une, copiez locales/en.lua vers un nouveau fichier portant le code voulu, modifiez la ligne Locales['en'] avec votre code, traduisez la partie droite de chaque ligne, puis indiquez ce code dans Config.Locale. L’ordinateur portable et la boutique du revendeur lisent le même fichier.
Une clé manquante dans votre fichier affichera Translation [xx][key] does not exist — il n’y a aucun recours automatique vers l’anglais, conservez donc toutes les clés de en.lua.
Quelques invites sont codées en dur en anglais dans le code sous escrow (le texte d’aide Press E to place Rig / install GPU et le label Collect Package) et ne proviennent pas du fichier de langue.
Le bridge
Section intitulée « Le bridge »Le dossier bridge/ est ouvert afin que vous puissiez adapter le script aux besoins de votre serveur.
| Fichier | Ce qu’il gère |
|---|---|
bridge/bridge_client.lua | Détection du framework, Bridge.Notify, Bridge.ShowHelpNotification, callbacks, et chaque interaction : cibles d’entité, zone et modèle pour ox_target, qb-target, ou la boucle drawtext native |
bridge/bridge_server.lua | Détection du framework, joueurs, liquide et banque, noms de personnages et AddItem / HasItem / RemoveItem / RegisterUsableItem via fmLib |
Autre ressource de notifications : modifiez Bridge.Notify dans les deux fichiers.
Autre système de target : les trois fonctions Add…Interaction et leurs contreparties Remove… dans bridge_client.lua sont les seuls endroits où le target est manipulé.
Autre framework : le bloc de détection en haut de chaque fichier et les fonctions d’argent, de joueur et de nom constituent l’essentiel. Les items ne dépendent pas du framework — ils passent par fmLib.
Comptes financiers. Les entrepôts sont payés en cash ou bank (au choix de l’acheteur) ; les achats et transactions sur le portable utilisent bank. Sur ESX, cash correspond à l’argent liquide du joueur et bank à son compte bancaire.