useSoulStone

Pose une ou plusieurs pierres d'âme pour invoquer leurs groupes.

Pose une pierre d'âme d'identifiant de modèle stoneId (7010, pierre pleine, par défaut) : le bot la trouve dans le sac et double-clique dessus. Une pose compte quand le jeu retire la pierre du sac. Options : retryWhileFullMs reclique tant que la carte est pleine, pendant ce délai en millisecondes ; dans ce délai, jusqu'à 3 clics sans effet de suite sont tolérés. count = N pose jusqu'à N pierres en une action : retryWhileFullMs vaut alors pour la 1re pierre et nextRetryWhileFullMs pour les suivantes (la même valeur par défaut), chaque pierre a droit à un 2e essai si le jeu n'a pas réagi, et le bot attend que le sac se mette à jour entre deux pierres. Ne met jamais le bot en pause et ne relance pas le client.

Signature

inventory:useSoulStone(stoneId=7010, options=nil)

Retour

Sans count : true si la pierre est posée, sinon false et la raison. Avec count : le nombre de pierres réellement posées (0 = aucune), puis la raison de l'arrêt (nil si les N sont posées) ; teste ce nombre avec > 0 : en Lua, 0 compte comme vrai. Raisons : "map_full" (carte pleine malgré l'insistance), "no_stone" (plus de pierre de ce modèle), "not_found" (pierre introuvable dans la grille), "not_sent" (le double-clic n'a rien déclenché), "refused" (le jeu n'a ni retiré la pierre ni refusé la pose en 3 secondes), "unreadable" (inventaire illisible), "wrong_item" (un autre objet a été utilisé), "bad_stone" (identifiant invalide), "fight" (un combat a commencé entre deux pierres).

Exemple

local posees, raison = inventory:useSoulStone(7010, {
    count                = 4,
    retryWhileFullMs     = 60000,   -- 1re pierre
    nextRetryWhileFullMs = 15000,   -- les suivantes
})
if posees == 0 and raison == "map_full" then
    global:journal("Carte pleine : je patiente")
end