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.