👤 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")
                

Documentation OnlyBot : guides d’utilisation, scripts Lua, configuration, combats, cartes, HDV et automatisation Dofus. Vous trouverez ici des explications détaillées, des exemples de scripts, des paramètres recommandés et des bonnes pratiques pour améliorer vos routines, sécuriser vos sessions et tirer le meilleur parti des fonctionnalités disponibles. Chaque section vous aide à comprendre les fonctions, leurs paramètres et les cas d’usage les plus fréquents. Prenez le temps de lire les exemples, de tester les fonctions dans vos parcours et d’adapter les scripts à vos besoins. Vous pouvez aussi revenir sur cette page pour vérifier une commande, optimiser un trajet ou configurer des comportements plus avancés.