Quando as abas não bastam, escreva um script. O DrenoxBot roda scripts Lua com a sua própria API: eventos, timers, HUD na tela do jogo e janelas próprias. Scripts escritos para o ZeroBot também rodam, sem adaptação.

Onde ficam os scripts#

Cada script é um arquivo .lua na pasta scripts/, ao lado do bot.json. Sons usados pelos scripts ficam em scripts/sounds/. Dentro de um script, Engine.getScriptsDirectory() devolve o caminho da pasta.

Na aba Scripting você gerencia tudo:

A coluna Status mostra se o script está rodando ou o erro que o parou.

Como um script roda#

• Cada script roda na sua própria thread, sem travar o bot nem os outros scripts.
• O código de cima roda uma vez. Depois, o script continua vivo recebendo eventos e rodando timers.
• wait(ms) pausa o script, mas eventos e timers continuam chegando durante a espera. Scripts no estilo while true do ... wait(100) end funcionam.
• Um erro dentro de um evento ou timer é mostrado e o script continua rodando.
• print() vai para a aba Console como [nome] texto. Erros aparecem como [lua:nome] ....

Outros jeitos de rodar Lua#

• Console: lua <código> roda um trecho na hora, por exemplo lua print(Player.getHealth()). O comando script também gerencia arquivos: script list, script on <nome>, script off <nome>, script reload [nome], script delete <nome> e script import <.lua ou pasta>.
• Waypoint Script do CaveBot: o código do waypoint roda e a rota espera até ele terminar (sem timers nem eventos registrados). Dentro dele, CaveBot.GoTo("label") pula para o label e encerra o script.

A API#

Referência completa, módulo por módulo: Referência de funções. Abaixo, as mais usadas.

As funções ficam em tabelas por módulo. Posições são passadas como x, y, z separados e devolvidas como tabela {x, y, z}. Slots de inventário começam em 1 (Enums.InventorySlot); slots de container começam em 0.

Eventos#

Registre com Game.registerEvent(Game.Events.X, função) e remova com Game.unregisterEvent. Cada evento, com parâmetros e exemplo, está em Eventos do jogo.

Exemplos#

-- HP do alvo num HUD na tela
local hud = HUD.new(20, 60, "Alvo: -")
hud:setColor(35, 213, 255)

Game.registerEvent(Game.Events.CREATURE_HEALTH, function(id, hp)
  if id ~= Player.getTargetId() then return end
  local alvo = Creature.new(id)
  if alvo:isOnScreen() then
    hud:setText(alvo:getName() .. "  " .. hp .. "%")
  end
end)

-- A cada 5 s: cap baixa mostra aviso e toca scripts/sounds/alarm.wav
Timer.new("cap", function()
  local cap = Player.getCapacity()
  if cap < 100 then
    Client.showMessage("Cap baixa: " .. cap)
    Sound.play("alarm.wav", true)
  end
end, 5000)

-- Ctrl+F5 liga e desliga o CaveBot
local ok, mods, key = HotkeyManager.parseKeyCombination("Ctrl+F5")

Game.registerEvent(Game.Events.HOTKEY_SHORTCUT_PRESS, function(k, m)
  -- bit 8 = Num Lock ligado: ignore
  if k == key and bit.band(m, 7) == mods then
    local on = not Engine.isCaveBotEnabled()
    Engine.enableCaveBot(on)
    Client.showMessage("CaveBot " .. (on and "ligado" or "desligado"))
  end
end)

-- No label "checar": sem 50 mana potions, vai para o label "refill"
Game.registerEvent(Game.Events.LABEL, function(index, label)
  if label == "checar" and Game.getItemCount(268) < 50 then -- 268 = mana potion
    CaveBot.GoTo("refill")
  end
  CaveBot.pause(0) -- a rota fica parada até aqui
end)

-- Loga no Console quem falou seu nome
Game.registerEvent(Game.Events.TALK, function(nome, level, modo, x, y, z, texto)
  if texto:lower():find(Player.getName():lower(), 1, true) then
    print(nome .. " (" .. level .. "): " .. texto)
    Client.flashWindow()
  end
end)

Compartilhar e baixar scripts#

A área de Downloads da comunidade tem scripts Lua, cavebots e presets enviados pelos jogadores. Pela aba DrenoxCommunity dentro do jogo, cada download tem Instalar e Instalar + ligar, e você compartilha os seus scripts com um clique. Antes de ligar um script de outra pessoa, leia o código: ele roda com o seu personagem.

Dúvidas sobre um script? Poste no fórum de suporte com o código e a mensagem de erro do Console.