global

Fonctions utilitaires globales

accountTag

🎮Méthode

global:accountTag()

Retourne le tag complet du compte au format "pseudo#discriminant". Ce tag est l'identifiant unique visible utilise par Ankama pour identifier les joueurs.

Retourne: string - Tag du compte au format "nickname#tag"

Exemple:

local tag = global:accountTag()
global:printMessage("Mon tag: " .. tag)
-- Exemple de sortie: "MonPseudo#1234"

---

activateAntiModerator

🎮Méthode

global:activateAntiModerator(value)

Active ou desactive le systeme anti-moderateur global. Ce parametre est sauvegarde dans les settings de l'application et persiste entre les sessions. Quand actif, le bot peut detecter les messages de moderateurs et reagir automatiquement.

Paramètres:

Nom	Type	Description
value	boolean	true pour activer, false pour desactiver

Exemple:

-- Activer l'anti-moderateur au demarrage du script
global:activateAntiModerator(true)

-- Verifier et activer si necessaire
if not global:antiModeratorActivated() then
    global:activateAntiModerator(true)
    global:printSuccess("Anti-moderateur active!")
end

Note: Ce parametre est global a toute l'application, pas seulement au compte courant.

---

AddInGlobalMemory

🎮Méthode

global:AddInGlobalMemory(variableName, value)

Ajoute une variable dans la memoire globale partagee entre TOUS les comptes connectes. Cette memoire est thread-safe (utilise SyncLock) et permet la communication entre differents bots. La variable n'est ajoutee que si elle n'existe pas deja.

Paramètres:

