Pular para o conteúdo principal
KizuBot Logo

Documentação KizuBot

Seu guia completo para dominar o painel de controle.

Módulo de Alarmes

Configura notificações para eventos importantes via WhatsApp e Telegram. Cada tipo de alarme pode ser ativado ou desativado individualmente.

alarmEnabled
Liga ou desliga o envio de todas as notificações. Master switch do sistema de alarmes.
alwaysPlayAlarm
Controla se o alarme sonoro local continua tocando quando o bot principal está desligado. Seletor de 3 estados:
  • Off (0): Nenhum alarme toca quando o bot está desligado.
  • Always On (1): Todos os alarmes sonoros continuam tocando mesmo com o bot desligado. Útil pra monitoramento 24/7.
  • Private Messages Only (2): Apenas o alarme de mensagem privada continua tocando com o bot desligado.
botterPhone / telegramID
Número de WhatsApp e/ou ID do Telegram para receber alertas. Suporta múltiplos contatos.
enabledAlarms
Lista de eventos que geram alarme. Cada um é individualmente ativável no painel.

Jogadores e staff:

  • playerDetected: Alarme genérico de detecção de jogador (legado — use os abaixo para maior controle).
  • humanJoinScreen / humanLeftScreen: Jogador entrou ou saiu da tela.
  • detectPlayerHigherFloor / detectPlayerLowerFloor: Jogador detectado no andar de cima ou de baixo.
  • staffScreen: Staff/GM visível na tela.
  • verificationGM: GM pediu verificação (seta ou aviso).
  • proofBot: Aviso anti-bot do servidor apareceu.

Criaturas extraordinárias:

  • shinyDetected / shinyHigherFloor / shinyLowerFloor: Shiny na tela ou em outro andar.
  • megaDetected / megaHigherFloor / megaLowerFloor: Mega na tela ou em outro andar.
  • bossDetected / bossHigherFloor / bossLowerFloor: Boss na tela ou em outro andar.

Mensagens:

  • privateMessage: Mensagem privada recebida.
  • defaultMessage: Mensagem no chat default.
  • partyMessage / tvMessage: Mensagem no canal da party ou TV.
  • reportMessage: Alguém usou /report em você.
  • partyInvite: Alguém convidou você para party.

Loot e captura:

  • dropRare / dropStone: Loot raro ou evolution stone dropou (separados).
  • pokemonCaught: Um pokémon foi capturado.
  • lootStatistics: Envio periódico de stats acumulados de loot.

Status do personagem:

  • lowHealth: Vida do personagem abaixo de lowHealthPercent.
  • lowSupplies: Algum item em lowSuppliesItems ficou abaixo do threshold.
  • effectOnScreen: Um efeito relevante apareceu na tela (ex: debuff visual).
  • characterStucked: O bot está travado há stuckTimeout segundos.
  • characterDied: O personagem morreu.
  • characterTeleported: Personagem foi teleportado para outra região (arrasto).
  • characterDisconnected: Personagem foi desconectado.
  • highPing: Ping ultrapassou highPingThreshold.

Banco e ações:

  • vaultDeposit / vaultWithdraw: Depósito ou saque no vault.
  • action: Uma ActionRule com alarme foi acionada.
  • notify: Notificações do jogo (sininho) — super recursos, PokéPark, etc.
highPingThreshold
Threshold de ping em ms para acionar o alarme highPing. Quando o ping ultrapassa este valor, você recebe uma notificação.
lowSuppliesItems
Lista de itens monitorados pelo alarme lowSupplies. Cada entrada define um item e a quantidade mínima antes do alarme disparar — ex: alertar quando restam menos de 50 revives.
stuckTimeout
Tempo em segundos que o bot precisa ficar preso sem conseguir se mover antes de disparar o alarme characterStucked. Valores mais altos evitam falsos positivos em hunts lentas.
antiSpamInterval
Intervalo mínimo em segundos entre alarmes consecutivos do mesmo tipo. Previne flood de notificações quando o mesmo evento dispara várias vezes seguidas.
lootStatisticsInterval
Frequência (em minutos) com que as estatísticas de loot são enviadas automaticamente via WhatsApp/Telegram. Depende do alarme lootStatistics estar ativado.
ignoredNames
Lista de jogadores que não devem acionar alarmes. Útil para ignorar amigos, alts ou jogadores frequentes da mesma área.
ignoredItems
Lista de itens que não devem acionar alarme de drop. Também funciona como blacklist para o lootOnlyRare do módulo de Combate.
responsesGM
Lista de frases e respostas configuráveis para responder ao GM automaticamente quando a seta do GM aparece. Você pode adicionar quantas quiser.

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

disableAlarmsNearMark / disableAlarmsNearNurseJoy
Desliga os alarmes automaticamente quando o personagem está perto do mark de teleporte ou perto da Nurse Joy. Evita alarmes falsos em áreas seguras onde é normal ter outros jogadores.
lowHealthPercent
Percentual de vida do PERSONAGEM abaixo do qual o alarme de vida baixa é acionado. Configure para receber notificação quando seu treinador estiver em perigo.
useSimilarity
Detecta nomes de staff por similaridade textual. Pode gerar falsos positivos — recomendado manter desativado se não souber o que está fazendo.