Accueil / Character

👤 Fonctions Character

Fonctions pour obtenir des informations sur le personnage : vie, énergie, niveau, kamas, équipement, etc.

character_LifePoints()

Character

Récupère les points de vie actuels du personnage (valeur absolue, pas un pourcentage).

Paramètres

Aucun paramètre.

Valeur de retour

int - Les points de vie actuels du personnage (-1 en cas d'erreur)

Exemple

-- Vérifier les points de vie local life = character_LifePoints() global_SendLogs("Points de vie : " .. life, "Cyan") -- Utiliser un soin si nécessaire if life < 1000 then inventory_UseItem(12345) -- Utiliser une potion end

character_Life()

Character

Récupère le pourcentage de vie actuel du personnage (entre 0 et 100).

Paramètres

Aucun paramètre.

Valeur de retour

int - Le pourcentage de vie (0-100, -1 en cas d'erreur)

Exemple

-- Vérifier le pourcentage de vie local lifePercent = character_Life() global_SendLogs("Vie : " .. lifePercent .. "%", "Cyan") -- Utiliser un soin si la vie est faible if lifePercent < 30 then global_SendLogs("Vie faible, utilisation d'un soin", "Red") inventory_UseItem(12345) end

character_EnergyPoints()

Character

Récupère les points d'énergie actuels du personnage (valeur absolue, max 10000).

Paramètres

Aucun paramètre.

Valeur de retour

int - Les points d'énergie actuels (-1 en cas d'erreur)

Exemple

-- Vérifier l'énergie local energy = character_EnergyPoints() global_SendLogs("Énergie : " .. energy, "Cyan")

character_Energy()

Character

Récupère le pourcentage d'énergie actuel du personnage (entre 0 et 100).

Paramètres

Aucun paramètre.

Valeur de retour

int - Le pourcentage d'énergie (0-100, -1 en cas d'erreur)

Exemple

-- Vérifier le pourcentage d'énergie local energyPercent = character_Energy() global_SendLogs("Énergie : " .. energyPercent .. "%", "Cyan") -- Attendre si l'énergie est faible if energyPercent < 20 then global_SendLogs("Énergie faible, attente...", "Orange") global_Delay(5000) end

character_Level()

Character

Récupère le niveau actuel du personnage.

Paramètres

Aucun paramètre.

Valeur de retour

int - Le niveau du personnage (-1 en cas d'erreur)

Exemple

-- Afficher le niveau local level = character_Level() global_SendLogs("Niveau : " .. level, "Cyan")

character_Name()

Character

Récupère le nom du personnage.

Paramètres

Aucun paramètre.

Valeur de retour

string - Le nom du personnage

Exemple

-- Afficher le nom local name = character_Name() global_SendLogs("Nom : " .. name, "Cyan")

character_ID()

Character

Récupère l'ID unique du personnage.

Paramètres

Aucun paramètre.

Valeur de retour

string - L'ID du personnage

Exemple

-- Afficher l'ID local id = character_ID() global_SendLogs("ID : " .. id, "Cyan")

character_Kamas()

Character

Récupère le nombre de kamas du personnage.

Paramètres

Aucun paramètre.

Valeur de retour

int - Le nombre de kamas (-1 en cas d'erreur)

Exemple

-- Vérifier les kamas local kamas = character_Kamas() global_SendLogs("Kamas : " .. kamas, "Cyan") -- Aller au stockage si on a trop de kamas if kamas > 1000000 then global_SendLogs("Trop de kamas, aller au stockage", "Orange") map_ChangeMap("goto:123456") end

character_Preset(presetUuid, presetType)

Character

Utilise un preset de personnage (équipement, sorts, etc.).

Paramètres

Paramètre Type Description
presetUuid string L'UUID du preset à utiliser
presetType string Le type de preset (ex: 'Character')

Valeur de retour

Aucun

Exemple

-- Utiliser un preset character_Preset("abc123-def456-ghi789", "Character") global_Delay(2000)

character_EquipItem(gid, position, quantity)

Character

Équipe un objet sur le personnage à une position spécifique.

Paramètres

Paramètre Type Description
gid int Le GID de l'objet à équiper
position int La position d'équipement (slot)
quantity int La quantité à équiper

Valeur de retour

Aucun

Exemple

-- Équiper un objet character_EquipItem(12345, 1, 1) -- Équiper l'objet GID 12345 à la position 1 global_Delay(1000)

character_UnequipItem(gid)

Character

Déséquipe un objet et le remet dans l'inventaire (position 63).

Paramètres

Paramètre Type Description
gid int Le GID de l'objet à déséquiper

Valeur de retour

Aucun

Exemple

-- Déséquiper un objet character_UnequipItem(12345) global_Delay(1000)

character_Fight()

Character

⚠️ Déprécié - Utilisez global_CountFight() pour obtenir le nombre de combats. Cette fonction affiche simplement un message d'avertissement.

Paramètres

Aucun paramètre.

Valeur de retour

Aucun

Exemple

-- Ne pas utiliser, utiliser global_CountFight() à la place local fightCount = global_CountFight() global_SendLogs("Combats : " .. fightCount, "Cyan")

character_TeamAutoFollow(followEnabled)

Character

Active ou désactive l'auto-follow du leader en équipe. Permet au personnage de suivre automatiquement le leader.

Paramètres

Paramètre Type Description
followEnabled bool true pour activer, false pour désactiver

Valeur de retour

Aucun

Exemple

-- Activer l'auto-follow character_TeamAutoFollow(true) global_SendLogs("Auto-follow activé", "Green") -- Désactiver l'auto-follow character_TeamAutoFollow(false) global_SendLogs("Auto-follow désactivé", "Orange")