El scripting Lua Dofus Retro es la puerta de entrada a una automatización realmente a medida. La configuración visual cubre la gran mayoría de lo que necesita la mayoría de jugadores, pero un script Lua te permite describir exactamente qué debe hacer tu personaje, en qué orden y bajo qué condiciones. Con MoonBot dispones de un motor completo, un editor en el navegador y documentación pública: puedes pasar de cero a tu primer script funcional en una sola sesión.
Este tutorial está pensado para principiantes. No hace falta experiencia previa en programación: partimos de lo básico, explicamos cómo se organiza el motor y luego construimos juntos un bucle recolección → banco → mercadillo y una pequeña rutina de combate. Todos los ejemplos usan la sintaxis real del motor, tomada de la documentación oficial: mantenla abierta para consultar el detalle de cada función.
Por qué Lua en Dofus Retro
Lua es un lenguaje ligero, legible y diseñado para integrarse dentro de aplicaciones. Eso lo convierte en la elección ideal para pilotar un bot: la sintaxis es mínima, aprendes lo esencial en una hora y no hay nada que instalar porque todo se ejecuta en la nube de MoonBot. Escribes, ejecutas y observas los logs en directo desde el navegador, incluso desde el teléfono.
¿Por qué escribir scripting Lua Dofus Retro en lugar de hacerlo todo con el ratón en la interfaz? Porque algunas secuencias son demasiado específicas para un panel de configuración: ir a recolectar un recurso concreto, comprobar los pods, volver al banco solo a partir de un umbral, vender una lista prioritaria en el HDV y volver a empezar. Un script expresa esa lógica en pocas líneas y la repite sin errores, día y noche.
Lua complementa la interfaz, no la sustituye. Puedes reutilizar dentro de un script una configuración de combate o de venta que ya hayas preparado de forma visual y escribir solo el pegamento que orquesta todo.
El motor Lua de MoonBot
MoonBot expone 395 funciones repartidas en 20 namespaces. Un namespace es simplemente una agrupación temática: accedes a una función con la notación namespace.funcion(...). Esta organización hace que el motor sea fácil de explorar: si quieres hacer algo relacionado con el inventario miras el namespace inventory; para el mapa, map; para el mercadillo, hdv.
Estas son las grandes familias de namespaces que conviene conocer al empezar:
- structure — la anatomía de un script: las funciones
move(),bank(),phoenix()y los tipos de etapas. - fight — el combate: turno, hechizos, selección de objetivo, colocación.
- map — mapa actual, cambio de mapa, desplazamientos, zaaps.
- inventory y character — mochila, pods, equipo, nivel, kamas.
- hdv — puesta en venta, compras y precio mínimo en el HDV.
- craft y job — fabricación en serie, recetas, niveles de oficio.
- config — ajustes del script: qué recursos recolectar, umbral de banco, monstruos aceptados.
- group — líder y mulas, desplazamientos y combates coordinados.
- global, npc, exchange, quest, mount, pets, chat, merchant, fm, bot, controller — para todo lo demás.
Cada función está descrita en la documentación pública con sus parámetros y su valor de retorno. Mantén esa pestaña abierta mientras programas: es tu mejor aliada.
Steps, scripts y bucles
Antes de escribir hay que entender cómo se ejecuta un comportamiento. Una step (etapa) es una tabla Lua que indica un mapa y lo que hay que hacer en él: recolectar, combatir, vender, depositar en el banco y después salir por una dirección. Un script de MoonBot devuelve esas etapas desde tres funciones, y es el motor el que las encadena en bucle.
Este es el esqueleto de un script, tal como lo presenta la documentación:
-- Ruta de recolección: trigo alrededor de 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
-- Se ejecuta cuando los pods están llenos
function bank()
return {
{ map = "5,-17", sale = true }, -- HDV
{ map = "4,-17", npcBank = true }, -- Banco
}
end
-- Se ejecuta si el personaje muere
function phoenix()
return { { map = "10,-5", phoenix = true } }
end
Este esqueleto muestra tres ideas clave: move() describe la ruta, mapa por mapa; bank() toma el relevo cuando la mochila está llena; phoenix() lleva al personaje a la estatua del fénix si muere. No escribes ningún bucle: al llegar al final de la ruta, el motor vuelve a empezar. Fíjate en el -- que introduce un comentario: úsalo con generosidad.
El editor de scripts integrado
No necesitas un IDE externo ni configuración local. Desde el panel de MoonBot, abre el editor de scripts directamente en el navegador. Escribes tu Lua, lo guardas y lo asignas a un bot. Los logs se muestran en tiempo real: ves cada desplazamiento, cada recolección y cada error en el momento en que ocurre.

