Documentation

Scripts Lua

Référence complète des scripts Onda3 : structure d'un script, étapes, transitions, récolte, combats, banque, état du jeu et fonctions disponibles.

Premiers pas

Un script Onda3 est un fichier Lua qui décrit, carte par carte, le travail d'un personnage : où récolter, où combattre et comment rejoindre la banque. Le script ne pilote pas le jeu directement. Il décrit un itinéraire, et Onda3 calcule les déplacements et joue les actions.

Emplacement des scripts

Les scripts se rangent dans le dossier %LocalAppData%\Onda3\scripts. Le bouton « Ouvrir le dossier des scripts » de l'application y mène directement. Les sous-dossiers sont parcourus : chaque fichier .lua apparaît dans la liste des scripts proposés pour un bot.

Un premier script

API_VERSION = 1

GATHER = { 1 }
BANK_THRESHOLD = 90

function move()
    return {
        { map = 188746753, gather = true, path = "top" },
        { map = "7,-22", gather = true, path = 188746753 },
        { map = "/", path = 188746753 }
    }
end

function bank()
    return {
        { map = 192415750, npcBank = true },
        { map = "/", path = 192415750 }
    }
end

Sur la carte 188746753, le bot récolte puis passe sur la carte du haut. Sur la carte de coordonnées 7,-22, il récolte puis revient sur la première carte. Depuis n'importe quelle autre carte, l'étape "/" le ramène au début de l'itinéraire. Quand l'inventaire atteint 90 % des pods, le bot suit bank(), dépose tout à la banque, puis reprend move().

Trouver les identifiants

L'onglet Carte de l'application affiche l'identifiant de la carte actuelle. Au survol, il indique aussi le numéro de chaque cellule, l'identifiant des éléments interactifs et celui des PNJ présents. Les identifiants d'objets, de monstres et de métiers sont ceux des données de Dofus.

Format du fichier

  • Extension .lua et encodage UTF-8.
  • Taille maximale de 256 Kio.
  • Les messages d'erreur sont en anglais et nomment le champ en cause, par exemple move[3].path.

Fonctionnement

Le script est chargé une seule fois, au démarrage du bot. Ensuite, à chaque arrivée sur une carte, Onda3 appelle move(), ou bank() pendant un passage à la banque, avec l'état à jour du personnage. L'itinéraire renvoyé peut donc changer d'une carte à l'autre.

Sur chaque carte

  1. Entretien. Points de caractéristiques selon les options du bot, récompenses de succès, puis ouverture des sacs (OPEN_BAGS), objets à utiliser (AUTO_USE), objets à détruire (AUTO_DELETE) et équipement (EQUIP).
  2. Choix de l'itinéraire. Le bot passe sur bank() dès que son inventaire, ou celui d'un membre de son groupe, atteint BANK_THRESHOLD.
  3. Recherche de l'étape. Une étape avec l'identifiant de la carte est prioritaire, puis une étape avec ses coordonnées, puis l'étape "/". La recherche part de l'étape en cours : une même carte peut donc apparaître plusieurs fois dans un itinéraire.
  4. Actions. Dans l'ordre : récolte, combats, dépôt, puis changement de carte.

Un court délai aléatoire sépare deux étapes. Après un combat qui déplace le personnage, l'itinéraire reprend depuis la carte d'arrivée. Après un dépôt réussi, le bot reprend move() depuis la première étape.

Structure d'un script

Tout le fichier est exécuté au chargement. Les variables globales définies hors des fonctions servent de réglages de départ.

ÉlémentStatutRôle
API_VERSION = 1ObligatoireVersion de l'interface de script. La seule valeur acceptée est 1.
function move()ObligatoireRenvoie l'itinéraire principal.
function bank()FacultativeRenvoie l'itinéraire de banque. Sans elle, le script s'arrête dès que l'inventaire atteint le seuil de banque.
Variables globalesFacultativesRéglages de récolte, de combat, de banque et d'inventaire.

Itinéraire nommé

move() et bank() renvoient soit une liste d'étapes, soit une table avec un nom et ses étapes. Le nom s'affiche dans le journal du bot à chaque changement d'itinéraire.

function move()
    return {
        name = "Champs d'Astrub",
        steps = {
            { map = 188746753, gather = true, path = "top" },
            { map = "/", path = 188746753 }
        }
    }
end

Réglages dynamiques

Les variables globales sont relues après chaque appel de move() et bank(). Une fonction peut donc ajuster les réglages selon l'état du personnage avant de renvoyer l'itinéraire.

