Documentação KizuBot

Como Funciona: O bot solicita ao servidor o conteúdo do arquivo com este nome. É crucial que o nome corresponda exatamente ao arquivo salvo no seu painel de Waypoints.

Exemplo: Se seu script se chama shiny_charizard.kwpt, você deve inserir shiny_charizard.kwpt neste campo.

Exemplo: Se você estiver usando hunt_a.kwpt e derrotar um "Pikachu", o bot procurará por pikachu.kwpt e, se encontrar, mudará para essa hunt.

Como Funciona: Porcentagem de chance. 100 = sempre usa diagonais. 0 = desativa diagonais. Valores intermediários (ex: 50) adicionam aleatoriedade, tornando o movimento menos robótico.

• lureAutoDelay: Delay fixo em milissegundos entre cada passo durante o lure automático.
• lureManualDelayPerMonster: Delay adicional por monstro na tela. Quanto mais monstros, mais devagar o bot anda. Simula cautela humana.

• waitForRestart: Tempo em milissegundos para esperar no último waypoint antes de reiniciar a rota. Dá tempo para respawn dos monstros.
• waitForPlayerLifeRegen: O bot para se a vida do personagem estiver abaixo do percentual definido e só volta a andar quando regenerar. 0 para desativar.
• waitForPokemonLifeRegen: Igual ao anterior, mas para a vida do Pokémon. 0 para desativar.
• waitForAreaMovesCooldown: Espera todas as magias de área saírem de cooldown antes de ir para o próximo waypoint. Garante que você chegue no respawn com magias prontas.
• waitForTargetMovesCooldown: Igual ao anterior, mas para magias de alvo único.

• targetAll: Ataca todos os monstros, exceto NPCs e os listados em ignoreCreatures.
• targetCreatures: Lista branca — se targetAll estiver desligado, o bot SÓ atacará os monstros nesta lista.
• ignoreCreatures: Lista negra — o bot NUNCA atacará estes monstros, independente das outras configurações.

Como Funciona: Principal gatilho de combate. A contagem considera todos os monstros visíveis na tela dentro do campo de visão configurado.

Exemplo: Se definido como 8, o bot caminha pela hunt juntando monstros. Ao ver o 8º monstro, para e inicia o combo.

Valor: Use 1 para matar um por um (hunts perigosas). Use 999 para nunca parar de lurar manualmente.

Diferença de monsterStop: O monsterStop para de andar. O minMonsters decide se começa a atacar. O bot pode parar (monsterStop atingido) mas esperar mais monstros chegarem na box (minMonsters não atingido).

Exemplo: Valor 1 = 8 tiles ao redor do pokémon. Valor 3 = box maior, bom para magias de área com alcance grande.

Padrão: 11 horizontal, 6 vertical. Reduza se o bot estiver detectando monstros muito distantes (shinies longe, por exemplo).

• ksIgnoreLoot: Não coleta loot se houver jogadores (que não sejam da party) na tela.
• ksIgnoreCatch: Não captura pokémons se houver outros jogadores na tela.

• orderDuringLure: Ordena o pokémon para o melhor tile durante o lure, otimizando a posição para o combo que virá.
• orderOnSelfDuringLure: Ordena o pokémon para o tile do personagem durante o lure, mantendo-o sempre perto de você.

• Loot First (Padrão): Coleta loot primeiro, depois revive/potion. Mais eficiente, mas arriscado se o pokémon estiver com vida baixa.
• Healing First: Revive/potion primeiro, depois coleta loot. Mais seguro, pode perder corpos que desaparecem.

Como Funciona: A IA detecta automaticamente quais magias do seu setup são de stun (com base nos efeitos do jogo). Você configura em quais situações usar stun (ex: sempre contra shinies, quando há mais de 5 monstros, etc).

• before_combo: Usa stun ANTES de começar as magias normais. Bom para imobilizar antes de atacar.
• during_combo: Usa stun no meio da rotação normal de magias.
• on_demand: Usa stun somente quando um cenário específico é ativado (ex: shiny apareceu).

• always: Sempre usa stun quando disponível.
• extraordinary / shiny / mega / boss: Usa stun quando criaturas especiais estão na box.
• creature_name: Usa stun contra um Pokémon específico (pelo nome).
• creature_count: Usa stun quando há X ou mais monstros na box.
• pokemon_hp_below: Usa stun quando a vida do seu Pokémon cai abaixo de um percentual.
• during_lure: Usa stun durante o lure, antes do combo iniciar.
• combo_start: Usa stun apenas no início do combo.