El flujo de trabajo típico es sencillo: escribir un trozo pequeño de código, ejecutarlo en una cuenta de prueba, leer los logs, corregir y repetir. Como todo está en la nube, puedes lanzar el script y cerrar el PC; el bot sigue trabajando. Es una de las grandes ventajas de una solución 100 % en la nube sin VPS.
Tu primer script Lua
Empecemos por lo más sencillo posible: mostrar un mensaje en los logs y leer el estado del personaje. Así compruebas que el editor funciona y te familiarizas con la sintaxis.
-- Mi primer script
function move()
global.printMessage("Script iniciado")
local pods = inventory.podsP() -- pods en porcentaje
local carte = map.currentMap() -- coordenadas "x,y"
global.printMessage("Pods: " .. pods .. " %")
global.printMessage("Mapa: " .. carte)
global.printMessage("Kamas: " .. character.kamas())
return {} -- ningún desplazamiento en esta prueba
end
Aquí aparecen tres nociones de Lua. local declara una variable (prioriza siempre local para evitar variables globales). El operador .. concatena cadenas y números para construir un mensaje. Por último, cada función devuelve un valor: un número para inventory.podsP(), una cadena "x,y" para map.currentMap(). Ejecuta este script: si los valores aparecen en los logs, estás listo para continuar.
Cada función usada aquí está descrita en la documentación oficial, con sus parámetros y su valor de retorno. Ante la menor duda, comprueba allí el nombre exacto antes de copiar una llamada.
Bucle recolección, banco y mercadillo
Pasemos al script que de verdad rinde: un bucle de recolección automatizado que se vacía en el banco y luego pone los objetos a la venta en el mercadillo. Es el escenario clásico para farmear kamas automáticamente y combina varios namespaces.
-- Recolección -> HDV -> banco, en bucle
function move()
config.setGatherList({ "Blé" }) -- recursos para recolectar
config.setHarvestMode("whitelist") -- solo los de la lista
config.setBankThreshold(90) -- bank() a partir del 90 % de pods
config.setAntiAggro(true) -- esquiva a los monstruos agresivos
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 }, -- venta según la pestaña HDV
{ map = "4,-17", npcBank = true }, -- depósito según la pestaña Banco
}
end
Analicemos la lógica. El motor recorre la ruta de move() y recolecta en cada mapa; al llegar al final, vuelve a empezar. En cuanto los pods superan el umbral, ejecuta bank(): pasa por el HDV, donde la venta sigue las reglas de la pestaña HDV (un kama por debajo del precio más bajo, lotes, precio mínimo), y después deposita en el banco antes de retomar la ruta. El pathfinding mundial de MoonBot gestiona los desplazamientos entre etapas, zaaps y puertas incluidos.
Para una recolección limpia, la lista de recursos (whitelist o blacklist) y la opción de esquivar a los monstruos agresivos se configuran con una línea cada una, como arriba, o desde la interfaz. En un spot disputado, sustituye gather por forcegather: el bot se queda en el mapa y recolecta cada vez que el recurso reaparece. La guía del bot de recolección detalla toda la parte de configuración visual.
Una pequeña rutina de combate
El combate es más rico, pero la lógica sigue siendo accesible. Con la táctica «Script» elegida en la pestaña Combate, el motor llama a tu función fightManagement() cada vez que es tu turno. La idea: apuntar al enemigo más débil, comprobar que el hechizo puede alcanzarlo, lanzarlo y pasar el turno.
-- Turno de combate personalizado (táctica «Script»)
local SORT = 3 -- identificador del hechizo que vas a lanzar (adáptalo)
function fightManagement()
local cible = fight.getWeakestEnemy() -- enemigo vivo con menos puntos de vida
if cible and fight.canCastSpellOnCell(SORT, cible.cellId) == "ok" then
fight.castSpell(SORT, cible.cellId)
end
fight.passTurn()
end
Reaparecen nuestros bloques: condiciones y llamadas con namespace. fight.canCastSpellOnCell() devuelve "ok" o el motivo del rechazo (alcance, línea de visión, PA insuficientes…), lo que evita lanzar un hechizo condenado al fracaso. Para un sistema de combate completo (IA configurable, colocación estratégica, desafíos, invocaciones, auto-boost), la configuración visual sigue siendo la vía más rápida; el script orquesta los casos particulares. Nuestra guía del bot de combate y subida de nivel explica cómo subir de nivel de forma eficiente.
El uso de bots va contra los términos de servicio de Dofus y siempre conlleva un riesgo de sanción que ningún ajuste elimina. Prueba en una mula y mantén franjas horarias razonables.
Buenas prácticas y depuración
Algunos hábitos hacen que tus scripts sean fiables y fáciles de corregir:
- Divide en pasos pequeños. Prueba cada bloque por separado antes de ensamblarlo todo.
- Registra mucho. Un
global.printMessage(...)en cada paso clave te muestra exactamente dónde se detiene el script. - Usa constantes. Coloca tus umbrales (pods, niveles) en variables
localal principio del archivo. - Gestiona los casos vacíos. Comprueba siempre que existe un objetivo o un recurso antes de actuar (
if x ~= nil then). - Empieza pequeño. Una zona, un recurso y luego amplías cuando funcione.
Para depurar, lee los logs en directo en el editor. Si una llamada falla, comprueba primero el nombre y los parámetros en la documentación. La mayoría de los errores de principiante vienen de un nombre de función aproximado o de un parámetro que falta. La comunidad del Discord de MoonBot también comparte muchos ejemplos listos para adaptar.
Cómo continuar
Ya tienes las bases del scripting Lua Dofus Retro: la filosofía del motor, los 20 namespaces, el papel de las steps, el editor integrado y tres scripts que cubren recolección, banco, mercadillo y combate. El siguiente paso lógico es explorar la documentación namespace por namespace y enriquecer tus bucles con tus propias condiciones.
Para comparar MoonBot con otras soluciones y entender por qué su motor Lua destaca, lee nuestro comparativa de los mejores bots de Dofus Retro 2026. Y para pasar a la práctica, crea una cuenta en el panel: el plan gratuito (hasta 5 bots, 1 bot por cada 5 invitaciones de Discord validadas) basta de sobra para escribir y probar tus primeros scripts. Consulta los precios cuando quieras escalar y únete al Discord para hablar con otros scripters.
¿Quieres ejemplos completos? El repositorio de GitHub moonbot-dofus-retro-scripts-lua reúne scripts Lua open source (MIT) listos para adaptar: combate, farmeo, recolección y desplazamiento.



