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.

Quel fichier gère quoi

Fichier ou dossier	Ce qu’il gère	Ouvert ?
`config.lua`	Tous les paramètres de cette page et la liste des vapes	Ouvert
`locales/*.lua`	Textes des notifications, un fichier par langue	Ouvert
`bridge/client_bridge.lua`	Détection du framework côté client, notifications, barre de progression et ce que fait chaque effet	Ouvert
`bridge/server_bridge.lua`	Détection du framework côté serveur, retrait d’une vape vide, vérification d’inventaire et hook de stress `OnVapePuff`	Ouvert
`bridge/stress.lua`	Ancienne copie du hook de stress. Non chargée par le manifest ; modifiez `server_bridge.lua` à la place	Ouvert
`client/client.lua`	Sortir la vape, la bouffée, la fumée et sa synchronisation	Escrow
`server.lua`	Enregistre chaque vape comme item utilisable et relaie la fumée	Escrow
`html/`	La barre de progression : `index.html`, `style.css`, `script.js`	Fichiers non chiffrés
`stream/`	Les dix modèles de vapes et `def_props.ytyp`	Assets
`inventory_items/`	Définitions d’items prêtes à l’emploi pour ESX, ox_inventory et QBCore	Référence
`inventory_images/`	Une icône par item	Assets

Paramètres généraux

Option	Ce qu’elle fait	Valeur par défaut
`Config.Locale`	Langue des notifications	`en`
`Config.ShowNotifications`	Afficher les notifications. Désactivé signifie aucun message « sortie », « en recharge », « vide » ou de pouvoirs	`false`
`Config.EnableMaxPuffs`	Les vapes s’épuisent après leur nombre de `puffs`	`true`
`Config.RemoveVapeCommand`	Commande de chat pour ranger la vape	`vape`
`Config.PuffKey`	Touche par défaut pour tirer une bouffée	`E`
`Config.DisableCombatButtons`	Bloque les boutons de combat (attaque et visée) pendant que la fumée sort	`true`
`Config.Stress`	Appelle 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.

Santé, armure et vitesse

Option	Ce qu’elle fait	Valeur par défaut
`Config.SpeedVapeInfiniteStamina`	L’endurance ne s’épuise pas pendant l’effet de vitesse	`true`
`Config.StaticHealth`	`false` : chaque bouffée de santé ajoute `Config.Health`. `true` : une bouffée augmente la santé jusqu’à `Config.Health` si elle est inférieure	`false`
`Config.Health`	Montant ajouté, ou niveau cible à atteindre. Avec le paramètre statique, utilisez 101–200, l’échelle de santé du jeu	`10`
`Config.StaticArmor`	Même principe pour l’armure : ajouter, ou fixer au niveau	`false`
`Config.Armor`	Montant ajouté, ou niveau cible à atteindre (jusqu’à 100)	`10`

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

Fumée

Option	Ce qu’elle fait	Valeur par défaut
`Config.VapeExhale`	Taille de la particule de fumée	`0.4`
`Config.SmokeOpacity`	Densité de la fumée, de `0.0` à `1.0`	`1.0`
`Config.SmokeDelay`	Secondes entre l’animation de la bouffée et l’apparition de la fumée	`1.5`
`Config.Particle`	Particule utilisée : un `dict` et un `name`. Livré avec la fumée de crissement de pneus de `scr_recartheft`	`scr_recartheft` / `scr_wheel_burnout`
`Config.SmokeOffset`	Position de départ de la fumée par rapport à la tête : `PosX`, `PosY`, `PosZ`, `RotX`, `RotY`, `RotZ`	`0.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.

Les vapes — `Config.Vapes`

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

Champ	Ce qu’il fait
`prop`	Modèle tenu en main : `mic_black`, `mic_blue`, `mic_green`, `mic_lightblue`, `mic_orange`, `mic_pink`, `mic_purple`, `mic_red`, `mic_white`, `mic_yellow`
`Label`	Nom affiché sur la barre de progression
`SmokeColor`	Une couleur `R`, `G`, `B`, ou le mot `Rainbow` pour des couleurs changeantes
`Cooldown`	Secondes avant de pouvoir tirer une nouvelle bouffée sur cette vape
`puffs`	Nombre de bouffées avant épuisement et retrait de l’inventaire
`EffectDuration`	Secondes de durée du pouvoir. `0` pour les saveurs
`ShowProgress`	Afficher la barre de progression pendant la durée de l’effet. Désactivé sur toutes les vapes livrées
`SpeedMultiplier`	Pour `speed_vape` (sprint) et `carspeed_vape` (moteur) uniquement
`power`	Optionnel. Une liste d’effets à exécuter ensemble, chacun avec sa propre valeur (voir ci-dessous)

Quel effet a une vape

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.

Combiner des effets avec `power`

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.

Ajouter une vape

Copiez une entrée existante dans Config.Vapes et donnez-lui un nouveau nom d’item.
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.
Ajoutez l’item à votre inventaire de la même manière que les autres, avec une icône.
Exécutez refresh, puis restart mic_vape.

Effets supplémentaires reconnus par le bridge

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.

Stress

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.

Langues

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.

Le bridge

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

Fichier	Ce qu’il faut y modifier
`bridge/client_bridge.lua`	`ShowNotification` — 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.lua`	`OnVapePuff` 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.

Commandes et touches

Commande ou touche	Ce qu’elle fait	Configuré dans
Utiliser l’item	Sort la vape ; l’utiliser à nouveau la range	Inventaire
E (« Vape Puff »)	Tire une bouffée	`Config.PuffKey`, puis les raccourcis de chaque joueur
`/vape`	Range la vape	`Config.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.