Installation

kp_planesmoke v1.0.0. Trois traînées de fumée sur un avion, une couleur par traînée : aile gauche, centre, aile droite. Chaque pilote règle ses couleurs, la taille, et déplace les points sur son appareil, add-on compris. Tout le monde voit la fumée, le serveur valide tout. Avec ESX, QBCore ou sans framework.

Ce qu'il te faut
FXServer récent, avec Lua 5.4 obligatoire
OneSync obligatoire
ESX Legacy ou QBCore facultatif : accès par métier, nom RP dans les logs
ox_inventory, inventaire ESX ou qb-inventory facultatif : accès par item
ox_lib facultatif : notifications ox_lib
Webhook Discord facultatif

Aucune autre ressource n'est imposée : le panneau et les notifications sont livrés avec le script.

Installer en 4 étapes

  1. Vérifie que OneSync est activé sur ton serveur.
  2. Place le dossier kp_planesmoke dans resources/, sans le renommer, puis ajoute dans server.cfg (après ESX ou QBCore si tu en utilises un) :
ensure kp_planesmoke
  1. Choisis qui peut utiliser la fumée dans config.lua :
Config.Access = {
    Mode = 'everyone',   -- 'everyone', 'ace', 'job' ou 'item'
    Ace = 'kp_planesmoke.use',
    Jobs = { pilot = 0 },
    Item = 'smoke_kit',
    Identifiers = {},    -- ex. { 'license:xxxx', 'discord:1234' }
}

Par défaut, tout pilote d'avion y a droit : c'est un cosmétique. En mode 'ace', ajoute add_ace group.pilot kp_planesmoke.use allow dans server.cfg. En mode 'item', ajoute l'item avec le fichier de install/ qui correspond à ton inventaire.

  1. Redémarre le serveur, monte dans un avion moteur allumé, puis tape /smokeplane.

Les commandes

Commande Ce qu'elle fait
/smokeplane Allume ou éteint la fumée. À bord d'un avion, place pilote, moteur allumé
/smokeplaneconfig Ouvre le panneau : emplacements, couleurs, taille, position des points
Touche Même effet que /smokeplane. Aucune touche imposée, chaque joueur choisit la sienne dans Paramètres, Touches, FiveM

/smoke est volontairement évité : la plupart des serveurs l'ont déjà pour les cigarettes. Les noms se changent dans Config.Commands.

La fumée s'éteint toute seule quand le pilote quitte l'appareil, change de siège, coupe le moteur, ou quand l'appareil est détruit.

Fichiers ouverts

config.lua, locales/, bridge/, html/, install/, README et LICENSE restent ouverts : tu règles tout, tu changes les textes, tu branches ton framework, ton inventaire ou tes notifications. Le reste du code est protégé par l'escrow Cfx.re.

Pour les couleurs, les add-ons et les notifications : Configuration. Pour les exports et la mise à jour : Développeurs.