Documentação › Módulos
CaveBot
O CaveBot anda uma rota de waypoints, um depois do outro. Ele para para lutar, usa escadas, cordas e buracos, faz lure e, nas hunts 100% AFK, vai sozinho ao depot, vende, compra supplies e volta.
As três sub-abas#
A lista de waypoints com as colunas #, Tipo e Onde. O waypoint atual aparece em verde com >.
- Duplo clique numa linha faz o bot ir para aquele waypoint
- Ir para continua do selecionado, ou do mais próximo se nada estiver selecionado
- Apagar remove o selecionado (ou o último)
À direita ficam os quadros Adicionar na minha posição, Ajustes e Suprimentos (venda / refill).
A rota desenhada no minimap do cliente:
- clique no mapa para adicionar um waypoint depois do selecionado
- arraste um waypoint para mover
- arraste o mapa para navegar
- roda do mouse muda o zoom; Ctrl + roda (ou Shift + roda) troca o andar
- Vista, no canto de cima à direita, troca entre Superfície (satélite) e Mapa (cores do minimap). Abaixo do térreo o mapa aparece sempre em cores
Escadas, buracos e cordas#
No minimap, as casas amarelas são onde o andar muda. Passe o mouse por cima de uma: ela ganha um quadro amarelo e o nome do que é, como ESCADA · clique para subir ▲ ou BURACO · clique para descer ▼.
Clique nela e o waypoint já entra com o tipo certo (ladder, stairs, hole, rope). No mapa ele aparece com o nome ao lado do número. Depois:
- segure Ctrl e gire a roda para ir ao outro andar
- continue clicando os próximos waypoints
Quando o próximo waypoint fica em outro andar, o número ganha ▲ ou ▼. Se o bot escolher o tipo errado (uma escada de mão virou stairs, por exemplo), troque no painel do lado.
O painel do lado edita o waypoint selecionado. Tabela e Mapa mexem na mesma rota.
O ciclo completo de uma hunt da biblioteca, em 8 fases: Caçar, Checar supplies, Sair, Depot, Vender, Banco, Comprar e Viajar. Cada fase aparece com ✓ ou ✗, e o botão Validar diz o que falta. Os valores editáveis dos scripts da hunt ficam aqui também, com Salvar e Salvar & carregar.
Biblioteca#
O botão ◂ / ▸ mostra a biblioteca à esquerda: suas hunts em pastas, na pasta cavebots/ ao lado do bot.json. Clique seleciona, duplo clique carrega no CaveBot. Ela aceita as rotas .json do DrenoxBot e os .cb do ZeroBot.
Gravando uma rota#
Fique no primeiro sqm da rota, no andar certo.
Clique Auto rec na Tabela, ou digite /wp auto. O bot grava um node a cada Distância do node sqm enquanto você anda.
Escadas, buracos e mudanças de andar viram um stand no último sqm antes da troca.
Troque os stand pelo tipo certo: /wp type 12 ladder.
Clique Parar rec (ou /wp auto off) e rode /wp check.
Tipos de waypoint#
| Tipo | O que faz |
|---|---|
node | Anda até ficar a poucos sqm do ponto (o normal) |
stand | Pisa exatamente no sqm |
door / use | Usa o que está no sqm e segue |
ladder | Usa o sqm e espera a troca de andar |
rope / shovel / pick | Usa a ferramenta no sqm; shovel e pick entram no buraco depois |
machete | Corta a grama da selva |
hole / stairs | Pisa no sqm e espera a troca de andar |
teleport | Pisa e espera ser levado |
hurup / hurdown | Fica no sqm, vira para a direção e fala exani hur |
useitem | Usa um item pelo id no sqm |
lure / endlure | Começa e termina um lure |
box | Anda até o sqm sem lutar no caminho e luta ali; depois espera como um endlure |
dynstart / dynend | Lure dinâmico só entre os dois |
say | Fala o texto (NPC, magia) |
script | Roda código Lua e espera terminar |
wait | Pausa por um tempo em ms |
label / goto | Marca um ponto e pula para ele |
refillcheck / sell / refill | Checa supplies, vende e compra |
Os ids de rope, shovel, machete e pick ficam na aba Engine.
End lure e box#
No endlure e no box o bot fica até a luta acabar. Três casos em que ele decide sozinho:
- Sobrou monstro que ele não ataca (fora da lista de alvos ou longe demais, por exemplo): espera o tempo de Lure: esperar o bando (s), 5 segundos no padrão, e segue a rota. Monstros ignorados pelo Targeting nem entram na conta
- O sqm do box está ocupado, ou o bando cercou o personagem no caminho: a luta começa onde ele está, e ele vai para o sqm quando der
- A segurança do lure dispara a caminho do box (Lure: lutar abaixo HP% ou Segurança: qtd. perto): ele luta onde está, sem continuar andando até o sqm
Enquanto anda até o box, o Shooter segura as magias e runas de ataque. Os ajustes de lure ficam na aba Tools.
Comandos /wp#
/wp node node na sua posição
/wp ladder n ladder no sqm ao norte
/wp useitem 3003 e usa o item 3003 no sqm a leste
/wp hurup n exani hur up virado para o norte
/wp say hi fala "hi"
/wp wait 2000 espera 2 s
/wp label caverna marca o ponto
/wp goto caverna volta para ele
/wp del apaga o último
/wp list lista a rotaAs direções aceitas são n ne e se s sw w nw e c (o seu sqm).
Formato do waypoint#
A rota fica em Cavebot.Waypoints no bot.json:
[
{ "Type": "label", "Label": "inicio" },
{ "Type": "node", "X": 32369, "Y": 32215, "Z": 7, "Tolerance": 3 },
{ "Type": "stand", "X": 32372, "Y": 32218, "Z": 7, "Tolerance": 0 },
{ "Type": "ladder", "X": 32373, "Y": 32218, "Z": 7 },
{ "Type": "lure" },
{ "Type": "node", "X": 32380, "Y": 32220, "Z": 8, "Tolerance": 3 },
{ "Type": "endlure" },
{ "Type": "goto", "Label": "inicio" }
]Outros campos: ItemId (useitem), WaitMs (wait), Direction (hurup/hurdown).
Ajustes#
No quadro Ajustes da Tabela:
- Repetir rota: volta ao primeiro waypoint depois do último (padrão ligado)
- Parar em combate: para de andar enquanto luta (padrão ligado). Desligado vira um lure contínuo
- Começar do mais próximo: ao ligar, começa do waypoint mais perto de você
Lure, modo de andar e áreas especiais ficam na aba Tools.
Quando trava#
O bot mede se está chegando mais perto do waypoint. Se ficar 8 segundos sem progresso, tenta de novo; depois de 3 tentativas, pula para o próximo. Esses valores são StuckTimeoutMs e MaxRetries no bot.json.
Quando não existe caminho até o waypoint, o bot tenta de novo com calma, mais ou menos a cada 1,5 segundo, em vez de pular vários waypoints de uma vez. Se ele pular dois waypoints seguidos e Começar do mais próximo estiver ligado, retoma a rota do waypoint mais perto no seu andar.
Pathfinding#
O caminho é calculado sobre o mapa que o cliente enxerga. O bot desvia de áreas especiais marcadas para não andar e, com Não atravessar players ligado, trata outros players como parede. Com Andar sobre fields (fire) ligado (o padrão), ele passa por fire, poison e energy field quando esse é o caminho, e dá a volta quando o desvio é curto. As duas opções ficam na aba Tools. No modo path ele manda o caminho inteiro; no modo step, um passo por vez, como setas.
Suprimentos#
No quadro Suprimentos, adicione cada item com min e max: no refillcheck o bot vai comprar quando tiver menos que o mínimo, e compra até o máximo. Refill abaixo de cap também manda às compras quando a cap livre cai. Os ids a vender vão em Ids para vender, separados por vírgula.
Comentários
para comentar.