Sub-opções de quando reviver:

• reviveOnEndLure: Usa revive ao final de cada lure/combo, garantindo vida cheia para o próximo.
• forceReviveByCds: Se as magias acabarem e ainda houver monstros, usa outro revive para resetar cooldowns.
• reviveOnAllMovesInCooldown: Usa revive apenas se TODAS as magias (área + alvo) estiverem em cooldown simultaneamente.
• useCriticalRevive / criticalRevivePercent: Usa revive se a vida do pokémon cair abaixo do percentual crítico, mesmo no meio do combate.
• prioritizeTargetMovesAfterRevive: Após usar revive, prioriza magias de alvo único antes de voltar à rotação normal. Útil para garantir dano imediato após resetar cooldowns.

Como Funciona: Se usePotion estiver ativo, usa o item de potionName quando a vida cair abaixo de potionAtPercent.

potionAfterCombo: Se ativado, só usa poção após o término do combo, mesmo que a vida esteja baixa durante a luta.

Como Funciona: Crie regras como "Usar Aspear Berry no Charizard quando estiver Frozen" ou "Usar Sitrus Berry no Snorlax quando vida abaixo de 40%". Cada regra especifica: berry, pokémon, condição e threshold.

• keepDistance: Faz o seu PERSONAGEM manter distância dos monstros.
• distanceToKeep: Distância em tiles a manter.
• minMonstersToKeepDistance: Número mínimo de monstros na tela para ativar o keepDistance.

Como Funciona: Faz o seu POKÉMON manter distância dos monstros. Útil para pokémons frágeis que precisam atacar de longe.

pokemonKeepDistanceMode: Define o modo de distância — como o pokémon calcula a posição segura (baseado em tiles livres, direção oposta aos monstros, etc).

Como Funciona: Monitora o estado do Pokémon e troca automaticamente quando as condições configuradas são satisfeitas.

• Enabled: Ativa/desativa o Smart Swap.
• Strategy: sequential (próximo na ordem), random (aleatório), priority (por prioridade configurada).

• pokemon_died: Troca quando o Pokémon morre.
• all_moves_in_cooldown: Troca quando TODAS as magias estão em cooldown — ideal para maximizar DPS.
• target_moves_in_cooldown: Troca quando as magias de alvo estão em cooldown.
• pokemon_unsummoned: Troca quando o Pokémon é dessummonado (teleport, dive, etc).
• health_below: Troca quando a vida cai abaixo de um percentual.

• revive_main: Revive no Pokémon principal (slot 1).
• revive_last: Revive no último Pokémon ativo.
• revive_all: Revive em TODOS os mortos, um por um.
• wait: Espera até que um Pokémon fique disponível.
• teleport: Teleporta de volta à cidade/nurse.

• startThrowBallDelay: Delay antes da primeira ball após derrotar o pokémon.
• delayBetweenBalls: Delay entre cada ball subsequente no mesmo pokémon.

Opções: instant (0ms), fast (100-300ms), default (300-700ms), slow (500-1000ms), realistic (800-1500ms).

• catchAllEnabled: Ativa o modo catchAll. Ignora listas de captura, mas respeita a ignoreCatchList.
• catchAllIsPersistency: Se ativado, captura a mesma espécie repetidamente. Se desativado, captura cada espécie apenas uma vez por sessão.

• farmingRadius: Raio para recursos normais (matos, minérios).
• bigBushRadius: Raio para arbustos grandes (Professor). Pode ser diferente do raio padrão para otimizar a rota.
• headbuttRadius: Raio para árvores de headbutt (Estilista).

• instant: Sem delay, resolve imediatamente (alto risco de detecção).
• fast: 2-4 segundos.
• default: 4-7 segundos (comportamento padrão).
• slow: 8-12 segundos (mais seguro).
• realistic: 13-20 segundos (simula humano distraído, mais seguro).

• nearest: Vai para o waypoint mais próximo da posição atual.
• next: Vai para o próximo waypoint na sequência.
• previous: Volta para o waypoint anterior.

• fishOnlyWithSight: Só pesca se houver linha de visão direta com o tile de água.
• fishOnlyWithoutObstacle: Só pesca em tiles de água sem obstáculos.
• fishOnlyWhenHaveJustWater: A condição mais segura — verifica andares inferiores também.

