💃Module Animations (Client)

Le module Eko.Animations permet de gérer les animations, scénarios, expressions faciales et styles de marche côté client. Il fournit une API centralisée pour jouer et arrêter des animations ainsi que

📦 API

Eko.Animations:Play(name, whitelist?, onStop?, force?)

Joue une animation définie.

• Paramètres

  • name (string): Nom de l’animation (doit exister dans la configuration).

  • whitelist (boolean, optionnel): Autoriser même si bloqué par un état.

  • onStop (function, optionnel): Callback exécuté à l’arrêt.

  • force (boolean, optionnel): Forcer l'emote.

---

Eko.Animations:Stop(detachProps?, stopForced?)

Arrête l’animation en cours.

• Paramètres

  • detachProps (boolean, optionnel): Retirer les props attachés.

  • stopForced (boolean, optionnel): Arrête l'emote forcée.

---

Eko.Animations:PlayScenario(scenario, coords, direction)

Lance un scénario natif GTA.

• Paramètres

  • scenario (string): Nom du scénario.

  • coords (vector3): Position.

  • direction (number): Orientation.

---

Eko.Animations:SetExpression(expression, save?)

Applique une expression faciale.

• Paramètres

  • expression (string): Nom de l’expression.

  • save (boolean, optionnel): Sauvegarder l’état.

---

Eko.Animations:ResetExpression()

Réinitialise l’expression faciale active.

---

Eko.Animations:SetClipset(clipset, save?)

Applique un style de marche (clipset).

• Paramètres

  • clipset (string): Nom du clipset.

  • save (boolean, optionnel): Sauvegarder l’état.

---

Eko.Animations:ResetClipset(clear?)

Réinitialise le clipset actif.

• Paramètres

  • clear (boolean, optionnel): Supprimer le style actuel.

---

Eko.Animations:SetHolsterStyle(holster_style)

Change le style d’holster d’arme.

• Paramètres

  • holster_style (string): Nom du style.

---

Eko.Animations:DeleteAttachedProps()

Supprime tous les props attachés au joueur.

---

Eko.Animations:Find(name)

Récupère les métadonnées d’une animation configurée.

• Paramètres

  • name (string): Nom de l’animation.

• Retour

  • table: Données de l’animation.

---

Eko.Animations:GetAnimInfo(name, field?)

Retourne une information spécifique sur une animation.

• Paramètres

  • name (string): Nom de l’animation.

  • field (string, optionnel): Champ précis à récupérer.

• Retour

  • any: Valeur du champ ou tableau complet.

---

Eko.Animations:LoadMetadata()

Recharge les métadonnées d’animations configurées.

---

🛠️ Exemple d’utilisation

-- Jouer une animation simple
Eko.Animations:Play("salute")

-- Jouer un scénario
Eko.Animations:PlayScenario("WORLD_HUMAN_GUARD_STAND", vector3(200, -1000, 30), 180.0)

-- Appliquer une expression faciale
Eko.Animations:SetExpression("smug")

-- Réinitialiser l’expression
Eko.Animations:ResetExpression()

-- Changer le style de marche
Eko.Animations:SetClipset("move_m@brave")

-- Réinitialiser le style de marche
Eko.Animations:ResetClipset(true)

-- Arrêter toute animation en cours
Eko.Animations:Stop(true)

-- Supprimer les props
Eko.Animations:DeleteAttachedProps()

-- Vérifier les infos d’une animation
local info = Eko.Animations:GetAnimInfo("salute")
print(json.encode(info))

---

⚠️ Notes

• Ce module est uniquement disponible côté client.

• Les animations doivent être préconfigurées dans les métadonnées du framework.

• L’utilisation de force peut interrompre d’autres états (menottage, blessures).