GUIA COMPLETO: AGENTES DE IA PARA ANÁLISE DE CÓDIGO DE OTSERVER

[Zmovir 280]

Boa noite pessoal, tudo certo?

Deixo aqui alguns agentes que montei como um kit de inspeção para quem desenvolve em cima de OTServer e quer uma análise completa do server e do client sem ter que ficar mandando arquivo por arquivo para a IA. A ideia é simples: vocês só usam o ORCHESTRATOR.md, dizem para a IA qual é a pasta do servidor e qual é a pasta do client, e o orquestrador roda automaticamente todos os agentes necessários.

Link: 

This is the hidden content, please

• Entre
• ou
• Cadastre-se

O processo funciona em qualquer ambiente: Cursor, Windsurf, VSCode com chat, Claude ou Kiro. Basta abrir o projeto, colar o conteúdo do orquestrador no chat, informar as duas pastas e mandar executar. A IA faz o resto sozinha. No final ela entrega relatórios em Markdown apontando erros de Lua, risco de crash em C++, inconsistências de XML, problemas de tick, conflitos de storage, sincronização protocolo/client e outros pontos importantes que normalmente só aparecem quando o servidor já está rodando.

A ideia é ajudar quem está começando ou quem quer revisar um projeto maior sem perder tempo. É só colar o orquestrador, indicar as pastas e aguardar os relatórios.

Utilizei a base PokeBrave vazada no ano passado para isso, segue input na IA:
 

Leia o arquivo ORCHESTRATOR.md para ter o contexto do que deve rodar, após isso execute cada agente e gere os outputs, na otcv8 vai encontrar informações sobre o client e na server-main vai encontrar as informações sobre o servidor, lembrando que esta base é a Poke Brave vazada em 2024.

Com isso ele leu nossa pasta de Agents e executou todos (Média de 45 minutos para ler todo o projeto e gerar todos os relatórios)

Ele gerou arquivos de saída:
 

PROTOCOL_SYNC.md:

- Compara opcodes, mensagens e estrutura de pacotes entre:
  - Source C++ (server)
  - Client OTC (ou derivados)
- Encontra:
  - OpCodes inconsistentes.
  - Pacotes com tamanhos diferentes em client/server.
  - Campos lidos/escritos em ordem diferente.
  
LUA_ERRORS.md:

- Analisa:
  - Chamadas a funções inexistentes.
  - Uso de variáveis potencialmente `nil`.
  - Callbacks com retorno errado.
  - Loops pesados em eventos frequentes.

CONTENT_INTEGRITY.md:

- Cruza:
  - `items.xml`, `monsters/*.xml`, `spells`, `actions`, `movements`, `weapons`, `vocations`.
- Procura:
  - IDs inexistentes.
  - Loot apontando para itens que não existem.
  - Spells/efeitos inválidos.
  - actions/movements sem script.

TICK_PERFORMANCE.md:

- Olha:
  - Game loop em C++.
  - Scripts Lua de alta frequência (globalevents, onThink, etc.).
- Procura:
  - Loops pesados.
  - Consultas caras em contextos sensíveis.
  - Sistemas que escalam mal com número de players/monstros.

QUEST_STORAGE_REPORT.md:

- Mapeia:
  - Uso de storages em scripts Lua.
- Procura:
  - IDs usados em sistemas diferentes.
  - Storages lidos e nunca escritos.
  - Storages escritos e nunca lidos.
  - Lógicas incoerentes de progresso.

CPP_CRASH_RISKS.md:

- Analisa:
  - Acessos a ponteiros sem checagem.
  - Uso de containers sem validação de limites.
  - Funções com fluxos sem retorno.
  - Switches sem tratamento mínimo de casos inesperados.

CODE_SMELLS.md:

- Em Lua e C++:
  - Funções gigantes.
  - `if` aninhado demais.
  - Código duplicado.
  - Variáveis/funções com nomes genéricos demais em contexto crítico.
  - Mistura de muitas responsabilidades num único trecho.

AGENT_ARCHITECTURE_DOC.md:

- Detalha o funcionamento do servidor e arquitetura, o que cada arquivo faz.

Bom uso a todos!