Como Funciona: Se o bot não detectar o efeito visual de fisgada após esse tempo, puxa a vara. Aumente em locais com spawn mais lento.

Padrão: 70s. Aumente para 90-120s em locais lentos.

• playerDetected: Jogador na tela (exceto party members).
• playerDetectedAnotherFloor: Jogador detectado em outro andar.
• shinyDetected / megaDetected / bossDetected: Criaturas extraordinárias na tela.
• privateMessage: Mensagem privada recebida.
• partyMessage / tvMessage: Mensagem no canal da party ou TV.
• partyInvite: Alguém convidou você para party.
• lowSupply: Suprimentos abaixo do threshold (mostra quantidade restante).
• dropRare / dropStone: Loot raro ou stone dropou (separados).
• pokemonCaught: Um pokémon foi capturado.
• stucked: O bot está travado e não consegue se mover.
• gameNotification: Notificações do jogo (sininho) — super recursos, PokéPark, etc.
• lowHealth: Vida do personagem abaixo do threshold configurável.

Como Funciona: Quando o GM interage, o bot seleciona uma resposta da lista e envia. Funciona em conjunto com danceForGM na aba Engine.

• extraordinaryCreatures: Tratados como Shiny/Boss (ataque imediato, keep distance, alarme, loot forçado).
• priorityCreatures: Param o lure mas são combatidos com lógica normal, não de extraordinários.

• Partial (stopBotOnStaff): Pausa módulos selecionados (Cavebot, Farming, Fishing) mas continua curando. Reativa automaticamente após o GM sair.
• Full (shutdownOnStaff): Inicia logout seguro — termina o combate atual e desloga.
• Suicide (suicideOnStaff): Desliga healing, cancela ataque, e anda em direção ao grupo de monstros mais denso para morrer "acidentalmente".

Você pode enxergar o módulo Actions & Rules como uma ponte entre o que você configura no painel e o que o bot faz dentro do jogo. Cada regra criada no painel vira uma "receita de automação" que o cliente do bot segue com base em condições e ações bem definidas.

• No painel: você monta regras visuais com nome, condições, grupos lógicos, sequência de ações e, se quiser, uma hotkey.
• Na nuvem: essas regras são guardadas junto com as demais configurações da sua conta, ficando disponíveis para qualquer instância do bot vinculada a você.
• No cliente do bot: quando o bot carrega suas configurações, ele recebe a lista atualizada de regras de Actions & Rules e atualiza o módulo responsável por monitorar o jogo.
• Em tempo real: enquanto você joga (ou deixa o bot jogando), esse módulo fica avaliando condições e eventos do jogo e dispara as sequências de ações das regras que estiverem habilitadas.

• name: nome único da regra. É usado para organização, logs e para identificar timers internos.
• enabled: liga/desliga a regra inteira. Ideal para testar regras novas sem apagá-las.
• hotkey: tecla opcional (por exemplo, J) que vira um atalho Alt+J dentro do jogo. O ActionsModule.registerAllHotkeys() registra esses atalhos sempre que as configs são carregadas.
• onlyInPz / onlyOutsidePz: filtros globais para rodar a regra apenas dentro ou fora de PZ.
• pokemonSummoned: permite exigir que o Pokémon esteja ou não esteja sumonado para que a regra funcione.
• actions: lista ordenada de ações que serão executadas em sequência quando a regra ativar.
• condition_groups: grupos de condições com lógica AND/OR que definem quando a regra dispara.

As condições são o “se” da sua automação. No painel, você monta grupos com a propriedade logic ("AND" ou "OR") e uma lista de conditions. O fluxo é o seguinte:

