Aller au contenu

Personnalisation

Les paramètres se trouvent dans config.lua. Les fichiers qui communiquent avec votre framework, votre inventaire et votre ressource de target sont laissés ouverts, de sorte qu’un serveur qui fonctionne différemment puisse les adapter sans toucher au cœur sous escrow.


Fichier ou dossierCe qu’il décideOuvert ?
config.luaChaque paramètre de cette page, la fonction de notification, les items et les saveursOuvert
locales/*.luaTous les textes : menu, libellés du target, messages. Un fichier par langueOuvert
server_functions.luaObtenir un joueur, ajouter, retirer et vérifier des items, enregistrer les items utilisables, le callback des saveurs, et ReduceStressOuvert
client/client_functions.luaLecture des données du joueur, et vérification du job pour le menu de configurationOuvert
target/target.luaToutes les options de target sur les chichas et les meubles, pour ox_target et qb-targetOuvert
client/client.lua, server/server.lua, locale.luaPlacement, tuyau, fumée, propriété et fournituresSous escrow
html/Le menu de configuration : index.html, style.css, script.jsFichiers en clair
inventory_items/Définitions d’items prêtes à l’emploi pour ESX, ox_inventory et QBCoreRéférence
inventory_images/Une icône par itemAssets
mic_hookah_prop/stream/Les dix modèles de chichasAssets, ressource séparée

OptionCe qu’elle faitPar défaut
Config.LocaleLangueen
Config.Frameworkesx, qbcore ou qboxesx
Config.ESXResourceNameNom de dossier d’ESXes_extended
Config.QBResourceNameNom de dossier de QBCoreqb-core
Config.QBoxResourceNameNom de dossier de QBoxqbx_core
Config.Targetox_target ou qb-targetox_target
Config.QBTargetResourceNameNom de dossier de qb-targetqb-target
Config.InventoryImagePathD’où le menu charge les icônes des saveursnui://ox_inventory/web/images/

OptionCe qu’elle faitPar défaut
Config.AdminGroupsGroupes autorisés à ouvrir le menu et ramasser n’importe quelle chicha ou meuble. false signifie que tout le monde est adminfalse
Config.AllowedJobsJobs autorisés à ouvrir le menu de configuration. false signifie n’importe quel jobfalse

Par défaut, n’importe qui peut gérer la chicha de n’importe qui. Pour que chaque chicha appartienne au joueur qui l’a posée, listez vos groupes de staff dans Config.AdminGroups — par exemple admin et superadmin. Sur ESX, la liste est comparée au groupe du joueur ; sur QBCore et QBox, au champ permission du joueur.

Avec une liste configurée :

QuiOpen Setup MenuRamasserGrab Hose
Le joueur qui l’a poséeoui (si son job est autorisé)ouioui
Un groupe adminoui (si son job est autorisé)ouioui
N’importe qui d’autrenonnonoui

Config.AllowedJobs ne protège que le menu de configuration. N’importe qui peut attraper le tuyau et fumer une chicha allumée.


OptionCe qu’elle faitPar défaut
Config.MaxActiveTimeCe que signifie « plein » pour le charbon et l’eau. Un hookah_coal ou hookah_water le remplit à cette valeur1800
Config.ConsumptionPerPuffQuantité retirée au charcoal et à l’eau (water) par bouffée10 et 10
Config.MaxPuffsPerSessionCalculé à partir des deux valeurs ci-dessus (1800 ÷ 10 = 180). Donné pour référence ; le script ne le lit pas180
Config.MaxHoseDistanceDistance en mètres avant que le tuyau ne se rompe3.5
Config.MaxSimultaneousUsersLimite prévue de personnes fumant sur la même chicha4
Config.StressAppelle ReduceStress à chaque boufféetrue

La chicha ne se consume pas avec le temps : le charbon et l’eau diminuent uniquement lorsque quelqu’un tire une bouffée. Lorsque l’un ou l’autre tombe à zéro, la chicha s’éteint et nécessite une recharge.

ReduceStress dans server_functions.lua reçoit l’ID serveur du joueur à chaque bouffée lorsque Config.Stress est activé. Il est livré vide, avec des exemples commentés : un événement client, un export ou un événement serveur de votre ressource de stress ou de HUD. Placez votre appel à cet endroit.


OptionCe qu’elle faitPar défaut
Config.ParticleParticule utilisée : un dict et un namescr_recartheft / scr_wheel_burnout
Config.VapeExhaleTaille de la fumée0.5

La configuration signale ces deux paramètres par « ne modifiez pas à moins de savoir ce que vous faites ». Chaque nuage dure trois secondes et est visible par les joueurs situés à moins de 150 mètres.


Les listes complètes se trouvent sur 🎒 Items.

Config.HookahItems — nom de l’item → modèle. Pour ajouter une chicha, le modèle doit être streamé (par exemple dans mic_hookah_prop/stream/ avec une entrée dans son .ytyp), puis ajoutez la ligne ici et l’item dans votre inventaire.

Config.PlaceableProps — nom de l’item → propModel, type (furniture) et isChair. Tout prop du jeu de base fonctionne. Définissez isChair = true pour tout élément devant proposer Sit Down.

Config.Flavors — nom de l’item → paramètres :

ChampCe qu’il fait
LabelNom affiché dans le menu de configuration
SmokeColorCouleur R, G, B de la fumée
ScreenEffectNom d’un effet d’écran GTA appliqué au fumeur, ou false pour aucun
EffectDurationDurée en secondes de l’effet d’écran

La configuration fournit un lien vers une liste d’effets d’écran à côté de Config.Flavors. Pour ajouter une saveur, copiez une entrée, donnez-lui un nouveau nom d’item, puis ajoutez l’item et son icône dans votre inventaire.


Config.Notify dans config.lua envoie chaque message : ShowNotification sur ESX, Functions.Notify sur QBCore et QBox, la console sinon. Remplacez son contenu pour utiliser votre propre ressource de notifications.


Onze fichiers sont fournis dans locales/ : en, es, fr, de, it, pt, ru, cn, nl, pl, tr. Choisissez-en un avec Config.Locale.

Le commentaire au-dessus de Config.Locale mentionne également jp, mais aucun fichier japonais n’est fourni ; le définir affichera « Locale [jp] does not exist ».

Chaque fichier couvre le menu de configuration, les libellés du target et les messages. Quelques mots sont codés en dur dans le Lua plutôt que dans les fichiers de langue : les indications de placement (Rotate Right, Rotate Left, Height Up, Height Down, Place Prop, Cancel), « You are already placing an object », et « None » pour une saveur vide.

Pour ajouter une langue : copiez locales/en.lua, remplacez la clé au début par votre code et traduisez. Le manifest charge automatiquement tout ce qui se trouve dans locales/, il n’y a donc rien d’autre à déclarer. Définissez Config.Locale, faites refresh et redémarrez.


Pour modifierÉditer
Un framework sur mesureL’objet de framework au bas de config.lua, ainsi que les fonctions dans server_functions.lua et client/client_functions.lua
Un inventaire différentAddItem, RemoveItem et HasItem dans server_functions.lua, et l’enregistrement des items utilisables en dessous
Un target différenttarget/target.lua — les listes d’options sont partagées, seuls les deux appels addModel / AddTargetModel diffèrent
Libellés, icônes ou distance targettarget/target.lua pour les icônes et la distance, locales/ pour les libellés
Règles des jobsCheckJobAccess dans client/client_functions.lua

Sur QBCore et QBox avec ox_inventory démarré, server_functions.lua enregistre également chaque item de chicha et de meuble via le hook d’utilisation propre à ox_inventory, servant de recours de secours pour les configurations où le bridge d’items de QBCore ne relaie pas l’utilisation.


Touche ou commandeQuandCe qu’elle fait
EEn tenant une chichaCommence le placement
XEn tenant une chichaRange sans placer
Molette de la sourisPendant le placementFait pivoter l’aperçu
Flèche haut / basPendant le placementMonte ou descend l’aperçu
EPendant le placementPose l’objet
XPendant le placementAnnule
EEn tenant le tuyau d’une chicha alluméeTire une bouffée
X (“Hookah - Stand Up X”)En étant assisSe relever. Modifiable dans les assignations de touches FiveM
/hookah:chair:stand_upEn étant assisIdentique, sous forme de commande