MONSTERS_BY_LEVEL = {
    { level = 1, min = 1, max = 2 },
    { level = 20, min = 2, max = 4 },
    { level = 60, min = 2, max = 6 }
}

function applyMonsterLimits()
    for _, tier in ipairs(MONSTERS_BY_LEVEL) do
        if character.level >= tier.level then
            MIN_MONSTERS = tier.min
            MAX_MONSTERS = tier.max
        end
    end
end

function move()
    applyMonsterLimits()
    return {
        { map = 188746759, fight = true, path = 188746758 },
        { map = 188746758, fight = true, path = 188746759 },
        { map = "/", path = 188746759 }
    }
end

Étapes

Une étape est une table qui désigne une carte et ce qui s'y passe. Les champs inconnus provoquent une erreur, ce qui évite les fautes de frappe silencieuses.

ChampValeurRôle
mapIdentifiant, "x,y" ou "/"Carte concernée. Obligatoire.
gathertrueRécolte les ressources de GATHER présentes sur la carte.
forceGathertrueRécolte puis attend la repousse sur place, sans quitter la carte.
fighttrueAttaque les groupes de monstres acceptés par les réglages de combat.
forceFighttrueAttend qu'un groupe accepté apparaisse avant de combattre.
npcBanktrueDépose à la banque du PNJ banquier de la carte. Itinéraire bank() uniquement.
chestTableDépose dans un coffre de maison. Itinéraire bank() uniquement.
pathDirection ou identifiantChange de carte par un bord ou rejoint une carte donnée.
zaapIdentifiantSe téléporte au zaap de cette carte.
interactCellule ou tableUtilise un élément interactif qui mène à une autre carte.
dialogTableParle à un PNJ qui déplace le personnage.
houseTableEntre dans une maison.
moveToTableMarche sur une cellule qui change de carte.
useItemIdentifiant ou tableUtilise un objet de téléportation.

Désigner la carte

  • Identifiant : map = 188746753, ou le même nombre entre guillemets.
  • Coordonnées : map = "7,-22" ou map = "[7,-22]". Les coordonnées désignent une carte du monde de l'itinéraire, déduit de la destination de l'étape "/", sinon du premier identifiant de carte de l'itinéraire. Plusieurs cartes peuvent partager des coordonnées dans un même monde ; l'identifiant reste le choix le plus sûr.
  • Toute autre carte : map = "/". Une seule étape de ce type par itinéraire. Elle doit porter une destination (path avec un identifiant, zaap ou useItem) et aucune autre action. Elle sert à ramener le personnage sur l'itinéraire depuis n'importe où.

Règles

  • Une étape fait au moins une chose : récolte, combat, dépôt ou transition.
  • Une seule transition par étape : path, zaap, interact, dialog, house, moveTo ou useItem.
  • La récolte et les combats ne sont acceptés que dans move().
  • Les dépôts (npcBank, chest) ne sont acceptés que dans bank(), sans transition : après un dépôt, le bot reprend move().
  • gather et forceGather s'excluent, tout comme fight et forceFight. forceGather ne se combine pas avec un combat, car la récolte ne quitte jamais la carte.
  • La destination d'une transition doit différer de la carte de l'étape.
  • Les listes Lua, comme les étapes ou les identifiants, commencent à 1 et ne contiennent pas de trou.

Transitions

La transition est la dernière action d'une étape. Onda3 vérifie la carte d'arrivée : si elle ne correspond pas à la destination attendue, le script s'arrête avec une erreur.

Bord de carte et trajet

path accepte une direction, "top", "bottom", "left" ou "right", pour sortir par un bord de la carte. Avec un identifiant de carte, Onda3 calcule le trajet jusqu'à cette carte, qu'elle soit voisine ou plus lointaine.

{ map = 188746753, gather = true, path = "top" },
{ map = 191105026, path = 192415750 },
{ map = "/", path = 188746759 }

Zaap

zaap prend l'identifiant de la carte du zaap de destination. La téléportation part de n'importe quelle carte qui l'autorise ; si la carte actuelle l'interdit, Onda3 marche d'abord jusqu'à la carte la plus proche qui le permet. Le personnage doit connaître le zaap de destination et avoir les kamas du trajet.

{ map = 142090251, gather = true, zaap = 88082704 },
{ map = "/", zaap = 191105026 }

Élément interactif

interact utilise un élément interactif qui fait changer de carte : porte, échelle, trappe. La forme courte donne la cellule de l'élément. La forme complète précise aussi la compétence à utiliser quand l'élément en propose plusieurs, et la carte attendue à l'arrivée.