• logic = "OR": a regra dispara se qualquer condição daquele grupo for verdadeira.
• logic = "AND": todas as condições do grupo precisam ser verdadeiras ao mesmo tempo.
• Tipos de condição mais usados:
  • time_is / time_between / server_save / timed_logout / timed: regras baseadas em horário, uptime do bot ou eventos recorrentes (a cada X segundos).
  • player_on_screen / player_count_is / no_player_on_screen: monitoram a presença e quantidade de jogadores na tela, com opção de ignorar membros da party.
  • is_in_pz / is_not_in_pz / is_in_combat / is_not_in_combat: cuidam de contexto de segurança (cidade, combate, etc.).
  • player_health / player_health_between: gatilhos por percentual de vida do personagem.
  • pokemon_health / pokemon_health_between / pokemon_not_summoned / active_pokemon_is: gatilhos por status do Pokémon ou verificar qual pokémon está ativo.
  • has_status / missing_status / has_any_bad_status / move_off_cooldown: verificam status conditions (poisoned, burning, paralyzed, etc.) e cooldown de habilidades.
  • all_moves_in_cooldown / target_moves_in_cooldown: verificam se todas as magias (área + alvo) ou apenas as de alvo estão em cooldown - ideal para Smart Swap e otimização de DPS.
  • pokemon_unsummoned: detecta quando o Pokémon foi dessummonado forçadamente (teleport, dive, ou outras mecânicas do jogo).
  • target_health_between: regras que dependem da vida do monstro que você está atacando.
  • creature_in_box / creature_in_screen / creature_count: monitoram criaturas em volta ou na box.
  • extraordinary_in_box / extraordinary_in_screen / shiny_in_* / boss_in_* / mega_in_*: gatilhos específicos para shinies, bosses e megas.
  • item_count_lower_than / item_count_higher_than: monitoram quantidade de itens (revives, pokébolas, etc.).
  • module_enabled: verifica se um módulo específico (Cavebot, Farming, etc.) está ligado.
  • chat_message / text_message: respondem a mensagens específicas no chat.
  • creature_appear / player_death / character_disconnected / character_stuck / pokemon_caught / player_watching_tv: condições baseadas em eventos pontuais observados pelo bot.
  • is_flying / is_not_flying / is_riding / is_not_riding / is_in_vehicle / is_not_in_vehicle / is_broadcasting_tv / is_party_leader / is_near_waypoint: verificam estados especiais do personagem, do Pokémon ou da rota.
  • state_variable_is / state_cooldown_passed / player_state_is: permitem criar lógicas com memória e cooldowns personalizados usando variáveis internas do módulo.
• Por baixo dos panos, o módulo de ações avalia cada condição com base no contexto atual (vida, criaturas na tela, mensagens recebidas, etc.) e decide se a regra pode ou não disparar.

Quando uma regra dispara, o bot percorre a lista de actions que você configurou. Alguns exemplos práticos que você enxerga na tela de edição:

• talk / say_random: envia mensagens formatadas em canais como say, trade, party, TV ou privado, com placeholders como {player} ou {creature.name}.
• use_item: usa itens no player, no Pokémon ou em posições calculadas (por exemplo, ao redor do Pokémon), perfeito para revives, potions, boxes, etc.
• cast_spell: dispara um move específico do seu Pokémon pelo ID do slot (1–12).
• call_pokemon / swap_pokemon / revive_pokemon: controla qual Pokémon está em campo, revive pokémons específicos e gerencia o time durante a hunt.
• teleport: usa o teleporte do Pokémon para voltar a cidades/locais específicos quando as condições são atendidas.
• toggle_module / pause_cavebot: liga/desliga módulos (Cavebot, Farming, etc.) ou pausa o Cavebot por um tempo determinado, retomando depois automaticamente, se configurado.
• change_setting: altera configurações avançadas em tempo real (por exemplo, ligar/desligar CombatModule.ksIgnoreLoot ou mudar prioridades).
• set_state / increment_state: manipulam variáveis internas de estado, permitindo regras com memória (como contar quantos avisos um jogador já recebeu antes de tomar uma ação mais agressiva).
• wait: pausa a sequência por alguns milissegundos, útil para criar fluxos do tipo “faz X, espera Y, depois faz Z”.
• play_alarm: toca sons integrados ao módulo de alarmes, com texto opcional para log ou notificações externas.
• walk_to_waypoint / set_cavebot_waypoint: movem ou reposicionam o Cavebot para um waypoint específico, ótimo para rotas de fuga ou atalho até uma área.
• force_logout / safe_logout / reconnect / panic_shutdown: controlam desligar e religar o cliente de forma automática, incluindo desligamento de emergência com mensagem personalizada.
• sell_item_market / search_item_market / buy_cheapest_item_market: automatizam interações com o market do jogo (busca, venda e compra de itens dentro de parâmetros definidos).
• talk_to_npc / npc_select_option / buy_npc_item: automatizam diálogos com NPCs, seleção de opções e compra de itens diretamente pelos menus.
• run_script: executa scripts pré-definidos e seguros do próprio cliente do bot (não editáveis pelo usuário): deposit_money, withdraw_money, open_private_chat, send_party_invite, talk_nurse_joy, stack_items_in_container, tv_ban, tv_unban, use_vehicle.
• stop_sequence: encerra a execução da regra no ponto atual, útil para criar “if/else” dentro da mesma sequência.

