Aller au contenu

Personnalisation

Le comportement est défini dans config.lua. Tout ce qui touche à votre framework, vos notifications ou à ce que fait réellement un effet se trouve dans le dossier bridge/, qui reste ouvert précisément pour cette raison.


Fichier ou dossierCe qu’il gèreOuvert ?
config.luaTous les paramètres de cette page et la liste des vapesOuvert
locales/*.luaTextes des notifications, un fichier par langueOuvert
bridge/client_bridge.luaDétection du framework côté client, notifications, barre de progression et ce que fait chaque effetOuvert
bridge/server_bridge.luaDétection du framework côté serveur, retrait d’une vape vide, vérification d’inventaire et hook de stress OnVapePuffOuvert
bridge/stress.luaAncienne copie du hook de stress. Non chargée par le manifest ; modifiez server_bridge.lua à la placeOuvert
client/client.luaSortir la vape, la bouffée, la fumée et sa synchronisationEscrow
server.luaEnregistre chaque vape comme item utilisable et relaie la fuméeEscrow
html/La barre de progression : index.html, style.css, script.jsFichiers non chiffrés
stream/Les dix modèles de vapes et def_props.ytypAssets
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

OptionCe qu’elle faitValeur par défaut
Config.LocaleLangue des notificationsen
Config.ShowNotificationsAfficher les notifications. Désactivé signifie aucun message « sortie », « en recharge », « vide » ou de pouvoirsfalse
Config.EnableMaxPuffsLes vapes s’épuisent après leur nombre de puffstrue
Config.RemoveVapeCommandCommande de chat pour ranger la vapevape
Config.PuffKeyTouche par défaut pour tirer une boufféeE
Config.DisableCombatButtonsBloque les boutons de combat (attaque et visée) pendant que la fumée sorttrue
Config.StressAppelle le hook de stress à chaque bouffée (voir Stress)true

Config.PuffKey est une valeur par défaut. La bouffée est un raccourci clavier FiveM nommé « Vape Puff », chaque joueur peut donc le modifier sous Paramètres › Raccourcis clavier › FiveM. Une fois qu’un joueur a enregistré sa touche, modifier Config.PuffKey ne l’affecte plus.


OptionCe qu’elle faitValeur par défaut
Config.SpeedVapeInfiniteStaminaL’endurance ne s’épuise pas pendant l’effet de vitessetrue
Config.StaticHealthfalse : chaque bouffée de santé ajoute Config.Health. true : une bouffée augmente la santé jusqu’à Config.Health si elle est inférieurefalse
Config.HealthMontant ajouté, ou niveau cible à atteindre. Avec le paramètre statique, utilisez 101–200, l’échelle de santé du jeu10
Config.StaticArmorMême principe pour l’armure : ajouter, ou fixer au niveaufalse
Config.ArmorMontant ajouté, ou niveau cible à atteindre (jusqu’à 100)10

La santé est toujours maintenue entre 100 et 200, l’armure à 100 ou moins.


OptionCe qu’elle faitValeur par défaut
Config.VapeExhaleTaille de la particule de fumée0.4
Config.SmokeOpacityDensité de la fumée, de 0.0 à 1.01.0
Config.SmokeDelaySecondes entre l’animation de la bouffée et l’apparition de la fumée1.5
Config.ParticleParticule utilisée : un dict et un name. Livré avec la fumée de crissement de pneus de scr_recartheftscr_recartheft / scr_wheel_burnout
Config.SmokeOffsetPosition de départ de la fumée par rapport à la tête : PosX, PosY, PosZ, RotX, RotY, RotZ0.05, 0.0, 0.5, 0, 0, 0

Chaque nuage dure 1,5 seconde et est visible par les joueurs à moins de 30 mètres.


Chaque entrée associe un nom d’item → paramètres. La liste complète livrée est disponible sur 🎒 Items.

ChampCe qu’il fait
propModèle tenu en main : mic_black, mic_blue, mic_green, mic_lightblue, mic_orange, mic_pink, mic_purple, mic_red, mic_white, mic_yellow
LabelNom affiché sur la barre de progression
SmokeColorUne couleur R, G, B, ou le mot Rainbow pour des couleurs changeantes
CooldownSecondes avant de pouvoir tirer une nouvelle bouffée sur cette vape
puffsNombre de bouffées avant épuisement et retrait de l’inventaire
EffectDurationSecondes de durée du pouvoir. 0 pour les saveurs
ShowProgressAfficher la barre de progression pendant la durée de l’effet. Désactivé sur toutes les vapes livrées
SpeedMultiplierPour speed_vape (sprint) et carspeed_vape (moteur) uniquement
powerOptionnel. Une liste d’effets à exécuter ensemble, chacun avec sa propre valeur (voir ci-dessous)

Le nom de l’item détermine l’effet. invisibility_vape vous rend invisible car elle s’appelle invisibility_vape ; tout autre nom sans liste power est considéré comme une saveur.

Les noms d’effets reconnus par le bridge : invisibility_vape, speed_vape, superjump_vape, teleport_vape, invincibility_vape, health_vape (ou health), armor_vape (ou armor), carspeed_vape, freeze_vape, gravity_vape — ainsi que random_vape, qui choisit l’un des autres au hasard.

Attribuez une liste power à une vape et elle exécutera tous les effets qu’elle contient à chaque bouffée, quel que soit le nom de la vape. Le chiffre associé à chaque effet correspond à sa durée en secondes, sauf pour health et armor où il s’agit du montant. vape_custom dans la config en est un exemple fonctionnel : santé 10, armure 10, vitesse pendant 10 secondes.

  1. Copiez une entrée existante dans Config.Vapes et donnez-lui un nouveau nom d’item.
  2. Choisissez un prop, une couleur SmokeColor, un nombre de puffs et un Cooldown. Pour un pouvoir, utilisez l’un des noms d’effets ci-dessus comme nom d’item ou ajoutez une liste power.
  3. Ajoutez l’item à votre inventaire de la même manière que les autres, avec une icône.
  4. Exécutez refresh, puis restart mic_vape.

freeze_vape (impossible de bouger) et gravity_vape (faible gravité, mouvements ralentis) sont pris en charge dans bridge/client_bridge.lua, et leurs définitions d’items sont déjà dans inventory_items/, mais elles n’ont pas d’entrée dans Config.Vapes. Ajoutez une entrée pour chacune — copiez superjump_vape et renommez-la — et elles fonctionneront.

transform_vape figure également dans les fichiers d’items, mais nécessite une liste Config.TransformAnimals absente de la configuration de base. Laissez-la de côté à moins d’être prêt à définir cette liste et à la tester.


Avec Config.Stress = true, chaque bouffée appelle OnVapePuff dans bridge/server_bridge.lua avec l’ID serveur du joueur. Par défaut, cette fonction n’affiche qu’une ligne dans la console du serveur. Des exemples commentés pour les métadonnées QBCore et pour esx_status y sont inclus : décommentez celui qui convient, ou appelez-y votre propre ressource de HUD ou de stress.

Si vous n’utilisez pas de système de stress, définissez Config.Stress = false et la console restera silencieuse.


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

La ligne car_speed — affichée lorsque la vape de vitesse de véhicule s’active — indique « No waypoint set! » dans les fichiers livrés. Reformulez-la dans votre fichier de langue.

Pour ajouter une langue : copiez locales/en.lua, remplacez la clé en haut par votre code, traduisez, et ajoutez le fichier à la fois dans client_scripts et server_scripts dans fxmanifest.lua. Définissez Config.Locale, faites refresh et redémarrez.


Tout ce qui dépend de votre serveur se trouve dans bridge/.

FichierCe qu’il faut y modifier
bridge/client_bridge.luaShowNotification — redirigez les messages vers votre propre ressource de notification. Le code des effets — modifiez ce que fait un pouvoir, ou ajoutez un nouveau nom d’effet. ShowProgressBar / HideProgressBar pour la barre
bridge/server_bridge.luaOnVapePuff pour le stress. Retrait d’une vape vide et vérification si le joueur porte toujours l’item — adaptez ces deux fonctions pour un inventaire qui ne passe pas par les fonctions d’items propres à ESX ou QBCore

Les deux fichiers détectent le framework de la même manière : es_extended s’il est démarré, sinon qb-core — c’est également ainsi que QBox est détecté, via sa compatibilité QBCore. Pour un autre framework, ajoutez une branche ici et dans les deux fonctions d’items associées.


Commande ou toucheCe qu’elle faitConfiguré dans
Utiliser l’itemSort la vape ; l’utiliser à nouveau la rangeInventaire
E (« Vape Puff »)Tire une boufféeConfig.PuffKey, puis les raccourcis de chaque joueur
/vapeRange la vapeConfig.RemoveVapeCommand

Une vape est également rangée lorsque le joueur ne possède plus l’item ; la ressource effectue une vérification toutes les 2,5 secondes.