Le scripting Lua Dofus Retro est la porte d'entrée vers une automatisation vraiment sur mesure. Là où la configuration visuelle couvre l'immense majorité des besoins, un script Lua Dofus vous laisse décrire exactement ce que votre personnage doit faire, dans quel ordre et selon quelles conditions. Avec MoonBot, vous disposez d'un moteur complet, d'un éditeur intégré au navigateur et d'une documentation publique : de quoi passer de zéro à un premier script fonctionnel en une seule session.
Ce tutoriel s'adresse aux débutants. Aucune expérience préalable en programmation n'est nécessaire : nous partons des bases, nous expliquons comment le moteur s'organise, puis nous construisons ensemble une boucle récolte → banque → HDV et une petite routine de combat. Tous les exemples utilisent la syntaxe réelle du moteur, reprise de la documentation officielle : gardez-la ouverte pour le détail de chaque fonction.
Pourquoi le Lua sur Dofus Retro
Le Lua est un langage léger, lisible et conçu pour être embarqué dans des applications. C'est ce qui en fait le choix idéal pour piloter un bot : la syntaxe est minimale, on apprend l'essentiel en une heure, et il n'y a rien à installer puisque tout tourne côté cloud chez MoonBot. Vous écrivez, vous lancez, vous observez les logs en direct depuis votre navigateur, même depuis un téléphone.
Pourquoi écrire du scripting Lua Dofus Retro plutôt que de tout faire à la souris dans l'interface ? Parce que certains enchaînements sont trop spécifiques pour un panneau de configuration : aller récolter une ressource précise, vérifier ses pods, retourner en banque seulement au-delà d'un seuil, vendre au HDV une liste prioritaire, puis recommencer. Un script exprime cette logique en quelques lignes et la répète sans erreur, nuit et jour.
Le Lua complète l'interface, il ne la remplace pas. Vous pouvez réutiliser dans un script une configuration de combat ou de vente déjà préparée visuellement, et n'écrire que la « colle » qui orchestre le tout.
Le moteur Lua de MoonBot
MoonBot expose 395 fonctions réparties dans 20 namespaces. Un namespace est simplement un regroupement thématique : on accède à une fonction avec la notation namespace.fonction(...). Cette organisation rend le moteur facile à explorer : si vous cherchez à faire quelque chose lié à l'inventaire, vous regardez le namespace inventory ; pour la carte, map ; pour le marché, hdv.
Voici les grandes familles de namespaces à connaître pour débuter :
- structure — l'anatomie d'un script : les fonctions
move(),bank(),phoenix()et les types d'étapes. - fight — le combat : tour, sorts, ciblage, placement.
- map — carte courante, changement de carte, déplacements, zaaps.
- inventory et character — sac, pods, équipement, niveau, kamas.
- hdv — mise en vente, achats et prix plancher à l'Hôtel de Vente.
- craft et job — fabrication en série, recettes, niveaux de métier.
- config — réglages du script : ressources à récolter, seuil de banque, monstres acceptés.
- group — chef et mules, déplacements et combats coordonnés.
- global, npc, exchange, quest, mount, pets, chat, merchant, fm, bot, controller — pour tout le reste.
Chaque fonction est décrite dans la documentation publique avec ses paramètres et sa valeur de retour. Gardez cet onglet ouvert pendant que vous codez : c'est votre meilleur allié.
Steps, scripts et boucles
Avant d'écrire, il faut comprendre comment un comportement s'exécute. Une step (étape) est une table Lua qui désigne une carte et ce qu'il faut y faire : récolter, combattre, vendre, déposer en banque, puis sortir par une direction. Un script MoonBot renvoie ces étapes depuis trois fonctions, et c'est le moteur qui les enchaîne en boucle.
Voici le squelette d'un script, tel que le présente la documentation :
-- Trajet de récolte : blé autour d'Astrub
function move()
return {
{ map = "5,-24", path = "right", gather = true },
{ map = "6,-24", path = "right", gather = true },
{ map = "7,-24", path = "bottom", gather = true },
}
end
-- Appelée quand les pods sont pleins
function bank()
return {
{ map = "5,-17", sale = true }, -- HDV
{ map = "4,-17", npcBank = true }, -- Banque
}
end
-- Appelée si le personnage meurt
function phoenix()
return { { map = "10,-5", phoenix = true } }
end
Ce squelette illustre trois idées clés : move() décrit le trajet, carte par carte ; bank() prend le relais quand le sac est plein ; phoenix() ramène le personnage à la statue du phénix s'il meurt. Vous n'écrivez pas de boucle : arrivé au bout du trajet, le moteur recommence. Notez le -- qui introduit un commentaire : utilisez-le abondamment.
L'éditeur de scripts intégré
Pas besoin d'IDE externe ni de configuration locale. Depuis le tableau de bord MoonBot, ouvrez l'éditeur de scripts directement dans le navigateur. Vous y écrivez votre Lua, vous le sauvegardez, et vous l'assignez à un bot. Les logs s'affichent en temps réel : vous voyez chaque déplacement, chaque récolte et chaque erreur au moment où elle se produit.