Nom	Type	Description
variableName	string	Nom unique de la variable
value	any	Valeur a stocker (peut etre n'importe quel type)

Exemple:

-- Creer un compteur partage entre tous les bots
global:AddInGlobalMemory("totalKamas", 0)

-- Creer une liste de maps visitees partagee
global:AddInGlobalMemory("visitedMaps", {})

-- Verifier avant d'ajouter
if global:GetInGlobalMemory("bossReady") == nil then
    global:AddInGlobalMemory("bossReady", false)
end

Note: Utiliser EditInGlobalMemory pour modifier une variable existante. AddInGlobalMemory n'ecrase pas les valeurs existantes.

---

addInMemory

🎮Méthode

global:addInMemory(variableName, value)

Ajoute une variable dans la memoire locale du compte. Cette memoire est privee et n'est pas partagee avec les autres comptes. Utile pour stocker des etats persistants durant l'execution du script.

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable
value	any	Valeur a stocker

Exemple:

-- Stocker le nombre de combats depuis la derniere banque
global:addInMemory("fightsSinceBank", 0)

-- Stocker l'heure de debut
global:addInMemory("startTime", global:elapsedTime())

-- Stocker une configuration
global:addInMemory("maxFights", 100)

Note: La memoire locale est effacee quand le script est recharge. Utiliser la memoire globale pour persister entre les rechargements.

---

afterFight

🎮Méthode

global:afterFight()

Verifie si le personnage vient de terminer un combat. Cette fonction retourne true UNE SEULE FOIS apres chaque combat - elle remet automatiquement le flag a false apres lecture. Utile pour executer des actions post-combat comme la verification de l'inventaire ou la regeneration.

Retourne: boolean - true si un combat vient de se terminer (retourne false aux appels suivants)

Exemple:

-- Dans la fonction move()
if global:afterFight() then
    global:printMessage("Combat termine!")

    -- Verifier si on doit aller en banque
    local pods = inventory:currentPods()
    local maxPods = inventory:maxPods()
    if pods > maxPods * 0.9 then
        return "bank"  -- Aller en banque si plus de 90% de pods
    end
end

Note: Cette fonction est "consumable" - elle ne retourne true qu'une seule fois par combat.

---

antiModeratorActivated

🎮Méthode

global:antiModeratorActivated()

Verifie si le systeme anti-moderateur est actuellement active dans les settings de l'application.

Retourne: boolean - true si le systeme anti-moderateur est actif

Exemple:

if global:antiModeratorActivated() then
    global:printMessage("Protection anti-moderateur active")

    -- Verifier periodiquement les moderateurs
    if global:checkModerator(5) then
        global:printError("Moderateur detecte! Deconnexion...")
        global:disconnect()
    end
end

---

askInput

🎮Méthode

global:askInput(question, title)

Affiche une boite de dialogue Windows (InputBox) demandant a l'utilisateur de saisir une valeur. Le script est mis en pause jusqu'a ce que l'utilisateur reponde. Si le titre n'est pas specifie, "SnowBot - Input" est utilise par defaut.

Paramètres:

Nom	Type	Description
question	string	Question ou instruction a afficher
title	string	Titre de la fenetre (optionnel)

Retourne: string - Texte saisi par l'utilisateur, ou chaine vide si annule

Exemple:

-- Demander le nombre de combats souhaites
local nbCombats = global:askInput("Combien de combats voulez-vous faire?", "Configuration")
if nbCombats ~= "" then
    global:addInMemory("maxFights", tonumber(nbCombats))
    global:printSuccess("Configuration: " .. nbCombats .. " combats")
end

-- Demander une destination
local destination = global:askInput("Entrez les coordonnees (ex: 3,-5):")

Note: Bloque l'execution du script jusqu'a la reponse de l'utilisateur.

---

askQuestion

🎮Méthode

global:askQuestion(question)

Affiche une boite de dialogue Windows avec une question et deux boutons Oui/Non. Le script est mis en pause jusqu'a ce que l'utilisateur clique sur un bouton.

Paramètres:

Nom	Type	Description
question	string	Question a poser

Retourne: boolean - true si l'utilisateur a clique sur Oui, false si Non

Exemple:

-- Confirmation avant une action importante
if global:askQuestion("Voulez-vous vider l'inventaire en banque?") then
    inventory:putAllInBank()
    global:printSuccess("Inventaire depose en banque")
else
    global:printMessage("Operation annulee")
end

-- Choix de mode de jeu
local wantFight = global:askQuestion("Mode combat? (Non = recolte)")

Note: Bloque l'execution du script jusqu'au clic de l'utilisateur.

---

blabla

🎮Méthode

global:blabla()

Alias interne pour isKoliServer(). Retourne true si le serveur actuel est un serveur Kolizeum.

Retourne: boolean - true si serveur Kolizeum

Exemple:

if global:blabla() then
    global:printMessage("Serveur Kolizeum detecte")
end

Note: Preferer utiliser isKoliServer() pour plus de clarte.

---

charactersList

🎮Méthode

global:charactersList()

Retourne le message CharactersListMessage contenant la liste complete des personnages du compte. Ce message est recu lors de la connexion et contient tous les personnages avec leurs informations (nom, niveau, serveur, etc.).

Retourne: CharactersListMessage - Message contenant la liste des personnages avec leurs details

Exemple:

local charList = global:charactersList()
if charList and charList.characters then
    global:printMessage("Personnages du compte:")
    for _, char in ipairs(charList.characters) do
        global:printMessage("  - " .. char.name .. " (Niv." .. char.level .. ")")
    end
end

---

checkCredentialsStatus

🎮Méthode

global:checkCredentialsStatus()

Retourne le statut de validation des identifiants du compte (email/mot de passe). Permet de savoir si les credentials sont valides, expires ou invalides.

Retourne: string - Statut des identifiants

Exemple:

local status = global:checkCredentialsStatus()
global:printMessage("Statut credentials: " .. status)

if status ~= "valid" then
    global:printError("Identifiants invalides ou expires!")
end

---

checkModerator

🎮Méthode

global:checkModerator(minutes)

Interroge le serveur Snowbot pour verifier si un moderateur a ete detecte sur le serveur actuel dans les X dernieres minutes. Utilise une API externe pour centraliser les detections de tous les utilisateurs.

Paramètres:

Nom	Type	Description
minutes	number	Periode de verification en minutes

Retourne: boolean - true si un moderateur a ete signale dans la periode

Exemple:

-- Verification avant chaque action
if global:checkModerator(10) then
    global:printError("ALERTE: Moderateur detecte dans les 10 dernieres minutes!")
    global:disconnect()
    return
end

-- Verification avec nom de serveur specifique
if global:checkModerator("Ombre", 5) then
    global:printError("Moderateur sur Ombre!")
end

Note: Necessite une connexion internet. La detection est basee sur les signalements de la communaute.

---

clearConsole

🎮Méthode

global:clearConsole()

Efface completement le contenu de la console/chat du bot. Utile pour nettoyer l'affichage avant de commencer une nouvelle session ou pour reduire l'utilisation memoire.

Exemple:

-- Nettoyer au demarrage du script
function started()
    global:clearConsole()
    global:printSuccess("=== Script demarre ===")
    global:printMessage("Version 1.0")
end

---

consoleLines

🎮Méthode

global:consoleLines()

Retourne toutes les lignes actuellement affichees dans la console sous forme de liste. Les premiers 3 caracteres (prefixe de ligne) et les 10 derniers caracteres (suffixe) sont automatiquement supprimes. Utile pour analyser l'historique des messages.

Retourne toutes les lignes actuellement affichees dans la console sous forme de liste. Les premiers 3 caracteres (prefixe de ligne) et les 10 derniers caracteres (suffixe) sont automatiquement supprimes. Utile pour analyser l'historique des messages. Signature: global:consoleLines()

Exemple:

local lines = global:consoleLines()
global:printMessage("Nombre de lignes: " .. #lines)

-- Rechercher un message specifique
for _, line in ipairs(lines) do
    if line:find("Erreur") then
        global:printError("Erreur trouvee dans les logs!")
        break
    end
end

Note: En cas d'erreur, la fonction reessaie automatiquement apres 1 seconde.

---

delay

🎮Méthode

global:delay(Time)

Met en pause l'execution du script pendant une duree specifiee en millisecondes. Pendant la pause, le bot continue de lire les messages entrants (ReadFlowMessage) toutes les 200ms pour rester reactif aux evenements du jeu.

Paramètres:

Nom	Type	Description
Time	number	Duree de pause en millisecondes

Exemple:

-- Pause simple de 2 secondes
global:delay(2000)

-- Pause aleatoire pour paraitre plus humain
local randomDelay = global:random(1000, 3000)
global:delay(randomDelay)

-- Attendre entre les actions
map:changeMap("top")
global:delay(500)  -- Petite pause apres changement de map

Note: Le bot reste reactif pendant le delay (traitement des paquets en arriere-plan).

---

DeleteAllGlobalMemory

Supprime TOUTES les variables de la memoire globale partagee. Operation thread-safe qui affecte tous les comptes connectes. A utiliser avec precaution car cela peut affecter les autres scripts en cours d'execution.

Signature: global:DeleteAllGlobalMemory()

Exemple:

-- Reinitialiser la memoire globale au demarrage
if global:isBoss() then
    global:DeleteAllGlobalMemory()
    global:printSuccess("Memoire globale reinitialisee")
end

Note: Affecte TOUS les comptes! A utiliser uniquement par le chef d'equipe.

---

deleteAllMemory

Supprime toutes les variables de la memoire locale du compte. N'affecte pas les autres comptes ni la memoire globale.

Signature: global:deleteAllMemory()

Exemple:

-- Reinitialiser au debut du script
function started()
    global:deleteAllMemory()
    global:addInMemory("fightCount", 0)
    global:addInMemory("gatherCount", 0)
end

---

DeleteFromGlobalMemory

Supprime une variable specifique de la memoire globale partagee. Operation thread-safe.

Signature: global:DeleteFromGlobalMemory(variableName)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable a supprimer

Exemple:

-- Nettoyer une variable temporaire
global:DeleteFromGlobalMemory("tempData")

-- Reinitialiser un flag
global:DeleteFromGlobalMemory("bossInFight")

---

deleteMemory

Supprime une variable specifique de la memoire locale du compte.

Signature: global:deleteMemory(variableName)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable a supprimer

Exemple:

-- Supprimer une variable temporaire
global:deleteMemory("tempValue")

---

disconnect

Deconnecte le compte actuel ET tous les membres de l'equipe (Teamcontrol) du serveur de jeu. La deconnexion est effectuee dans l'ordre: d'abord les mules, puis le chef.

Signature: global:disconnect()

Exemple:

-- Deconnexion d'urgence
if global:checkModerator(5) then
    global:printError("Moderateur detecte! Deconnexion de l'equipe...")
    global:disconnect()
end

-- Deconnexion programmee
if global:getCountFight() >= 100 then
    global:printSuccess("100 combats atteints, deconnexion!")
    global:disconnect()
end

Note: Deconnecte automatiquement toute l'equipe si ce compte est chef.

---

editAlias

Modifie l'alias (nom affiche) du compte dans Snowbot. Peut optionnellement sauvegarder le changement de facon permanente dans les settings. Inclut un systeme de retry automatique en cas d'echec.

Signature: global:editAlias(newAlias, keep, retryCount, retryDelayMs)

Paramètres:

Nom	Type	Description
newAlias	string	Nouvel alias a utiliser
keep	boolean	true pour sauvegarder dans les settings (optionnel, defaut: false)
retryCount	number	Nombre de tentatives en cas d'echec (optionnel, defaut: 3)
retryDelayMs	number	Delai entre les tentatives en ms (optionnel, defaut: 100)

Retourne: boolean - true si la modification a reussi

Exemple:

-- Renommer avec le nom du personnage
local charName = character:name()
if global:editAlias(charName, true) then
    global:printSuccess("Alias change en: " .. charName)
end

-- Alias temporaire (non sauvegarde)
global:editAlias("[FARMING] " .. character:name())

---

EditInGlobalMemory

Modifie la valeur d'une variable EXISTANTE dans la memoire globale partagee. La variable doit avoir ete creee prealablement avec AddInGlobalMemory. Operation thread-safe.

Signature: global:EditInGlobalMemory(variableName, value)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable existante
value	any	Nouvelle valeur

Exemple:

-- Incrementer un compteur partage
local currentCount = global:GetInGlobalMemory("totalFights") or 0
global:EditInGlobalMemory("totalFights", currentCount + 1)

-- Signaler que le boss est pret
global:EditInGlobalMemory("bossReady", true)

Note: Ne fait rien si la variable n'existe pas. Utiliser AddInGlobalMemory d'abord.

---

editInMemory

Modifie la valeur d'une variable existante dans la memoire locale du compte. La variable doit avoir ete creee avec addInMemory.

Signature: global:editInMemory(variableName, value)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable
value	any	Nouvelle valeur

Exemple:

-- Incrementer le compteur de combats
local fights = global:remember("fightCount") or 0
global:editInMemory("fightCount", fights + 1)

---

elapsedTime

Retourne le temps ecoule depuis le demarrage du bot (pas du script) en millisecondes. Utile pour mesurer des durees ou programmer des actions periodiques.

Signature: global:elapsedTime()

Retourne: number - Temps en millisecondes depuis le demarrage

Exemple:

-- Afficher le temps de session
local elapsed = global:elapsedTime()
local minutes = math.floor(elapsed / 60000)
global:printMessage("Session en cours depuis: " .. minutes .. " minutes")

-- Executer une action toutes les 30 minutes
local lastAction = global:remember("lastBankTime") or 0
if global:elapsedTime() - lastAction > 1800000 then  -- 30 min
    global:editInMemory("lastBankTime", global:elapsedTime())
    -- Aller en banque...
end

---

exportAllPublicMethods

Genere une documentation textuelle complete de toutes les methodes publiques disponibles dans l'API Lua. Inclut tous les modules (character, inventory, map, etc.) avec leurs signatures et types de retour.

Signature: global:exportAllPublicMethods()

Retourne: string - Documentation formatee de toutes les methodes

Exemple:

-- Exporter la documentation
local doc = global:exportAllPublicMethods()
global:printMessage(doc)

-- Utile pour le debug/developpement

Note: Utile pour les developpeurs de scripts.

---

fightMessage

Retourne les informations detaillees du dernier combat termine (GameFightEndMessage). Si lastFightNumber est specifie, retourne le combat correspondant a cet index. Contient les XP, kamas, loots, etc.

Signature: global:fightMessage(lastFightNumber)

Paramètres:

Nom	Type	Description
lastFightNumber	number	Index du combat (-1 ou omis = dernier combat)

Retourne: GameFightEndMessage - Message de fin de combat avec toutes les recompenses

Exemple:

-- Recuperer les infos du dernier combat
local fightEnd = global:fightMessage()
if fightEnd then
    global:printMessage("Combat #" .. fightEnd.fightCounter)
    global:printMessage("XP: " .. (fightEnd.xpBonus or 0))

    -- Afficher les loots
    if fightEnd.results then
        for _, result in ipairs(fightEnd.results) do
            if result.rewards and result.rewards.objects then
                for _, obj in ipairs(result.rewards.objects) do
                    global:printMessage("Loot: " .. obj.objectGID .. " x" .. obj.quantity)
                end
            end
        end
    end
end

---

finishScript

Arrete proprement l'execution du script en cours. Le script s'arrete immediatement mais le bot reste connecte. Utile pour terminer un script apres avoir atteint un objectif.

Signature: global:finishScript()

Exemple:

-- Arreter apres X combats
if global:getCountFight() >= 100 then
    global:printSuccess("Objectif atteint: 100 combats!")
    global:finishScript()
end

-- Arreter en cas de probleme
if character:lifePercent() < 10 then
    global:printError("Vie trop basse, arret du script!")
    global:finishScript()
end

---

getAlias

Retourne l'alias actuel du compte tel qu'il est affiche dans l'interface Snowbot.

Signature: global:getAlias()

Retourne: string - Alias du compte

Exemple:

local alias = global:getAlias()
global:printMessage("Alias actuel: " .. alias)

---

getAllFilesNameInDirectory

Liste tous les fichiers d'un repertoire specifie. Peut filtrer par extension. Pour des raisons de securite, les repertoires contenant "AppData" sont bloques.

Signature: global:getAllFilesNameInDirectory(directoryName, filter)

Paramètres:

Nom	Type	Description
directoryName	string	Chemin complet du repertoire
filter	string	Extension a filtrer sans le point (ex: "lua", "json") - optionnel

Retourne: table - Liste des noms de fichiers

Exemple:

-- Lister les scripts Lua
local scriptDir = global:getCurrentScriptDirectory()
local scripts = global:getAllFilesNameInDirectory(scriptDir, "lua")
for _, script in ipairs(scripts) do
    global:printMessage("Script: " .. script)
end

-- Lister tous les fichiers
local allFiles = global:getAllFilesNameInDirectory("C:/Snowbot/configs")

Note: Les chemins contenant AppData sont bloques pour securite.

---

getController

Retourne un objet AccountController pour le compte actuel. Permet d'acceder a des fonctionnalites avancees de controle du compte.

Signature: global:getController()

Retourne: AccountController - Controleur du compte

Exemple:

local controller = global:getController()
-- Utiliser les methodes du controller...

---

getCountFight

Retourne le nombre total de combats effectues depuis le demarrage du bot. Ce compteur est incremente automatiquement a chaque fin de combat.

Signature: global:getCountFight()

Retourne: number - Nombre de combats

Exemple:

local fights = global:getCountFight()
global:printMessage("Combats: " .. fights)

-- Arreter apres X combats
if fights >= 50 then
    global:printSuccess("50 combats atteints!")
    global:disconnect()
end

---

getCountGather

Retourne le nombre total de recoltes effectuees depuis le demarrage du bot. Incremente a chaque ressource recoltee avec succes.

Signature: global:getCountGather()

Retourne: number - Nombre de recoltes

Exemple:

local gathers = global:getCountGather()
global:printMessage("Recoltes: " .. gathers)

-- Stats de session
local fights = global:getCountFight()
global:printMessage("Session: " .. fights .. " combats, " .. gathers .. " recoltes")

---

getCurrentDirectory

Retourne le repertoire de travail actuel de l'application (Environment.CurrentDirectory). Generalement le dossier d'installation de Snowbot.

Signature: global:getCurrentDirectory()

Retourne: string - Chemin complet du repertoire de travail

Exemple:

local dir = global:getCurrentDirectory()
global:printMessage("Dossier Snowbot: " .. dir)

---

getCurrentProxyAddress

Retourne l'adresse IP et le port du proxy actuellement utilise, au format "ip:port". Retourne une chaine vide si aucun proxy n'est configure ou actif.

Signature: global:getCurrentProxyAddress()

Retourne: string - Adresse du proxy au format "ip:port" ou chaine vide

Exemple:

local proxy = global:getCurrentProxyAddress()
if proxy ~= "" then
    global:printMessage("Proxy actif: " .. proxy)
else
    global:printMessage("Pas de proxy")
end

---

getCurrentScriptDirectory

Retourne le repertoire contenant le script actuellement en cours d'execution. Utile pour charger des fichiers relatifs au script (configs, sous-scripts, etc.).

Signature: global:getCurrentScriptDirectory()

Retourne: string - Chemin complet du dossier du script

Exemple:

local scriptDir = global:getCurrentScriptDirectory()
global:printMessage("Script dans: " .. scriptDir)

-- Charger un fichier de config relatif
local configPath = scriptDir .. "/config.json"

---

GetInGlobalMemory

Recupere la valeur d'une variable depuis la memoire globale partagee entre tous les comptes. Retourne nil si la variable n'existe pas. Operation thread-safe.

Signature: global:GetInGlobalMemory(variableName)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable

Retourne: any - Valeur de la variable ou nil si non trouvee

Exemple:

-- Recuperer un compteur partage
local totalFights = global:GetInGlobalMemory("totalFights")
if totalFights then
    global:printMessage("Total equipe: " .. totalFights .. " combats")
end

-- Verifier si le boss est pret
local bossReady = global:GetInGlobalMemory("bossReady")
if bossReady == true then
    global:printMessage("Le boss est pret, on peut y aller!")
end

---

getProxyConfig

Retourne la configuration complete du proxy au format "ip:port:username:password". Chaque composant n'est ajoute que s'il est configure. Retourne une chaine vide si aucun proxy.

Signature: global:getProxyConfig()

Retourne: string - Configuration du proxy ou chaine vide

Exemple:

local proxyConfig = global:getProxyConfig()
if proxyConfig ~= "" then
    global:printMessage("Config proxy: " .. proxyConfig)
end

Note: Contient potentiellement des informations sensibles (credentials).

---

getReplies

Retourne la liste des IDs de reponses disponibles dans le dialogue NPC actuel. Ces IDs peuvent etre utilises avec npc:reply() pour selectionner une reponse.

Signature: global:getReplies()

Retourne: table - Liste des IDs de reponses (UInteger)

Exemple:

local replies = global:getReplies()
global:printMessage("Reponses disponibles: " .. #replies)
for i, replyId in ipairs(replies) do
    global:printMessage("  " .. i .. ": ID=" .. replyId)
end

-- Selectionner la premiere reponse
if #replies > 0 then
    npc:reply(replies[1])
end

---

getTeamMembers

Retourne la liste des noms de personnages de l'equipe Snowbot (pas le groupe en jeu). Inclut le chef et tous les membres du Teamcontrol. Fonctionne uniquement depuis le chef d'equipe.

Signature: global:getTeamMembers()

Retourne: table - Liste des noms de personnages

Exemple:

if global:isBoss() then
    local members = global:getTeamMembers()
    global:printMessage("Equipe (" .. #members .. " membres):")
    for _, name in ipairs(members) do
        global:printMessage("  - " .. name)
    end
end

Note: Retourne une liste vide si pas chef d'equipe.

---

getTeamMembersIds

Retourne la liste des IDs de personnages (idperso) de l'equipe Snowbot. Fonctionne uniquement depuis le chef d'equipe.

Signature: global:getTeamMembersIds()

Retourne: table - Liste des IDs de personnages (Double)

Exemple:

if global:isBoss() then
    local ids = global:getTeamMembersIds()
    global:printMessage("IDs equipe: " .. table.concat(ids, ", "))
end

---

getTeamMembersNames

Alias de getTeamMembers(). Retourne la liste des noms de personnages de l'equipe Snowbot.

Signature: global:getTeamMembersNames()

Retourne: table - Liste des noms de personnages

Exemple:

local names = global:getTeamMembersNames()

---

getTeamMembersUsernames

Retourne la liste des usernames (identifiants de connexion) de l'equipe Snowbot. Fonctionne uniquement depuis le chef d'equipe.

Signature: global:getTeamMembersUsernames()

Retourne: table - Liste des usernames

Exemple:

if global:isBoss() then
    local usernames = global:getTeamMembersUsernames()
    for _, username in ipairs(usernames) do
        global:printMessage("Compte: " .. username)
    end
end

---

getToken

Retourne le token de l'instance Snowbot (RawdataServer.username). Ce token est utilise pour l'authentification avec les services Snowbot.

Signature: global:getToken()

Retourne: string - Token de l'instance

Exemple:

local token = global:getToken()
global:printMessage("Token: " .. token)

---

groupCharacters

Groupe plusieurs comptes Snowbot en equipe. Le compte appelant devient automatiquement le chef. Les comptes specifies sont recherches parmi tous les MITM connectes et ajoutes au Teamcontrol. Met a jour automatiquement l'interface (TreeView).

Signature: global:groupCharacters(usernames)

Paramètres:

Nom	Type	Description
usernames	table	Liste des usernames des comptes a grouper

Exemple:

-- Grouper 3 mules avec le compte actuel comme chef
global:groupCharacters({"[email protected]", "[email protected]", "[email protected]"})

-- Verification avant groupage
if not global:isBoss() then
    global:groupCharacters({"compte2", "compte3"})
    global:printSuccess("Equipe creee!")
end

Note: Les comptes doivent etre connectes dans Snowbot. Les comptes deja en equipe sont ignores.

---

inviteTeam

Envoie des invitations de groupe (en jeu) a tous les membres de l'equipe Snowbot. Met d'abord les mules en statut "disponible" puis envoie les invitations. Fonctionne uniquement depuis le chef d'equipe.

Signature: global:inviteTeam()

Exemple:

if global:isBoss() then
    global:printMessage("Envoi des invitations...")
    global:inviteTeam()
    global:delay(3000)  -- Attendre que tout le monde accepte
end

Note: Necessite d'etre chef d'equipe ET en jeu.

---

isBoss

Verifie si le compte actuel est le chef de l'equipe Snowbot. Retourne true uniquement si le compte est en mode Team ET est designe comme ChefTeam.

Signature: global:isBoss()

Retourne: boolean - true si ce compte est le chef d'equipe

Exemple:

if global:isBoss() then
    global:printMessage("Je suis le chef d'equipe")
    -- Actions reservees au chef
    global:inviteTeam()
else
    global:printMessage("Je suis une mule")
    -- Attendre les ordres du chef
end

---

isInFight

Verifie si le personnage est actuellement en combat. Utile pour conditionner des actions qui ne doivent pas etre executees pendant un combat.

Signature: global:isInFight()

Retourne: boolean - true si en combat

Exemple:

if global:isInFight() then
    global:printMessage("En combat, attente...")
    return
end

-- Action hors combat
map:gather()

---

isInParty

Verifie si un joueur specifique (par son ID) fait partie du groupe en jeu actuel. Utilise la liste dansLeGroupe du MITM.

Signature: global:isInParty(playerId)

Paramètres:

Nom	Type	Description
playerId	number	ID du joueur a verifier

Retourne: boolean - true si le joueur est dans le groupe

Exemple:

-- Verifier si un membre est dans le groupe
local memberId = 123456789
if global:isInParty(memberId) then
    global:printMessage("Membre present dans le groupe")
else
    global:printMessage("Membre absent, envoi d'invitation...")
end

---

isInTeam

Verifie si un utilisateur ou personnage fait partie de l'equipe Snowbot (pas le groupe en jeu). Recherche par username OU par nom de personnage.

Signature: global:isInTeam(usernameOrCharacterName)

Paramètres:

Nom	Type	Description
usernameOrCharacterName	string	Username du compte OU nom du personnage

Retourne: boolean - true si dans l'equipe Snowbot

Exemple:

-- Verifier par nom de personnage
if global:isInTeam("MonMule") then
    global:printMessage("MonMule fait partie de l'equipe")
end

-- Verifier par username
if global:isInTeam("[email protected]") then
    global:printMessage("Ce compte est dans l'equipe")
end

---

isKoliServer

Verifie si le serveur actuel est un serveur Kolizeum (IsKoli du PacketAnalyser).

Signature: global:isKoliServer()

Retourne: boolean - true si serveur Kolizeum

Exemple:

if global:isKoliServer() then
    global:printMessage("Mode Kolizeum actif")
end

---

isRegisteredInKoli

Verifie si le personnage est actuellement inscrit dans la file d'attente Kolizeum.

Signature: global:isRegisteredInKoli()

Retourne: boolean - true si inscrit en file Kolizeum

Exemple:

if global:isRegisteredInKoli() then
    global:printMessage("En attente de match Kolizeum...")
end

---

isScriptPlaying

Verifie si un script est actuellement en cours d'execution sur ce compte.

Signature: global:isScriptPlaying()

Retourne: boolean - true si un script est en cours

Exemple:

if global:isScriptPlaying() then
    global:printMessage("Script actif")
end

---

isStuffForKoli

Verifie si le personnage a un equipement complet pour le Kolizeum. Controle les positions: chapeau(0), cape(1), amulette(2), anneau1(3), ceinture(4), anneau2(5), bottes(6), arme(7) et bouclier(15). Affiche un avertissement si des emplacements sont vides.

Signature: global:isStuffForKoli()

Retourne: boolean - true si tous les emplacements requis sont equipes

Exemple:

if not global:isStuffForKoli() then
    global:printError("Equipement incomplet pour le Kolizeum!")
    global:printMessage("Risque de ban Koli si vous jouez ainsi")
    return
end

global:printSuccess("Equipement OK pour le Kolizeum")

---

joinBoss

🎮Méthode

global:joinBoss()

Ordonne a tous les membres de l'equipe de rejoindre la carte du chef. Met le flag goToLeader=true pour chaque membre qui n'est pas sur la meme carte. Fonctionne uniquement depuis le chef.

Exemple:

if global:isBoss() then
    global:printMessage("Rassemblement de l'equipe!")
    global:joinBoss()
    global:delay(10000)  -- Attendre que tout le monde arrive
end

Note: Les mules doivent avoir un script qui gere le flag goToLeader.

---

lastModeratorMessage

🎮Méthode

global:lastModeratorMessage()

Retourne le dernier message d'avertissement de moderateur recu (PopupWarningMessage). Peut etre nil si aucun message n'a ete recu.

Retourne: PopupWarningMessage - Dernier message de moderateur ou nil

Exemple:

local modMsg = global:lastModeratorMessage()
if modMsg then
    global:printError("Attention! Message modo: " .. (modMsg.content or ""))
    global:disconnect()
end

---

leaderAccountController

🎮Méthode

global:leaderAccountController()

Retourne l'AccountController du chef d'equipe. Si appele depuis le chef, retourne son propre controller. Si appele depuis une mule, retourne le controller du chef (ChefMitm).

Retourne: AccountController - Controller du chef ou nil si pas en equipe

Exemple:

local leaderCtrl = global:leaderAccountController()
if leaderCtrl then
    -- Acceder aux infos du chef
end

---

leaveDialog

🎮Méthode

global:leaveDialog()

Ferme le dialogue NPC ou la fenetre d'echange actuellement ouverte. Envoie LeaveDialogRequestMessage au serveur et attend la confirmation (packet 176).

Exemple:

-- Apres avoir termine avec un NPC
npc:reply(reponseId)
global:delay(500)
global:leaveDialog()

---

loadAndStart

🎮Méthode

global:loadAndStart(file, breakCurrentScript)

Charge et demarre un autre script Lua. Si breakCurrentScript est true, attend longtemps puis arrete le script actuel. Le nouveau script est charge dans un thread separe.

Paramètres:

Nom	Type	Description
file	string	Chemin complet du script a charger
breakCurrentScript	boolean	true pour arreter le script actuel (optionnel)

Exemple:

-- Charger un script de banque
if inventory:currentPods() > inventory:maxPods() * 0.9 then
    global:loadAndStart("C:/Scripts/bank.lua", true)
end

---

loadConfiguration

🎮Méthode

global:loadConfiguration(config)

Charge un fichier de configuration complet (.json) et l'applique au compte. Ecrase la configuration actuelle, initialise et recharge tous les parametres.

Paramètres:

Nom	Type	Description
config	string	Chemin complet du fichier de configuration

Exemple:

-- Charger une config de farming
global:loadConfiguration("C:/Snowbot/configs/farming.json")

---

LoadConfigurationWithoutScript

🎮Méthode

global:LoadConfigurationWithoutScript(config)

Charge une configuration sans modifier le script actuel. Utile pour changer les parametres (sorts, comportements) sans recharger le script. Sauvegarde le script actuel, charge la config, puis restaure le chemin du script.

Paramètres:

Nom	Type	Description
config	string	Chemin du fichier de configuration

Exemple:

-- Changer la config de combat sans recharger le script
global:LoadConfigurationWithoutScript("C:/Snowbot/configs/fight_config.json")

---

openMitm

🎮Méthode

Retourne: boolean - true si le MITM a ete active

Active le mode MITM (Man-In-The-Middle) et lance Dofus avec la redirection. Ne peut pas etre utilise pendant un combat. Cree un nouveau thread pour demarrer Dofus.

global:openMitm()

Exemple:

if global:openMitm() then
    global:printSuccess("MITM active, Dofus demarre")
else
    global:printError("Impossible d'activer le MITM")
end

Note: Ne fonctionne pas si deja en MITM ou en combat.

---

password

🎮Méthode

global:password()

Retourne le mot de passe du compte.

Signature: global:password()

Exemple:

local pass = global:password()

Note: Attention: information sensible! Ne pas afficher ou logger.

---

playAudio

🎮Méthode

global:playAudio(file)

Joue un fichier audio (WAV, MP3, etc.) en utilisant l'API audio de Windows. Signature: global:playAudio(file)

Signature: global:playAudio(file)

Paramètres:

Nom	Type	Description
file	string	Chemin complet du fichier audio

-- Alerte sonore quand moderateur detecte
if global:checkModerator(5) then
    global:playAudio("C:/Snowbot/sounds/alert.wav")
    global:disconnect()
end

---

printColor

Affiche un message dans la console avec une couleur personnalisee. La couleur doit etre au format hexadecimal (#RRGGBB). La fonction detecte automatiquement si les parametres sont inverses.

Signature: global:printColor(Message, hexColor)

Paramètres:

Nom	Type	Description
Message	string	Message a afficher
hexColor	string	Couleur en hexadecimal (ex: "#FF0000" pour rouge)

Exemple:

-- Message rouge
global:printColor("ATTENTION!", "#FF0000")

-- Message vert
global:printColor("Succes!", "#00FF00")

-- Message personnalise
global:printColor("Info importante", "#FFA500")  -- Orange

---

printError

Affiche un message d'erreur dans la console (LogType.Errorr). Le message apparait en rouge.

Signature: global:printError(Message)

Paramètres:

Nom	Type	Description
Message	string	Message d'erreur

Exemple:

if character:lifePercent() < 20 then
    global:printError("Vie critique!")
end

---

printMessage

Affiche un message d'information standard dans la console (LogType.Info).

Signature: global:printMessage(Message)

Paramètres:

Nom	Type	Description
Message	string	Message a afficher

Exemple:

global:printMessage("Script demarre")
global:printMessage("Map: " .. map:currentMap())

---

printSuccess

Affiche un message de succes dans la console (LogType.Sucess). Le message apparait en vert.

Signature: global:printSuccess(message)

Paramètres:

Nom	Type	Description
message	string	Message de succes

Exemple:

if map:fight() then
    global:printSuccess("Combat lance!")
end

---

proxyIsEnabled

Verifie si un proxy est configure et actif pour ce compte.

Signature: global:proxyIsEnabled()

Retourne: boolean - true si proxy actif

Exemple:

if global:proxyIsEnabled() then
    global:printMessage("Proxy: " .. global:getCurrentProxyAddress())
else
    global:printMessage("Connexion directe (pas de proxy)")
end

---

random

Genere un nombre entier aleatoire entre min et max (inclus). Utilise System.Random.

Signature: global:random(min, max)

Paramètres:

Nom	Type	Description
min	number	Valeur minimum (incluse)
max	number	Valeur maximum (incluse)

Retourne: number - Nombre aleatoire entre min et max

Exemple:

-- Delai aleatoire humanise
local delay = global:random(1000, 3000)
global:delay(delay)

-- Choix aleatoire
local choice = global:random(1, 4)
if choice == 1 then
    map:changeMap("top")
elseif choice == 2 then
    map:changeMap("bottom")
end

---

rcAskFight

Affiche une boite de dialogue demandant a l'utilisateur s'il veut combattre sur cette carte. Message: "Voulez-vous combattre sur cette carte?"

Signature: global:rcAskFight()

Retourne: boolean - true si l'utilisateur a clique Oui

Exemple:

-- Mode semi-automatique
if global:rcAskFight() then
    map:fight()
end

---

rcAskGather

Affiche une boite de dialogue demandant a l'utilisateur s'il veut recolter sur cette carte. Message: "Voulez-vous recolter sur cette carte?"

Signature: global:rcAskGather()

Retourne: boolean - true si l'utilisateur a clique Oui

Exemple:

-- Mode semi-automatique
if global:rcAskGather() then
    map:gather()
end

---

reconnect

Programme une reconnexion de l'equipe complete apres X heures. Deconnecte d'abord les mules (avec un decalage de 1 seconde entre chaque) puis le chef.

Signature: global:reconnect(Heure)

Paramètres:

Nom	Type	Description
Heure	number	Delai en heures avant reconnexion

Exemple:

-- Reconnexion dans 2 heures
global:reconnect(2)

-- Reconnexion dans 30 minutes (0.5 heure)
global:reconnect(0.5)

---

reconnectBis

Programme une reconnexion du compte actuel (sans l'equipe) apres X minutes.

Signature: global:reconnectBis(minutes)

Paramètres:

Nom	Type	Description
minutes	number	Delai en minutes

Exemple:

-- Reconnexion dans 30 minutes
global:reconnectBis(30)

---

reconnectSec

Programme une reconnexion de l'equipe apres X secondes. Les mules sont decalees de 1 seconde chacune.

Signature: global:reconnectSec(Heure)

Paramètres:

Nom	Type	Description
Heure	number	Delai en secondes

Exemple:

-- Reconnexion dans 60 secondes
global:reconnectSec(60)

---

reconnectWithToken

Programme une reconnexion avec recuperation prealable d'un token de reconnexion (ReloginTokenRequestMessage). Permet une reconnexion plus rapide. Le delai doit etre inferieur a 50 secondes pour que le token reste valide.

Signature: global:reconnectWithToken(s)

Paramètres:

Nom	Type	Description
s	number	Delai en secondes (max 50)

Exemple:

-- Reconnexion rapide dans 30 secondes
global:reconnectWithToken(30)

Note: Le shield doit etre actif pour utiliser les tokens de reconnexion.

---

reloadScript

Recharge le script actuel dans un nouveau thread. Attend 1 seconde avant le rechargement. Retourne false apres le lancement du rechargement.

Signature: global:reloadScript()

Retourne: boolean - false apres le rechargement

Exemple:

-- Recharger apres modification
global:printMessage("Rechargement du script...")
global:reloadScript()

---

remember

Recupere la valeur d'une variable depuis la memoire locale du compte. Retourne nil si la variable n'existe pas.

Signature: global:remember(variableName)

Paramètres:

Nom	Type	Description
variableName	string	Nom de la variable

Retourne: any - Valeur stockee ou nil

Exemple:

-- Recuperer un compteur
local fights = global:remember("fightCount")
if fights then
    global:printMessage("Combats: " .. fights)
else
    global:addInMemory("fightCount", 0)
end

---

resetCountFight

Remet a zero le compteur de combats du bot.

Signature: global:resetCountFight()

Exemple:

-- Reset au debut de session
function started()
    global:resetCountFight()
    global:resetCountGather()
end

---

resetCountGather

Remet a zero le compteur de recoltes du bot.

Signature: global:resetCountGather()

Exemple:

global:resetCountGather()
global:printMessage("Compteur de recoltes reinitialise")

---

RestartScript

Redemarre le script. Si reload est true, recharge depuis le fichier. Arrete proprement le script en cours avant de redemarrer dans un nouveau thread.

Signature: global:RestartScript(reload)

Paramètres:

Nom	Type	Description
reload	boolean	true pour recharger depuis le fichier

Exemple:

-- Redemarrer avec rechargement
global:RestartScript(true)

---

setPrivate

Active ou desactive le mode prive (statut "absent") pour le compte actuel. En mode prive, le personnage aparait comme absent pour les autres joueurs.

Signature: global:setPrivate(enabled)

Paramètres:

Nom	Type	Description
enabled	boolean	true pour activer le mode prive

Exemple:

-- Se mettre en prive pendant le bot
global:setPrivate(true)

-- Revenir disponible
global:setPrivate(false)

---

setPrivateTeam

Active ou desactive le mode prive pour tous les membres de l'equipe (sauf le chef). Fonctionne uniquement depuis le chef d'equipe.

Signature: global:setPrivateTeam(enabled)

Paramètres:

Nom	Type	Description
enabled	boolean	true pour activer le mode prive

Exemple:

if global:isBoss() then
    -- Mettre toutes les mules en prive
    global:setPrivateTeam(true)
end

---

thisAccountController

Cree et retourne un nouvel AccountController pour le compte actuel. Permet d'acceder aux fonctionnalites avancees de controle.

Signature: global:thisAccountController()

Retourne: AccountController - Nouveau controleur pour ce compte

Exemple:

local ctrl = global:thisAccountController()

---

ungroupCharacters

Retire des comptes de l'equipe Snowbot. Si usernames est nil ou vide, degroupe TOUS les membres. Met a jour le Teamcontrol et l'interface. Fonctionne uniquement depuis le chef.

Signature: global:ungroupCharacters(usernames)

Paramètres:

Nom	Type	Description
usernames	table	Liste des usernames a degrouper (optionnel - nil pour tous)

Exemple:

if global:isBoss() then
    -- Degrouper un compte specifique
    global:ungroupCharacters({"[email protected]"})

    -- Degrouper toute l'equipe
    global:ungroupCharacters()
end

---

unregisterFromKoliIfRegistered

Se desinscrit de la file d'attente Kolizeum si actuellement inscrit. Envoie GameRolePlayArenaUnregisterMessage au serveur.

Signature: global:unregisterFromKoliIfRegistered()

Retourne: boolean - true si desinscrit avec succes

Exemple:

if global:unregisterFromKoliIfRegistered() then
    global:printSuccess("Desinscrit du Kolizeum")
end

---

username

Retourne le nom d'utilisateur (email/identifiant) utilise pour la connexion au compte.

Signature: global:username()

Retourne: string - Username du compte

Exemple:

local user = global:username()
global:printMessage("Connecte avec: " .. user)

---