{ map = "19,-31", gather = true, interact = 50 },
{ map = 73400323, interact = { cell = 330, skill = 184, destination = 84935175 } }

Dialogue avec un PNJ

dialog ouvre un dialogue avec un PNJ de la carte et répond à ses questions jusqu'au déplacement du personnage.

ChampStatutRôle
npcObligatoireIdentifiant du PNJ.
actionFacultatifAction du PNJ à lancer. Par défaut 3, l'action « Parler ».
repliesObligatoirePour chaque identifiant de question, la liste des réponses acceptées.
destinationObligatoireCarte attendue à la fin du dialogue.
{ map = 121375235, dialog = {
    npc = 173,
    replies = { [9826] = { 10533 } },
    destination = 120063489
} }

À chaque question reçue, Onda3 répond avec une réponse de la liste associée à son identifiant, parmi celles que le PNJ propose. Les identifiants des questions et des réponses apparaissent dans l'onglet Réseau de l'application, dans les messages de dialogue échangés avec le serveur.

Maison

house entre dans une maison par sa porte.

ChampStatutRôle
cellObligatoireCellule de la porte.
ownerObligatoireNom du propriétaire, sous la forme "Pseudo#1234".
destinationFacultatifCarte attendue à l'intérieur.
codeFacultatifCode de la porte, de 1 à 8 chiffres entre guillemets.
{ map = 73400833, house = { cell = 150, owner = "Pseudo#1234", destination = 84935169, code = "1234" } }

Cellule de changement de carte

moveTo fait marcher le personnage sur une cellule qui déclenche un changement de carte, comme un escalier ou un passage. cells liste les cellules possibles et destination, obligatoire, la carte attendue.

{ map = 150208516, moveTo = { cells = { 346, 404 }, destination = 150209538 } }

Objet de téléportation

useItem utilise un objet qui téléporte le personnage, comme une potion de rappel. La forme complète précise la carte attendue. Seuls les objets de téléportation sont acceptés, et cette transition est autorisée sur l'étape "/".

{ map = "/", useItem = 548 },
{ map = 191105026, useItem = { item = 548, destination = 192415750 } }

L'identifiant 548 sert seulement d'exemple : il faut indiquer l'identifiant de l'objet de téléportation réellement présent dans l'inventaire.

Récolte

Sur une étape avec gather, le bot récolte les ressources disponibles de la carte, de la plus proche à la plus éloignée, et ignore celles qu'il ne peut pas atteindre. La récolte s'arrête dès que l'inventaire atteint BANK_THRESHOLD.

VariableDéfautRôle
GATHERListe videTypes de ressources à récolter. Vide ou absente : toutes les ressources que le personnage sait récolter.

gather ou forceGather

  • gather = true récolte ce qui est disponible, puis passe à la suite de l'étape.
  • forceGather = true reste sur la carte et attend la repousse des ressources, jusqu'au seuil de banque. L'étape n'a alors ni combat ni transition utile.

Quelques types de ressources

GATHER attend des types d'éléments interactifs, pas des identifiants d'objets. Quelques valeurs courantes :

RessourceTypeRessourceType
Frêne1Riz111
Edelweiss61Graine de pandouille112
Orchidée freyesque68Silicate114
Bombu98Kaliptus121
Tremble133Ginseng256
Belladone257Mandragore258
Maïs260

Au survol d'une ressource, l'onglet Carte de l'application affiche son nom.

Combats

Sur une étape avec fight, le bot attaque le groupe accepté le plus proche, puis recommence tant qu'il en reste. Le combat lui-même est joué par l'IA, réglée dans l'onglet Combat de l'application. En groupe, le chef attend ses membres avant d'attaquer.

VariableDéfautRôle
MIN_MONSTERS1Nombre minimal de monstres dans le groupe.
MAX_MONSTERS8Nombre maximal de monstres dans le groupe.
MIN_GROUP_LEVELAucunNiveau minimal du groupe, égal à la somme des niveaux de ses monstres.
MAX_GROUP_LEVELAucunNiveau maximal du groupe.
FORBIDDEN_MONSTERSListe videMonstres à éviter : un groupe qui en contient un est ignoré.
REQUIRED_MONSTERSListe videSi la liste n'est pas vide, seuls les groupes qui contiennent au moins un de ces monstres sont attaqués.
MIN_LIFE_PERCENT80Avant d'attaquer, le personnage régénère sa vie jusqu'à ce pourcentage.
REGEN_ITEMSListe videObjets de soin consommés avant la régénération naturelle, en limitant le gaspillage.

