Domine a Modificação de Scripts AHK: Automação, Coordenadas e Teclas em Segundo Plano

Muitos jogadores tentam usar AutoHotkey (AHK) para criar scripts de automação e economizar tempo em tarefas repetitivas. No entanto, surgem desafios comuns: como fazer o script rodar em segundo plano sem interferir em outras atividades? Como obter as coordenadas precisas dentro da janela do jogo? E como enviar teclas de forma mais estável?

Este artigo usa o processo de modificação de um script de automação para o jogo Shui Hu Zhuan Online (também conhecido como Water Margin Online) como estudo de caso, detalhando a implementação de teclas em segundo plano, cálculo de coordenadas, teclas de atalho para captura do mouse e envio de múltiplos grupos de teclas.

Por que Operar em Segundo Plano?

Scripts em primeiro plano, ao executar cliques do mouse ou enviar teclas, forçam a janela do jogo para a frente, interrompendo o que você está fazendo. O objetivo da operação em segundo plano é: enquanto o script roda, você pode continuar usando outras janelas, e a janela do jogo recebe os comandos em segundo plano.

No AHK, os comandos chave para operação em segundo plano são:

• ControlSend: Envia teclas para uma janela específica sem ativá-la.
• ControlClick: Envia um clique do mouse para coordenadas específicas de uma janela sem ativá-la.
• Combinado com

  ahk_id %TargetHwnd%

  para travar a janela alvo.

Como Fixar as Coordenadas XY Dentro da Janela do Jogo?

As coordenadas XY dentro do jogo são diferentes das coordenadas absolutas da tela. Quando a janela do jogo é movida ou redimensionada, os cliques baseados em coordenadas absolutas da tela se perdem.

A maneira correta é calcular as "coordenadas relativas dentro da janela":

X no jogo = X do mouse na tela - X do canto superior esquerdo da janela
Y no jogo = Y do mouse na tela - Y do canto superior esquerdo da janela

Para maior precisão, use o canto superior esquerdo da área de conteúdo do jogo (excluindo a barra de título e as bordas) como referência, em vez do canto superior esquerdo de toda a janela.

Exemplo de Implementação

; Coordenadas do canto superior esquerdo da janela do jogo (precisa ser obtido primeiro)
winX = 100
winY = 80

; Obtém a posição do mouse na tela
GetCursorPos mouseX, mouseY

; Converte para coordenadas dentro da janela do jogo
gameX := mouseX - winX
gameY := mouseY - winY

Atenção:

• Depois de mover a janela do jogo, as coordenadas do canto superior esquerdo devem ser obtidas novamente.
• Recomenda-se fixar o fator de escala do Windows em 100%.
• A resolução do jogo e o tamanho da janela devem permanecer fixos.
• Este método obtém as coordenadas da tela, NÃO as coordenadas XY internas do personagem no mapa do jogo.

Pressione F1 para Capturar a Posição do Mouse: Tecla de Atalho para Captura de Coordenadas

Durante o desenvolvimento, inserir coordenadas manualmente é trabalhoso. Uma maneira mais eficiente é: pressionar uma tecla de atalho e preencher diretamente as coordenadas atuais do mouse nos campos da GUI do script.

Método de Implementação

; Registra a tecla de atalho F1
Hotkey, F1, GetMousePos
return

GetMousePos:
    MouseGetPos, mx, my
    GuiControl,, FindX, %mx%
    GuiControl,, FindY, %my%
    ToolTip, Coordenada capturada: X%mx% Y%my%
    SetTimer, RemoveTip, -2000
return

Assim, basta mover o mouse para a posição desejada e pressionar F1. As coordenadas serão automaticamente inseridas nos campos "Encontrar X / Encontrar Y". Você pode associar diferentes teclas de atalho a diferentes campos de coordenadas, conforme necessário.

Reformulando a Lógica das Teclas: De Teclas Individuais para Grupos de Duas Teclas

O script original tinha quatro teclas individuais, cada uma com seu próprio tempo de atraso. No entanto, em jogos reais, muitas vezes é necessário enviar duas teclas em sequência (por exemplo, pressionar uma tecla de habilidade e depois uma tecla auxiliar) e só então esperar um determinado período.

Direção da modificação:

1. Transformar teclas individuais em "grupos de teclas": Cada grupo contém duas teclas (Tecla A, Tecla B) e uma configuração de atraso comum.
2. Em cada ciclo do loop, enviar Tecla A e Tecla B em sequência.
3. Manter a função de timer: Permitir enviar o grupo a cada N minutos ou a cada ciclo.

Função Auxiliar Modificada

SendKeyGroup(useGroup, keyA, keyB, waitMs, minute) {
    global TimerCount, TargetHwnd
    
    if (useGroup != 1)
        return
    
    if (minute > 0 and Mod(TimerCount, minute * 60) = 0) {
        ; Envia o grupo de teclas a cada N minutos
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
    
    if (minute = 0) {
        ; Envia o grupo a cada ciclo
        ControlSend, , {%keyA%}, ahk_id %TargetHwnd%
        Sleep, 100
        ControlSend, , {%keyB%}, ahk_id %TargetHwnd%
    }
}

A Escolha do Loop Principal: SetTimer vs. Loop com Sleep

Esta é a escolha mais comum em scripts de automação de jogos com AHK:

SetTimer, MainLoopTick, 1000

while (isRunning) { ... Sleep, milissegundos }

Se o seu jogo precisa de operações a cada segundo ou mais lentas (como usar habilidades repetidamente, aplicar buffs periodicamente), SetTimer é uma escolha mais limpa. Se você precisar de controle preciso em milissegundos, use o loop com Sleep e uma condição break.

Armadilhas Comuns e Lembretes

1. ControlClick pode não funcionar em todos os jogos: Alguns jogos não processam mensagens de mouse em segundo plano. Nesses casos, pode ser necessário usar PostMessage ou outras técnicas de envio de mensagens.
2. Formato das teclas no ControlSend: Teclas especiais devem ser envolvidas por chaves, por exemplo, {F1}, {Enter}.
3. Obtendo o Handle da Janela do Jogo: A maneira mais simples é usar

   MouseGetPos, , , TargetHwnd

   , mas isso exige que o mouse esteja sobre a janela do jogo.
4. Fator de Escala do Windows: Se o fator de escala do sistema não for 100%, as coordenadas do ControlClick podem ficar deslocadas. Recomenda-se usar o jogo em modo janela e definir o fator de escala do Windows como 100%.
5. Conflito de Teclas de Atalho: As teclas de atalho usadas pelo script (como F1, F7) podem conflitar com as teclas do jogo. Escolha teclas que o jogo não utilize.

Conclusão

A transformação de um script simples de primeiro plano para um sistema de múltiplos grupos de teclas em segundo plano envolve três mudanças principais: o uso de comandos em segundo plano (ControlSend / ControlClick), o cálculo de coordenadas relativas à janela e a escolha do método de condução do loop principal. Os exemplos de modificação fornecidos neste artigo podem ser aplicados diretamente a scripts de automação para Shui Hu Zhuan Online ou outros jogos com necessidades semelhantes. Se o seu jogo tiver combinações especiais de teclas ou necessidade de cliques em coordenadas específicas, comece testando uma versão mínima viável em segundo plano e adicione funcionalidades incrementalmente.