Diversas ações e condições suportam placeholders como {player}, {message} ou{creature.name}. O módulo converte essas variáveis usando a funçãoActionsModule.resolvePlaceholders, que busca os valores dentro de um objeto de contexto (eventData).

• Em regras de chat, eventData.player e eventData.message são preenchidos automaticamente com o jogador e a mensagem recebida.
• Em regras de TV, eventData.watcherName e variáveis comoActionsModule.state.tvWatchers permitem banir ou notificar quem está assistindo há muito tempo.
• Em regras de criaturas, eventData.creature carrega o monstro que apareceu ou está sendo atacado, permitindo mensagens altamente personalizadas.

A aba de presets da página de Actions traz uma coleção de modelos prontos (presets) organizados por categoria (Utility, System & Automation, etc.), já configurados e prontos para serem importados e ajustados.

• Deposit Money (Hotkey): cria uma regra com hotkey que chama o script segurodeposit_money, responsável por abrir o cofre e depositar todo o dinheiro (ou um valor específico se você configurar count).
• Safe Logout on Player Detection: detecta um jogador na tela, executapanic_shutdown com uma mensagem personalizada usando {player}, espera 5 minutos, reconecta e ativa novamente os módulos principais.

Esses presets são um excelente ponto de partida: você pode importar, testar, ajustar textos, tempos e módulos afetados, em vez de montar tudo do zero.

A lógica interna desses presets é exatamente a mesma que você configura manualmente no painel. Eles existem apenas para poupar tempo e servir como "receitas prontas" que você pode adaptar ao seu estilo de jogo.

1. Safe Logout ao Detectar Jogador

Objetivo: se qualquer jogador aparecer na sua tela durante a hunt, o bot deve desligar tudo com segurança, esperar um tempo e depois tentar reconectar.

• Nome da regra: Safe Logout on Player Detection
• onlyOutsidePz: ativado (true), para não disparar enquanto você está parado em cidade/PZ.
• condition_groups: um grupo com logic = "OR" e uma condição:
  • type = "player_on_screen"
  • ignore_party_members = true para não considerar sua própria party como ameaça.
• actions (em ordem):
  • panic_shutdown com reason = "Panic shutdown due to player {player} on screen." — usa o placeholder para registrar quem foi detectado.
  • wait com duration = 300000 (5 minutos) — dá tempo para o player ir embora.
  • reconnect — tenta logar novamente na conta usando as infos de AccountModule.accountInfo.
  • toggle_module com module = "All" e state = true — reativa os módulos após o retorno.

2. Depositar Dinheiro com Hotkey

Objetivo: ao apertar uma tecla, o bot abre o cofre e deposita todo o dinheiro (ou um valor específico).

• Nome da regra: Deposit Money (Hotkey)
• enabled: true
• hotkey: D (no jogo isso vira Alt+D)
• condition_groups: pode ficar vazio — a execução será manual via hotkey.
• actions:
  • run_script com script_id = "deposit_money" — chama um script seguro interno do cliente do bot.
• Variação com valor fixo: adicione o parâmetro count na action para depositar apenas parte do dinheiro (ex.: count = 50000 para 50k).

3. Responder PM Automaticamente

Objetivo: mandar uma resposta automática quando alguém te envia uma mensagem privada, usando o nome e o conteúdo da mensagem na resposta.

• Nome da regra: Auto Reply Private Message
• enabled: true
• condition_groups: um grupo com logic = "OR" e uma condição:

• type = "chat_message"
• channel = "private"
• contains opcional — se você quiser que dispare só quando a mensagem tiver uma palavra-chave.

• actions:
  • talk com:
    • channel = "private"
    • message = "Olá {player}, recebi sua mensagem: {message}. No momento estou usando o KizuBot, em breve respondo manualmente."
  • Opcional: use set_state + state_cooldown_passed em uma segunda regra para evitar responder spam do mesmo jogador muitas vezes em pouco tempo.

4. Aviso ao Detectar Shiny/Boss/Mega

Objetivo: tocar um alarme específico e mandar uma mensagem quando uma criatura extraordinária aparecer na tela.