fight ou forceFight

  • fight = true combat les groupes acceptés présents, puis passe à la suite de l'étape.
  • forceFight = true attend qu'un groupe accepté apparaisse si la carte n'en contient aucun, combat, puis passe à la suite quand il n'en reste plus. L'attente s'interrompt au seuil de banque, et l'étape s'arrête après 5 tentatives d'attaque ratées d'affilée.

Contrôles

  • MIN_MONSTERS ne peut pas dépasser MAX_MONSTERS, ni MIN_GROUP_LEVEL dépasser MAX_GROUP_LEVEL.
  • Un monstre ne peut pas figurer à la fois dans FORBIDDEN_MONSTERS et REQUIRED_MONSTERS.
  • Chaque objet de REGEN_ITEMS doit rendre de la vie.
MIN_MONSTERS = 2
MAX_MONSTERS = 5
MAX_GROUP_LEVEL = 120
FORBIDDEN_MONSTERS = { 1050 }
MIN_LIFE_PERCENT = 70

Banque et inventaire

Quand l'inventaire du personnage, ou celui d'un membre de son groupe, atteint BANK_THRESHOLD, le bot quitte move() et suit bank() jusqu'à une étape de dépôt. Tous les objets non équipés sont déposés, sauf ceux gardés par BANK_KEEP. En groupe, les membres appliquent les règles de banque et d'inventaire du chef.

VariableDéfautRôle
BANK_THRESHOLD90Pourcentage de pods, de 1 à 100, qui déclenche le passage à la banque.
BANK_KEEPAucunQuantités à garder sur soi, sous la forme { [objet] = quantité }. Le surplus est déposé, le manque est retiré de la banque.
BANK_KAMASAucunNombre exact de kamas à garder sur soi. Le surplus est déposé, le manque est retiré.
OPEN_BAGSfalseOuvre les sacs de ressources présents dans l'inventaire.
AUTO_USEListe videObjets utilisés dès qu'ils se trouvent dans l'inventaire, pile entière.
AUTO_DELETEListe videObjets détruits dès qu'ils se trouvent dans l'inventaire.
EQUIPListe videObjets équipés dès qu'ils se trouvent dans l'inventaire. Un objet listé deux fois est équipé deux fois, pour deux anneaux par exemple.

Étapes de dépôt

  • npcBank = true dépose auprès du banquier présent sur la carte.
  • chest = { cell = 232, code = "1234" } dépose dans le coffre d'une maison. code est facultatif, de 1 à 8 chiffres entre guillemets.

Les retraits de BANK_KEEP restent limités pour que l'inventaire reste sous le seuil de banque. Si l'inventaire dépasse encore ce seuil après le dépôt, le script s'arrête avec une erreur.

KEY = 1568
BANK_KEEP = { [KEY] = 20 }
BANK_KAMAS = 5000
OPEN_BAGS = true
AUTO_DELETE = { 2550 }

Contrôles

  • Un objet de AUTO_USE doit pouvoir s'utiliser, ne doit pas téléporter le personnage et ne doit pas figurer dans AUTO_DELETE.
  • Les objets de téléportation s'utilisent avec la transition useItem.

État du jeu

Six tables décrivent l'état du personnage au moment de l'appel. Elles ne sont lisibles que dans move(), bank() et les fonctions qu'elles appellent. Un champ inconnu provoque une erreur qui liste les champs disponibles.

character

nameNom du personnage.
breedIdentifiant de la classe.
levelNiveau.
life, maxLife, lifePercentPoints de vie actuels, maximum et pourcentage.
energy, maxEnergy, energyPercentÉnergie actuelle, maximum et pourcentage.
xpPercentProgression vers le niveau suivant, en pourcentage.
kamasKamas dans l'inventaire.
statsPointsPoints de caractéristiques non dépensés.

jobs

jobs[identifiant] renvoie le métier correspondant, avec level et xpPercent. Un métier non appris renvoie le niveau 0.

if jobs[28].level >= 200 then
    stop("Paysan niveau 200")
end

inventory

pods, maxPods, podsPercentPoids porté, maximum et pourcentage.
inventory.count(objet)Quantité de l'objet dans l'inventaire.
inventory.has(objet)true si l'objet est présent.

map

idIdentifiant de la carte.
x, yCoordonnées de la carte.
worldMapMonde de la carte.
subArea, areaSous-zone et zone.
monsterGroupsListe des groupes de monstres présents. Chaque groupe a count, level et monsters, une liste de monstres avec id et level.