Le flux de travail typique est simple : écrire un petit bout de code, le lancer sur un compte de test, lire les logs, corriger, recommencer. Comme tout est cloud, vous pouvez lancer le script puis fermer votre PC ; le bot continue. C'est l'un des grands avantages d'une solution 100 % cloud sans VPS.
Votre premier script Lua
Commençons par le plus simple possible : afficher un message dans les logs et lire l'état du personnage. Cela vous permet de vérifier que l'éditeur fonctionne et de vous familiariser avec la syntaxe.
-- Mon tout premier script
function move()
global.printMessage("Script démarré")
local pods = inventory.podsP() -- pods en pourcentage
local carte = map.currentMap() -- coordonnées "x,y"
global.printMessage("Pods : " .. pods .. " %")
global.printMessage("Carte : " .. carte)
global.printMessage("Kamas : " .. character.kamas())
return {} -- aucun déplacement pour ce test
end
Trois notions de Lua apparaissent ici. local déclare une variable (toujours préférer local pour éviter les variables globales). L'opérateur .. concatène des chaînes et des nombres pour construire un message. Enfin, chaque fonction renvoie une valeur : un nombre pour inventory.podsP(), une chaîne "x,y" pour map.currentMap(). Lancez ce script : si les valeurs s'affichent dans les logs, vous êtes prêt pour la suite.
Chaque fonction utilisée ici est décrite dans la documentation officielle, avec ses paramètres et sa valeur de retour. Au moindre doute, vérifiez-y le nom exact avant de copier un appel.
Boucle récolte, banque et HDV
Passons au script qui rapporte vraiment : une boucle de récolte automatisée qui se vide en banque puis met en vente au HDV. C'est le scénario classique pour farmer des kamas automatiquement et il combine plusieurs namespaces.
-- Récolte -> HDV -> banque, en boucle
function move()
config.setGatherList({ "Blé" }) -- ressources à récolter
config.setHarvestMode("whitelist") -- seulement celles de la liste
config.setBankThreshold(90) -- bank() dès 90 % de pods
config.setAntiAggro(true) -- évite les monstres agressifs
return {
{ map = "5,-24", path = "right", gather = true },
{ map = "6,-24", path = "right", gather = true },
{ map = "7,-24", path = "bottom", gather = true },
}
end
function bank()
return {
{ map = "5,-17", sale = true }, -- vente selon l'onglet HDV
{ map = "4,-17", npcBank = true }, -- dépôt selon l'onglet Banque
}
end
Décortiquons la logique. Le moteur parcourt le trajet de move() et récolte chaque carte ; arrivé au bout, il recommence. Dès que les pods dépassent le seuil, il exécute bank() : passage à l'HDV, où la vente suit les règles de l'onglet HDV (un kama sous le prix le plus bas, lots, prix plancher), puis dépôt en banque, avant de reprendre le trajet. Le pathfinding mondial de MoonBot gère les déplacements entre les étapes, zaaps et portes compris.
Pour une récolte propre, la liste de ressources (whitelist ou blacklist) et l'évitement des monstres agressifs se règlent en une ligne chacun, comme ci-dessus, ou depuis l'interface. Sur un spot disputé, remplacez gather par forcegather : le bot reste sur la carte et récolte à chaque repousse. Le guide du bot de récolte détaille toute la partie configuration visuelle.
Une petite routine de combat
Le combat est plus riche, mais la logique reste accessible. Avec la tactique « Script » choisie dans l'onglet Combat, le moteur appelle votre fonction fightManagement() à chaque fois que c'est votre tour. L'idée : cibler l'ennemi le plus faible, vérifier que le sort peut l'atteindre, le lancer, puis passer le tour.
-- Tour de combat personnalisé (tactique « Script »)
local SORT = 3 -- identifiant du sort à lancer (à adapter)
function fightManagement()
local cible = fight.getWeakestEnemy() -- ennemi vivant avec le moins de PV
if cible and fight.canCastSpellOnCell(SORT, cible.cellId) == "ok" then
fight.castSpell(SORT, cible.cellId)
end
fight.passTurn()
end
On retrouve nos briques : des conditions et des appels namespacés. fight.canCastSpellOnCell() renvoie "ok" ou la raison du refus (portée, ligne de vue, PA insuffisants…), ce qui évite de lancer un sort voué à l'échec. Pour un système de combat complet (IA configurable, placement stratégique, défis, invocations, auto-boost), la configuration visuelle reste la voie la plus rapide ; le script sert à orchestrer des cas particuliers. Notre guide du bot de combat et d'XP explique comment monter en niveau efficacement.
Le botting est contraire aux CGU de Dofus et comporte toujours un risque de sanction, qu'aucun réglage ne supprime. Testez sur une mule, gardez des plages horaires raisonnables.
Bonnes pratiques et debug
Quelques habitudes rendent vos scripts fiables et faciles à corriger :
- Découpez en petites étapes. Testez chaque bloc isolément avant de tout assembler.
- Loggez beaucoup. Un
global.printMessage(...)à chaque étape clé vous montre exactement où le script s'arrête. - Utilisez des constantes. Mettez vos seuils (pods, niveaux) dans des variables
localen haut du fichier. - Gérez les cas vides. Vérifiez toujours qu'une cible ou une ressource existe avant d'agir (
if x ~= nil then). - Commencez petit. Une zone, une ressource, puis on élargit une fois que ça marche.
Pour le debug, lisez les logs en direct dans l'éditeur. Si un appel échoue, vérifiez d'abord le nom et les paramètres dans la documentation. La plupart des erreurs de débutant viennent d'un nom de fonction approximatif ou d'un paramètre manquant. La communauté du Discord MoonBot partage aussi de nombreux exemples prêts à adapter.
Pour aller plus loin
Vous avez maintenant les fondations du scripting Lua Dofus Retro : la philosophie du moteur, les 20 namespaces, le rôle des steps, l'éditeur intégré et trois scripts qui couvrent récolte, banque, HDV et combat. La suite logique est d'explorer la documentation namespace par namespace et d'enrichir vos boucles avec vos propres conditions.
Pour comparer MoonBot aux autres solutions et comprendre pourquoi son moteur Lua se distingue, lisez notre comparatif des meilleurs bots Dofus Retro 2026. Et pour passer à la pratique, créez un compte sur le tableau de bord : l'offre gratuite (jusqu'à 5 bots, 1 bot pour 5 invitations Discord validées) suffit largement à écrire et tester vos premiers scripts. Consultez les tarifs quand vous voudrez passer à l'échelle, et rejoignez le Discord pour échanger avec d'autres scripteurs.
Envie d'exemples complets ? Le dépôt GitHub moonbot-dofus-retro-scripts-lua rassemble des scripts Lua open source (MIT) prêts à adapter : combat, farm, récolte et déplacement.