• Nome da regra: Extraordinary Creature Alert
• enabled: true
• condition_groups: um grupo com logic = "OR" e uma condição do tipoextraordinary_in_screen (ou condição equivalente disponível no painel que detecte extraordinários).
• actions:
  • play_alarm com sound = "shinyDetected", loops = 3 e um texto opcional (ex.: "Shiny/Boss/Mega na tela!").
  • Opcional: adicionar uma action talk em canal privado para avisar outra conta sua ou parceiro de hunt.

5. Usar Stun baseado na vida do Pokémon alvo

Objetivo: usar automaticamente um movimento de stun quando a vida do alvo estiver abaixo de um limite, ajudando a controlar lures perigosos.

• Nome da regra: Use Stun on Low Target HP
• enabled: true
• condition_groups: um grupo com logic = "OR" e uma condição do tipotarget_health_between com min_percent e max_percent configurados (por exemplo, entre 1% e 30%).
• actions:
  • cast_spell com move_id apontando para o slot do seu stun na barra de moves.

6. Regra Anti-Gank Completa (múltiplos grupos)

Objetivo: criar uma proteção completa contra gank, combinando detecção de players, checagem de vida e cooldown para não ficar desligando e religando o bot o tempo todo.

• Nome da regra: Anti-Gank Protection
• enabled: true
• onlyOutsidePz: true (só faz sentido quando você está em hunt).
• condition_groups:
  • Grupo 1 (detecção de risco) — logic = "OR":
    • player_on_screen com ignore_party_members = true.
    • player_count_is com greater_than = 2 (mais de dois jogadores na tela).
  • Grupo 2 (estado do personagem) — logic = "AND":
    • player_health_between com min_percent = 1 e max_percent = 70.
    • is_not_in_pz (garantir que você ainda está exposto).
  • Grupo 3 (cooldown da proteção) — logic = "AND":
    • state_cooldown_passed com variable = "anti_gank_last_trigger" e cooldown em segundos.
• actions (em ordem):
  • set_state com variable = "anti_gank_last_trigger" e value = true para registrar o último disparo da proteção.
  • panic_shutdown com uma mensagem explicando o motivo (por exemplo,"Anti-gank triggered due to players on screen."), para desligar tudo de forma segura.
  • Opcional: adicionar um play_alarm ou envio de mensagem privada para avisar outra conta sua que o anti-gank foi ativado.

• 1. Teste via hotkey primeiro: se sua regra tiver hotkey, deixecondition_groups o mais simples possível ou até vazio, e confirme se a sequência de ações funciona quando você pressiona o atalho (Alt+tecla).
• 2. Revise os filtros globais: confira se onlyInPz, onlyOutsidePz epokemonSummoned fazem sentido para o cenário em que você está testando. Esses filtros bloqueiam a regra mesmo que as condições internas sejam verdadeiras.
• 3. Simplifique as condições: comece com uma única condição em um grupo (por exemplo,player_health) e verifique se dispara. Depois vá adicionando mais condições ou grupos aos poucos.
• 4. Verifique valores numéricos: certifique-se de que campos como percentuais, intervalos e contagens (por exemplo, duration, min_percent, max_percent, count) estejam coerentes com o que você espera no jogo.
• 5. Use placeholders com cuidado: se a mensagem usa {player} ou{message}, verifique se a condição realmente preenche esse contexto (por exemplo,chat_message em canal privado).
• 6. Evite conflitos entre regras: duas regras podem tentar fazer coisas opostas ao mesmo tempo (uma ligando módulo, outra desligando). Se algo parecer "piscando" ou instável, desative regras semelhantes e teste uma por vez.

• Posso usar Actions & Rules sem presets?

  Sim. Os presets são apenas atalhos para criar regras prontas. Você pode montar tudo manualmente, campo por campo, usando a mesma interface.

• O que acontece se eu apagar um preset?

  Apagar um preset importado não afeta o funcionamento do bot nem suas outras regras. Ele só deixa de aparecer na lista de regras do painel.

• Regras com timed podem me prejudicar?

  Podem, se configuradas com intervalos muito baixos. Use intervalos maiores e, sempre que possível, combine com condições de cooldown (state_cooldown_passed) para evitar spam de ações.

• Posso usar Actions para substituir totalmente o Cavebot?

  O foco de Actions & Rules é reagir a eventos e estados (vida, players, mensagens, horários). Ele complementa o Cavebot e outros módulos, mas não substitui um script de movimentação completo.

