🚗Module Vehicle (Client)

Le module Eko.Vehicle permet de gérer les véhicules côté client. Il fournit des méthodes pour récupérer, enregistrer, synchroniser et manipuler les véhicules, ainsi que des sous-modules dédiés aux pro

📦 API principale

Eko.Vehicle:Get(id)

Récupère une instance sérialisée d’un véhicule par son ID.

• Paramètres

  • id (integer): Identifiant unique du véhicule.

• Retour

  • VehicleInstance: L’instance sérialisée.

---

Eko.Vehicle:GetFromEntity(entity)

Récupère une instance véhicule à partir d’un handle entity.

• Paramètres - entity (integer): Handle de l’entité.

• Retour - VehicleInstance: L’instance sérialisée.

---

Eko.Vehicle:DoesHaveValidPlate(entity)

Vérifie si le véhicule possède une plaque valide.

• Paramètres

  • entity (integer): Entité du véhicule.

• Retour

  • boolean: true si valide.

---

Eko.Vehicle:Synchronize(entity)

Force la synchronisation des données du véhicule avec le serveur.

• Paramètres - entity (integer): Entité du véhicule.

---

Eko.Vehicle:Register(entity, owner?)

Enregistre un véhicule comme propriété d’un joueur.

• Paramètres

  • entity (integer): Entité du véhicule.

  • owner (integer, optionnel): ID du propriétaire.

• Retour

  • integer: ID unique du véhicule.

---

Eko.Vehicle:RegisterTemporary(entity)

Enregistre un véhicule temporaire.

• Paramètres - entity (integer): Entité du véhicule.

• Retour - integer: ID temporaire.

---

Eko.Vehicle:Create(model, pos, heading, owner)

Crée et spawn un véhicule.

• Paramètres

  • model (integer): Hash du modèle.

  • pos (vector3): Position de spawn.

  • heading (number): Orientation.

  • owner (integer): ID propriétaire.

• Retour

  • Entity, integer: Entité et ID du véhicule.

---

Eko.Vehicle:Delete(vehicle, definitive?)

Supprime un véhicule.

• Paramètres - vehicle (integer): Entité du véhicule. - definitive (boolean, optionnel): Si true, suppression définitive.

• Retour - boolean: Succès.

---

Eko.Vehicle:Update(id, key, value)

Met à jour une propriété du véhicule.

• Paramètres

  • id (integer): ID du véhicule.

  • key (string): Clé de la propriété.

  • value (any): Nouvelle valeur.

---

Eko.Vehicle:IsLocked(entity)

Vérifie si le véhicule est verrouillé.

• Paramètres - entity (integer): Entité.

• Retour - boolean: true si verrouillé.

---

Eko.Vehicle:GetByPlate(plate)

Récupère l’ID d’un véhicule à partir de sa plaque.

• Paramètres

  • plate (string): Texte de la plaque.

• Retour

  • integer: ID du véhicule.

---

Eko.Vehicle:GetClosest()

Retourne le handle du véhicule le plus proche.

• Retour - integer: Entité du véhicule.

---

Eko.Vehicle:HasKey(entity)

Vérifie si le joueur possède la clé du véhicule.

• Paramètres

  • entity (integer): Entité.

• Retour

  • boolean: true si le joueur a la clé.

---

Eko.Vehicle:HasKeyById(id)

Vérifie la clé via l’ID du véhicule.

• Paramètres - id (integer): ID du véhicule.

• Retour - boolean: true si le joueur a la clé.

---

⚙️ Sous-module : Vehicle.Properties

Gestion des propriétés et des modifications appliquées aux véhicules.

---

Eko.Vehicle.Properties:Get(entity)

Récupère les propriétés d’un véhicule.

• Paramètres

  • entity (integer): Entité.

• Retour

  • table: Propriétés.

---

Eko.Vehicle.Properties:GetMods(entity)

Récupère les modifications appliquées.

• Paramètres - entity (integer): Entité.

• Retour - table: Modifications.

---

Eko.Vehicle.Properties:Set(entity, props, sync?)

Applique des propriétés à un véhicule.

• Paramètres

  • entity (integer): Entité.

  • props (table): Propriétés à appliquer.

  • sync (boolean, optionnel): Synchroniser avec le serveur.

---

⛽ Sous-module : Vehicle.Fuel

Gestion du carburant des véhicules.

---

Eko.Vehicle.Fuel:Get(entity)

Récupère le niveau de carburant.

• Paramètres - entity (integer): Entité.

• Retour - number: Niveau actuel.

---

Eko.Vehicle.Fuel:Set(entity, value)

Modifie le niveau de carburant.

• Paramètres

  • entity (integer): Entité.

  • value (number): Nouveau niveau.

---

Eko.Vehicle.Fuel:StartRefilling(entity, amount)

Démarre le remplissage progressif du carburant.

• Paramètres - entity (integer): Entité. - amount (number): Quantité totale à remplir.

---

🛠️ Exemple d’utilisation

-- Récupérer un véhicule par son ID
local vehicle = Eko.Vehicle:Get(12)

-- Vérifier si la plaque est valide
if Eko.Vehicle:DoesHaveValidPlate(vehicle:entity()) then
    print("Plaque valide")
end

-- Vérifier si le joueur a la clé
if Eko.Vehicle:HasKey(vehicle:entity()) then
    print("Vous avez la clé")
end

-- Récupérer le carburant
local fuel = Eko.Vehicle.Fuel:Get(vehicle:entity())
print("Carburant actuel:", fuel)

-- Changer les propriétés
local props = Eko.Vehicle.Properties:Get(vehicle:entity())
props.colorPrimary = 0
Eko.Vehicle.Properties:Set(vehicle:entity(), props, true)

-- Démarrer le remplissage
Eko.Vehicle.Fuel:StartRefilling(vehicle:entity(), 50.0)

---

⚠️ Notes

• Ces méthodes sont uniquement disponibles côté client.

• Les entités doivent exister en jeu avant d’être manipulées.

• Les sous-modules Properties et Fuel sont chargés séparément via OnObjectLoad.

• Les opérations sensibles (création, suppression, enregistrement) doivent être sécurisées côté serveur.