📜 Scripting

Scripting Lua pour Dofus Retro : tutoriel pour débutants

Editeur de script Lua MoonBot pour Dofus Retro affichant un script de récolte et les logs du bot
L'éditeur de scripts Lua intégré au tableau de bord MoonBot.
Sommaire
  1. Pourquoi le Lua sur Dofus Retro
  2. Le moteur Lua de MoonBot
  3. Steps, scripts et boucles
  4. L'éditeur de scripts intégré
  5. Votre premier script Lua
  6. Boucle récolte, banque et HDV
  7. Une petite routine de combat
  8. Bonnes pratiques et debug
  9. Pour aller plus loin

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.

Vue d'un bot MoonBot sur Dofus Retro avec les logs en direct et le chat pendant l'exécution d'un script Lua
Suivi en direct d'un bot exécutant un script, avec logs et chat.

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 local en 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.

Questions fréquentes

Faut-il savoir coder pour utiliser MoonBot ?

Non. La majorité des tâches se configurent visuellement sans une ligne de code. Le Lua sert uniquement quand vous voulez une logique sur mesure que l'interface ne couvre pas.

Quel langage utilise MoonBot pour les scripts ?

MoonBot utilise le Lua, un langage léger et simple à apprendre. Le moteur expose 395 fonctions réparties en 20 namespaces couvrant le combat, la carte, l'inventaire, le HDV, les métiers et plus.

Où trouver la documentation des fonctions Lua ?

La documentation publique complète est sur doc.moon-bot.io. Elle liste chaque namespace, chaque fonction, ses paramètres et des exemples.

Puis-je tester un script sans risque pour mon compte ?

Testez d'abord sur un compte secondaire ou une mule, sur de petites portions de carte. Le botting reste contraire aux CGU du jeu et comporte toujours un risque de sanction.

Le script Lua remplace-t-il la configuration visuelle ?

Non, il la complète. Vous pouvez appeler des fonctions de combat, de récolte ou de HDV déjà configurées dans l'interface depuis votre script pour combiner le meilleur des deux.

Combien de temps pour écrire un premier script utile ?

Une boucle récolte vers banque tient en quelques lignes. En une heure de prise en main avec la doc, un débutant écrit déjà un script fonctionnel.

Prêt à automatiser Dofus Retro ?

Créez un compte, ajoutez vos personnages et lancez votre premier script en quelques minutes. L’offre gratuite débloque jusqu’à 5 bots grâce aux invitations Discord, sans rien installer.

Commencer gratuitementVoir les tarifs

Automatisez votre jeu

Le bot Dofus le plus complet

100% cloud : rien à installer, sans VPS. Combat, récolte, HDV, craft, multi-comptes et scripts Lua.

  • 100% cloud — rien à installer
  • Gratuit jusqu’à 5 bots
Commencer gratuitement
← Retour au blog