Exports et événements

MasterLadder expose des exports et des événements pour que vos autres scripts (dispatch, HUD, scripts de feu, métiers…) sachent ce qui se passe sur les échelles. Le nom de la ressource doit rester MasterLadder.

Unités : angles en degrés, distances en mètres. Une échelle est identifiée par le netId de son véhicule.

Places

Code	Place
`seat`	Poste de commande (tourelle)
`b1`, `b2`, `b3`	Places de la nacelle
`c1`, `c2`	Sur l'échelle (montée à pied)

État d'une échelle (`GetLadderState`)

Les deux côtés renvoient la même table (ou nil si l'échelle n'est pas déployée) :

Champ	Contenu
`netId`, `model`, `label`	Véhicule, clé dans `Config.Ladders`, nom affiché
`phase`	calage automatique : `"deploy"` (calage), `"ready"` (manœuvrable), `"pack"` (repli) · calage manuel : `"setup"` (stabilisateurs au pupitre), `"unfold"` (dépliage), `"ready"`, `"fold"` (repli de la nacelle), `"abort"` (abandon, rangement automatique)
`calage`	`"full"`, `"reduced"`, `"left"` (gauche réduit) ou `"right"` (droit réduit)
`rotation`, `elevation`, `length`, `arm`	Position de l'échelle (°, °, m de longueur totale, °)
`basket`	Position de la nacelle (`vector3`)
`reach`, `maxReach`	Déport actuel et déport maximal de l'abaque (m)
`load`	Personnes comptées dans la charge
`occupants`	`{ seat = id, b1 = id, … }` (0 = libre)
`operator`	ID serveur de l'opérateur aux commandes (0 = personne)
`basketLocked`, `spotlight`	Verrou de nacelle, projecteur
`monitor`	`{ holder, flowing, yaw, pitch }` (+ `impact` côté client)

Côté client s'ajoutent vehicle (entité) et height (hauteur de la nacelle au-dessus du sol).

Exports client

local ml = exports['MasterLadder']

Export	Retour
`ml:GetPlace()`	`netId, place` du joueur, ou `nil`
`ml:IsInLadder()`	Le joueur occupe une place
`ml:IsInBasket()` / `ml:IsClimbing()` / `ml:IsAtSeat()`	Nacelle / sur l'échelle / au poste
`ml:IsOperator()`	Le joueur a les commandes
`ml:IsHoldingMonitor()`	Le joueur tient la lance
`ml:IsLadderVehicle(veh)`	Ce véhicule est une échelle configurée
`ml:IsDeployed(veh)`	Cette échelle est déployée
`ml:GetLadderState(netId)`	Table d'état (échelles affichées chez ce joueur)
`ml:GetBasketCoords(netId)`	Position de la nacelle
`ml:IsWaterFlowing(netId)`	La lance débite
`ml:GetWaterImpact(netId)`	Point d'impact du jet (`vector3`)
`ml:GetNearestLadder(range)`	`netId, distance` de l'échelle déployée la plus proche (défaut 50 m)
`ml:GetVisibleLadders()`	Liste des netId des échelles affichées

Exemple : couper un HUD de vitesse dans la nacelle.

CreateThread(function()
    while true do
        Wait(500)
        local inBasket = exports['MasterLadder']:IsInBasket()
        -- masquer / afficher votre HUD ici
    end
end)

Exports serveur

Export	Retour
`IsDeployed(netId)`	L'échelle est déployée
`GetLadderState(netId)`	Table d'état
`GetDeployedLadders()`	Liste des netId déployés
`GetBasketCoords(netId)`	Position de la nacelle
`GetPlayerPlace(src)`	`netId, place` du joueur, ou `nil`
`GetOccupants(netId)`	`{ place = src }` des places occupées
`IsWaterFlowing(netId)`	La lance débite
`EjectPlayer(src)`	Fait descendre le joueur de sa place (`true` si fait)
`EvictLadder(netId)`	Vide toutes les places et rend les commandes
`StopWater(netId)`	Ferme le jet (le porteur peut le rouvrir)

Événements serveur

À écouter avec AddEventHandler dans une ressource serveur :

Événement	Paramètres	Quand
`masterladder:deployed`	`netId, src, calage`	Déploiement lancé (`"full"` / `"reduced"` ; `"manual"` au début d'un calage manuel)
`masterladder:ready`	`netId`	Calage terminé
`masterladder:packing`	`netId, src`	Repli lancé
`masterladder:packed`	`netId`	Échelle rangée
`masterladder:ptoChanged`	`netId, src, engagée`	Prise de force engagée / désengagée
`masterladder:placeChanged`	`netId, src, place`	Place prise, ou quittée (`place = nil`)
`masterladder:controlChanged`	`netId, src`	Opérateur aux commandes (0 = personne)
`masterladder:monitorChanged`	`netId, src`	Porteur de la lance (0 = personne)
`masterladder:waterChanged`	`netId, src, ouvert`	Jet ouvert / fermé
`masterladder:waterImpact`	`netId, src, coords`	Impact du jet, 2 fois par seconde

Brancher un script de feu

-- server.lua de votre script de feu
AddEventHandler('masterladder:waterImpact', function(netId, src, coords)
    -- éteindre / affaiblir vos feux autour de coords (rayon ~3 m)
    MonScriptDeFeu.DamageAt(coords, 3.0, 25.0, src)
end)

Événements client

Événement	Paramètres	Quand
`masterladder:client:placeChanged`	`netId, place`	Ma place change (`nil, nil` quand je descends)
`masterladder:client:waterImpact`	`coords, rayon`	Impact du jet près de moi (feux éteints localement)