• Se eu errar uma regra, posso quebrar o bot?

  Erros de configuração normalmente só fazem a regra não disparar ou se comportar de forma indesejada. Se algo parecer estranho, desative a regra (enabled = false) e ajuste aos poucos até chegar no comportamento desejado.

• Comece simples: crie regras com poucas condições e 1–2 ações para validar o comportamento.
• Use hotkeys para teste: ative a mesma sequência via hotkey antes de deixá-la totalmente automatizada.
• Combine com Alarmes: use play_alarm e notificações externas para saber quando uma regra crítica é disparada.
• Atenção a loops: evite criar regras que se auto-disparem em alta frequência (por exemplo, timed com intervalo muito baixo) sem algum controle de cooldown via state_cooldown_passed.
• Priorize segurança: em ações de TV, player detection e staff, prefira desligar módulos, pausar cavebot ou fazer logout seguro antes de qualquer ação agressiva.

Como Funciona: O painel envia o conteúdo para o servidor. O bot baixa na VM. Pressione ALT+K no jogo para aplicar (reinicia e carrega as novas configurações).

O que inclui: Hotkeys, posições de janelas, configurações da action bar, etc.

Como Funciona: Salve a config atual como um profile nomeado (ex: "Hunt Venusaur", "Farming Outland"). Troque entre profiles sem precisar reconfigurar tudo manualmente.

Compartilhamento: Profiles são visíveis entre todos os personagens do mesmo login.

5 Categorias de Magias:

• targetMoves: Magias de alvo único. Usadas contra um monstro específico.
• areaMoves: Magias de área (AoE). Atingem múltiplos monstros ao redor.
• supportMoves: Buffs e magias de suporte (ex: Charm, Charge, Agility).
• healMoves: Magias de cura do próprio Pokémon (ex: Synthesis, Recover).
• stunMoves: Magias de stun/CC. Detectadas automaticamente pela IA com base nos efeitos do jogo. Usadas pelo Sistema de Stun Tático configurado no módulo de Combat.

Prioridade: A ordem das magias dentro de cada lista define a prioridade de uso. O bot sempre tenta usar a primeira magia disponível (que não esteja em cooldown).

Como funciona: A variância é recalculada uma vez por sessão de lure (quando nextCycle() é chamado). Durante o mesmo lure, os valores permanecem estáveis — não oscilam a cada segundo.

Valores sentinela: Os valores 0, 99 e 999 NUNCA são variados, pois representam "desativado" na maioria das configs.

Como funciona: Um JSON onde cada chave é o nome do threshold e o valor é a variância em %. Exemplo: {"monsterStop": 15, "potionAtPercent": 5} aplica 15% em monsterStop e 5% em potionAtPercent, independente do globalVariance.

• waitForPlayerLifeRegen — % de vida do personagem para esperar regeneração
• waitForPokemonLifeRegen — % de vida do pokémon para esperar regeneração
• stopLureAtHealth — % de vida para parar de lurar
• forceComboAtHealth — % de vida para forçar combo
• healAtPercent — % para usar heal
• potionAtPercent — % para usar poção
• monsterStop — quantidade de monstros para parar
• minMonsters — mínimo de monstros para combar

Padrão: 3000-8000ms (3-8 segundos). Um humano real demora alguns segundos para notar e responder.

Como funciona: São implementadas como regras de ação automáticas injetadas pelo painel. O bot processa como ações normais via polling de 250ms.

• microPausesEnabled: Liga/desliga o sistema de micro-pausas.
• microPauseChance: Probabilidade (0-100%) de uma micro-pausa acontecer a cada ciclo.
• microPauseDurationMin / microPauseDurationMax: Range de duração em segundos.

Exemplo: Chance 15%, duração 0.5-2s = a cada ~7 ciclos o bot hesita por 0.5 a 2 segundos, como se estivesse checando o celular.

• huntBreaksEnabled: Liga/desliga o sistema de hunt breaks.
• huntBreakIntervalMin / huntBreakIntervalMax: Intervalo entre pausas (em minutos). Randomizado dentro do range.
• huntBreakDurationMin / huntBreakDurationMax: Duração da pausa (em minutos). Randomizado dentro do range.
• huntBreakDisableHealing: Desativa healing durante a pausa. O pokémon leva dano como se o jogador estivesse realmente AFK.
• huntBreakDisableCombat: Desativa combat durante a pausa. O pokémon não revida — AFK completo.