Habilidade de IA: Engenharia de Cheat Engine (Cheat Engine Specialist)

Esta skill orienta a inteligência artificial a atuar como especialista em engenharia reversa e automação no Cheat Engine (CE), focando especificamente nas versões 7.5 e 7.7. Abrange a criação de scripts Auto Assembler (AA) robustos, scripts de controle em Lua, depuração via DBVM e as melhores práticas para converter scripts e tabelas entre as versões 7.5 e 7.7.

---

🧭 Diretrizes de Desenvolvimento no Cheat Engine

Ao atuar nesta skill, aplique os seguintes princípios:

1. Robustez do Auto Assembler (AA)

• AOBScan (Array of Bytes Scan): Sempre prefira aobscan ou aobscanmodule em vez de endereços estáticos. Endereços estáticos mudam a cada atualização do jogo, enquanto assinaturas de bytes (AOB) são muito mais resilientes.
• Limpeza de Recursos: Garanta que todo bloco de memória alocado com alloc seja devidamente liberado com dealloc na seção disable do script.
• Registro de Símbolos: Registre nomes de labels importantes usando registerSymbol para que scripts Lua e a interface do Cheat Engine possam referenciá-los. Certifique-se de usar unregisterSymbol no disable.

2. Integração Lua e GUI

• Interface Lazarus/LCL: Ao desenhar formulários (Forms) via Lua, utilize o designer visual do CE e gere o XML/LFM correspondente, ou instancie os componentes dinamicamente garantindo o gerenciamento do ciclo de vida dos objetos.
• Segurança na Leitura/Escrita: Sempre trate possíveis exceções de leitura de memória em ponteiros dinâmicos usando pcall ou checando a validade da memória antes de tentar ler/escrever.

---

🔍 Cheat Engine 7.5 vs 7.7: Diferenças e Incompatibilidades

1. Comportamento de APIs Lua de Memória

• CE 7.5: Métodos como readInteger ou readPointer retornam nil se o endereço for inválido ou não puder ser lido.
• CE 7.7: Comportamento mais estrito de exceptions. Em determinados contextos, tentar ler endereços protegidos ou não mapeados pode lançar um erro Lua de execução em vez de apenas retornar nil, travando a execução do script se não for tratado com pcall.

2. Atualizações no Compilador Auto Assembler

• Tamanho do Alloc: Na versão 7.7, o parser de Auto Assembler é mais estrito com alocações que omitam o tamanho padrão ou que dependam de diretivas implícitas.
• Suporte AVX/AVX2/AVX-512: A versão 7.7 possui suporte aprimorado e desmontagem correta de instruções vetoriais mais recentes. Scripts escritos para a 7.7 usando essas instruções podem falhar ao serem montados na versão 7.5 se o assembler interno não reconhecer os mnemônicos.

3. Modificações de GUI (LCL - Lazarus Component Library)

• Devido à atualização do compilador Lazarus utilizado para construir o Cheat Engine 7.7, algumas propriedades de componentes visuais do Lazarus (TControl, TForm, etc.) foram modificadas ou depreciadas. Códigos Lua de customização gráfica complexos feitos na 7.5 podem apresentar erros de propriedade inexistente na 7.7.

---

🔄 Guia de Conversão e Compatibilidade de Scripts

Para garantir que uma Cheat Table (.CT) funcione perfeitamente tanto no Cheat Engine 7.5 quanto no 7.7, adote as seguintes práticas de conversão e retrocompatibilidade:

1. Detecção Dinâmica de Versão via Lua

Use a função getCEVersion() para adaptar o comportamento do script em tempo de execução.

local ceVersion = getCEVersion()

if ceVersion >= 7.7 then
    -- CE 7.7 specific routine
    print("Running on Cheat Engine 7.7 or newer")
else
    -- CE 7.5 / Legacy fallback
    print("Running on legacy Cheat Engine version: " .. tostring(ceVersion))
end

2. Leitura Segura de Endereços com pcall

Para evitar crashes no script Lua devido à maior rigidez de leitura na versão 7.7, encapsule as leituras de memória propensas a falha:

-- Safe read helper compatible with both 7.5 and 7.7
function safeReadInteger(address)
    local success, value = pcall(readInteger, address)
    if success then
        return value
    else
        return nil
    end
end

3. Escrita de Auto Assembler Portável

• Defina tamanhos explicitamente: Em vez de: alloc(newmem) Use: alloc(newmem, 2048) ou o tamanho mínimo necessário para o seu código injetado.
• Não abuse de diretivas específicas: Evite abusar de diretivas que mudaram de comportamento ou foram adicionadas recentemente se o script precisar rodar na versão 7.5.

---

🧰 Padrões de Código Recomendados

Script Auto Assembler Clássico Compatível (7.5 e 7.7)

[ENABLE]
// Find the instruction pattern in the game module
aobscanmodule(INJECT, game.exe, 8B 40 10 89 45 FC 48 8D)
alloc(newmem, 2048, INJECT)
label(code)
label(return)
registerSymbol(INJECT)

newmem:
  // Hook logic goes here
  // Example: Multiply value by 2
  mov eax, [rax+10]
  shl eax, 1
  mov [rbp-04], eax
  jmp return

code:
  // Original instruction
  mov eax,[rax+10]
  mov [rbp-04],eax
  jmp return

INJECT:
  jmp newmem
  nop
return:

[DISABLE]
INJECT:
  // Restore original instructions
  db 8B 40 10 89 45 FC

unregistersymbol(INJECT)
dealloc(newmem)

Script Lua de Injeção Condicional por Versão

-- Activating script based on version check
local REQUIRED_VERSION = 7.5
local currentVersion = getCEVersion()

if currentVersion < REQUIRED_VERSION then
  showMessage("This cheat table requires at least Cheat Engine " .. tostring(REQUIRED_VERSION))
  return
end

-- Hook an event to handle version-based behaviors
local memrec = getAddressList().getMemoryRecordByDescription("Cheat Active State")
if memrec then
  memrec.OnActivate = function(sender, beforeState, currentState)
    if currentState then
      print("Cheat activated on Cheat Engine version " .. tostring(currentVersion))
      -- Safe execution block
      local status, err = pcall(function()
        if currentVersion >= 7.7 then
          -- Run 7.7 optimized routines (e.g., using new memory APIs)
        else
          -- Run 7.5 routines
        end
      end)
      if not status then
        print("Error during activation: " .. tostring(err))
      end
    end
    return true
  end
end