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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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.
| 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « Ajouter une vape »- Copiez une entrée existante dans
Config.Vapeset donnez-lui un nouveau nom d’item. - Choisissez un
prop, une couleurSmokeColor, un nombre depuffset unCooldown. Pour un pouvoir, utilisez l’un des noms d’effets ci-dessus comme nom d’item ou ajoutez une listepower. - Ajoutez l’item à votre inventaire de la même manière que les autres, avec une icône.
- Exécutez
refresh, puisrestart mic_vape.
Effets supplémentaires reconnus par le bridge
Section intitulée « 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.
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.
Le bridge
Section intitulée « 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
Section intitulée « 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.