party

inPartytrue si le personnage est en groupe.
isLeadertrue si le personnage mène le groupe.
sizeNombre de membres, 1 hors groupe.
minLevel, maxLevelNiveaux extrêmes du groupe, personnage compris. Hors groupe, le niveau du personnage.

session

minutesMinutes passées en ligne depuis la connexion.
fightsWon, fightsLostCombats gagnés et perdus.
xpExpérience gagnée.
session.harvested(objet)Quantité récoltée de l'objet.

Fonctions disponibles

print(...)Écrit un message dans le journal du bot, précédé de « Script : ».
stop(raison)Arrête le script. La raison, facultative, s'affiche dans le journal après « Script terminé : ».
require(nom)Charge un module, voir Mémoire et modules.
storageTable conservée d'une session à l'autre, voir Mémoire et modules.

Bibliothèque Lua

  • assert, error, ipairs, next, pairs, select, tonumber, tostring et type.
  • Toute la bibliothèque math.
  • os.clock, os.date, os.difftime et os.time.

Le reste de la bibliothèque standard n'est pas disponible, notamment string, table, io, pcall, load et setmetatable. Pour ajouter une valeur à une liste sans table.insert :

EQUIP = {}
EQUIP[#EQUIP + 1] = 8229

Mémoire et modules

storage

storage est une table conservée par personnage et par script, dans %LocalAppData%\Onda3\storage\<identifiant du personnage>\<script>.json. Elle est relue au chargement du script et enregistrée après chaque appel qui la modifie.

  • Valeurs acceptées : booléens, nombres, textes et tables.
  • Clés acceptées : textes et nombres entiers. Un texte qui ressemble à un nombre, comme "12", est refusé comme clé.
  • Nombres entiers jusqu'à 9 007 199 254 740 991.
  • 64 Kio au total, 16 niveaux d'imbrication au plus.
function move()
    if storage.phase == nil then
        storage.phase = 1
    end

    if storage.phase == 1 and jobs[28].level >= 20 then
        storage.phase = 2
        print("Passage à la phase 2")
    end

    if storage.phase == 1 then
        return astrubFields()
    end

    return caniaFields()
end

require

require("zones.astrub") charge le fichier zones/astrub.lua du dossier des scripts. Pour un script placé hors de ce dossier, le chemin part du dossier du script. Le nom s'écrit sans l'extension .lua.

  • Un module est chargé une seule fois par script ; les appels suivants renvoient la même valeur.
  • Le module partage les variables globales du script.
  • La valeur renvoyée par le module est celle de require, ou true s'il ne renvoie rien.
  • Deux modules qui se chargent mutuellement provoquent une erreur. 64 modules au plus.

Fichier zones/astrub.lua :

local astrub = {}

function astrub.bank()
    return {
        { map = 192415750, npcBank = true },
        { map = "/", path = 192415750 }
    }
end

return astrub

Script principal :

local astrub = require("zones.astrub")

function bank()
    return astrub.bank()
end

Limites

Taille d'un fichier256 Kio.
Durée d'un appel2 secondes pour le chargement et pour chaque appel de move() ou bank().
Instructions par appelEnviron 1 000 000.
Éléments par liste4 096.
Modules64.
storage64 Kio et 16 niveaux d'imbrication.

Erreurs fréquentes

MessageCause et solution
Map … is missing from moveAucune étape ne correspond à la carte actuelle. Ajouter cette carte, ou une étape "/" avec une destination.
Inventory threshold reached: add a bank table to continueLe seuil de banque est atteint et le script n'a pas de bank().
specify only one transitionL'étape contient plusieurs transitions. En garder une seule.
unknown field 'gahter'Faute de frappe dans un nom de champ. Le message liste les champs acceptés.
expected true or false (without quotes)Un booléen écrit entre guillemets, comme gather = "true".
character: only available inside move() and bank()Lecture de l'état du jeu en dehors de ces fonctions, par exemple en haut du fichier.
exceeded the 2-second limit, instruction limit exceededUne boucle tourne trop longtemps.
Transition from … was not confirmedLa transition n'a pas mené à la carte attendue. Vérifier la destination ou la cellule.
Deposit completed, but … above the bank thresholdL'inventaire reste trop lourd après le dépôt, souvent à cause de quantités trop élevées dans BANK_KEEP.
useItem: item … does not teleport the characterL'objet indiqué n'est pas un objet de téléportation.

Exemples complets

Récolte avec retour par zaap

API_VERSION = 1

GATHER = { 38, 43, 45, 39, 42 }
BANK_THRESHOLD = 90
OPEN_BAGS = true

function move()
    return {
        name = "Céréales d'Astrub",
        steps = {
            { map = 189793289, gather = true, path = 189793801 },
            { map = 189793801, gather = true, path = 188746241 },
            { map = 188746241, gather = true, path = 188746753 },
            { map = 188746753, gather = true, path = 189793289 },
            { map = "/", path = 189793289 }
        }
    }
end

function bank()
    return {
        { map = 192415750, npcBank = true },
        { map = 191105026, path = 192415750 },
        { map = "/", zaap = 191105026 }
    }
end

Combats qui suivent la progression

API_VERSION = 1

BANK_THRESHOLD = 90
MIN_LIFE_PERCENT = 70
OPEN_BAGS = true

PIOU_SET = {
    { id = 8247, level = 7 },
    { id = 8241, level = 8 },
    { id = 8236, level = 9 },
    { id = 8229, level = 10 }
}

function applyEquipment()
    EQUIP = {}
    BANK_KEEP = {}
    for _, piece in ipairs(PIOU_SET) do
        if character.level >= piece.level then
            EQUIP[#EQUIP + 1] = piece.id
        else
            BANK_KEEP[piece.id] = 1
        end
    end
end

function move()
    applyEquipment()
    MAX_MONSTERS = character.level >= 20 and 4 or 2
    return {
        { map = 188746759, fight = true, path = 188746758 },
        { map = 188746758, fight = true, path = 188746757 },
        { map = 188746757, fight = true, path = 188746759 },
        { map = "/", path = 188746759 }
    }
end

function bank()
    return {
        { map = 192415750, npcBank = true },
        { map = "/", path = 192415750 }
    }
end

Les pièces de panoplie accessibles sont équipées, les autres restent dans l'inventaire jusqu'au niveau requis grâce à BANK_KEEP.

Donjon avec dialogue et clés

API_VERSION = 1

KEY = 1568
BANK_AT = 85
ROTABLA = 173
DUNGEON_SUBAREA = 82
ASTRUB_AREA = 18
ASTRUB_ZAAP = 191105026
ASTRUB_BANK = 192415750
ENTRANCE = 120063489
FIRST_ROOM = 121373185
EXIT_ROOM = 121375235

MIN_LIFE_PERCENT = 80
OPEN_BAGS = true
BANK_KEEP = { [KEY] = 20 }

function inDungeon()
    return map.subArea == DUNGEON_SUBAREA
end

function toEntrance()
    if map.area == ASTRUB_AREA then
        return { map = "/", path = ENTRANCE }
    end
    return { map = "/", zaap = ASTRUB_ZAAP }
end

function move()
    if inDungeon() then
        BANK_THRESHOLD = 100
    else
        BANK_THRESHOLD = BANK_AT
    end

    if not inDungeon() and inventory.count(KEY) == 0 and inventory.podsPercent < BANK_AT then
        stop("Plus de clé pour le donjon")
    end

    return {
        { map = FIRST_ROOM, fight = true },
        { map = 121374209, fight = true },
        { map = 121375233, fight = true },
        { map = 121373187, fight = true },
        { map = 121374211, fight = true },
        { map = EXIT_ROOM, dialog = {
            npc = ROTABLA,
            replies = { [9826] = { 10533 } },
            destination = ENTRANCE
        } },
        { map = ENTRANCE, dialog = {
            npc = ROTABLA,
            replies = { [646] = { 10529 }, [17039] = { 20330, 20332 }, [55075] = { 74064 }, [55077] = { 74062 } },
            destination = FIRST_ROOM
        } },
        toEntrance()
    }
end

function bank()
    return {
        { map = ASTRUB_BANK, npcBank = true },
        { map = ASTRUB_ZAAP, path = ASTRUB_BANK },
        { map = "/", zaap = ASTRUB_ZAAP }
    }
end

Dans le donjon, le seuil de banque passe à 100 % pour ne jamais interrompre une salle. Hors du donjon, le script s'arrête quand il n'y a plus de clé, et la banque en garde 20 sur le personnage.

Dépôt dans un coffre de maison

function bank()
    return {
        { map = 73400833, house = { cell = 150, owner = "Pseudo#1234", destination = 84935169, code = "1234" } },
        { map = 84935169, chest = { cell = 232, code = "1234" } },
        { map = "/", zaap = 73400320 }
    }
end