Configuration

Toute la configuration de lo_balloon se trouve dans config.lua (script partagé). Ce fichier est ignoré par l'escrow, vous pouvez donc l'éditer librement. Cette page décrit les principales options.

Options principales

Option	Type	Défaut	Description
Config.Lang	string	"fr"	Langue active. Valeurs : en, fr, pt_br, de, ru.
Config.Command	string	"balloon"	Commande staff pour faire apparaître une montgolfière gratuitement.
Config.Model	table	{ "hotairballoon01", ... }	Modèles de montgolfière reconnus (le premier sert au spawn).
Config.DummyObject	string	"p_ambfloorscrub01x"	Objet invisible servant à stabiliser la synchro réseau.
Config.SpawnOffset	number	5.0	Décalage de spawn.
Config.SpeedBase	number	0.05	Vitesse de déplacement de base.
Config.SpeedSprint	number	0.15	Vitesse en sprint.
Config.ControlTickMs	number	25	Intervalle (ms) de la boucle de contrôle.
Config.AutoEnterAsDriver	bool	false	Entrer automatiquement comme pilote.
Config.MaxPassengers	number	3	Nombre maximum de passagers.
Config.BoardingRange	number	4.0	Portée d'embarquement (m).
Config.BoardingKey	string	"INPUT_LOOK_BEHIND"	Touche d'embarquement (C par défaut sur PC).
Config.RentalSpawnClearRadius	number	5.0	Rayon (m) empêchant un 2ᵉ spawn au même endroit.
Config.ShowPrompts	bool	true	Affiche les prompts d'aide en bas à droite.

Pilotage

Le pilotage repose sur deux vitesses et une série d'options visuelles.

Config.SpeedBase   = 0.05   -- vitesse de déplacement normale
Config.SpeedSprint = 0.15   -- vitesse en maintenant la touche sprint

Config.PilotAnimation = true   -- animation du pilote (chaîne)
Config.PilotRope      = true   -- corde reliant le pilote
Config.RopeLength     = 0.7
Config.SyncRope       = true   -- synchronise la corde pour les autres joueurs

Les touches de pilotage sont définies dans Config.Inputs :

Action	Contrôle	Valeur par défaut
Avancer	Forward	INPUT_VEH_MOVE_UP_ONLY
Reculer	Backward	INPUT_VEH_MOVE_DOWN_ONLY
Gauche	Left	INPUT_VEH_MOVE_LEFT_ONLY
Droite	Right	INPUT_VEH_MOVE_RIGHT_ONLY
Monter (chaîne)	Throttle	INPUT_VEH_FLY_THROTTLE_UP
Ralentir	Brake	INPUT_CONTEXT_X
Bloquer l'altitude	LockAltitude	INPUT_CONTEXT_A
Sprint	Sprint	INPUT_VEH_TRAVERSAL
Caméra orbitale	Camera	INPUT_VEH_HEADLIGHT

Caméra orbitale (optionnelle)

La caméra orbitale n'est pas forcée : le joueur garde la caméra par défaut du jeu (et peut passer en vue subjective). Il bascule vers la caméra à distance uniquement en appuyant sur la touche caméra.

Config.PilotCam       = true
Config.PilotCamOffset = { x = 0.0, y = -8.0, z = 4.0 } -- (derrière, au-dessus)

TIP

Si l'icône de la touche caméra (INPUT_VEH_HEADLIGHT) ne vous convient pas, remappez Config.Inputs.Camera sur un autre contrôle.

Passagers

Une montgolfière accueille jusqu'à Config.MaxPassengers passagers. L'embarquement se fait à la touche Config.BoardingKey lorsque le joueur est à moins de Config.BoardingRange mètres. Les positions de placement sont définies par les offsets ci-dessous.

Config.MaxPassengers = 3
Config.BoardingRange = 4.0
Config.BoardingKey   = "INPUT_LOOK_BEHIND" -- C par défaut sur PC

Config.PassengerOffsets = {
    {x =  0.55, y = -0.45, z = 0.5},
    {x = -0.55, y = -0.45, z = 0.5},
    {x =  0.00, y =  0.45, z = 0.5},
}

NOTE

Prévoyez autant d'offsets que de MaxPassengers afin que chaque passager dispose d'une position de placement.

Points de location (Config.Rentals)

Config.Rentals est une liste de points de location. Chaque entrée décrit :

Clé	Description
npc.model	Modèle du PNJ loueur.
npc.coords	vec4(x, y, z, heading) — position et orientation du PNJ.
spawn	vec3(x, y, z) — endroit où la montgolfière apparaît à la location.
price	Prix en liquide à payer.
range	Rayon 3D (m) autour du PNJ pour louer/rendre la montgolfière.

Exemple (point de Strawberry) :

Config.Rentals = {
    { -- strawberry
        npc = {
            model  = "A_M_M_UniBoatCrew_01",
            coords = vec4(-1831.70, -596.88, 154.55, 287.23),
        },
        spawn = vec3(-1821.89, -599.09, 154.71),
        price = 15,
        range = 2.0,
    },
    -- Ajoutez d'autres points de location ici :
    -- {
    --     npc   = { model = "...", coords = vec4(x, y, z, h) },
    --     spawn = vec3(x, y, z),
    --     price = 50,
    --     range = 2.5,
    -- },
}

La ressource fournit par défaut 6 points de location (Strawberry, Annesburg, Armadillo, le nord, etc.), tous au prix de 15 et avec un range de 2.0.

TIP

Un range de 2.0 à 4.0 est généralement idéal : assez large pour rester tolérant sur un terrain irrégulier, mais pas trop pour éviter les déclenchements accidentels.

Un blip de carte peut être affiché pour chaque point :

Config.RentalBlip = {
    sprite = -1595467349,
    scale  = 0.2,
}
-- Mettre Config.RentalBlip = nil pour désactiver les blips.

Langues

La langue active est définie par Config.Lang. Les traductions se trouvent dans Config.Translations, qui inclut par défaut :

Code	Langue
en	Anglais
fr	Français
pt_br	Portugais (Brésil)
de	Allemand
ru	Russe

Config.Lang = "fr"

Pour ajouter une langue, créez une nouvelle entrée dans Config.Translations en reprenant les mêmes clés (Title, Rent, Return, Board, etc.) puis renseignez Config.Lang avec son code.

Conseils

• Commande staff — Config.Command (défaut "balloon") est réservée aux groupes admin et modo et permet un spawn gratuit pour les tests. Renommez-la ou laissez-la dédiée au staff.
• Anti-superposition — Config.RentalSpawnClearRadius empêche qu'une seconde montgolfière apparaisse sur une qui occupe déjà le point de spawn.
• Modèles — Le premier modèle de Config.Model sert au spawn ; les autres servent à reconnaître les montgolfières déjà présentes.
• Vérification de version — Config.VersionCheck compare au démarrage la version locale à celle du dépôt GitHub. Passez enabled à false pour la désactiver.