Uma alteração em um jogo feita com ajuda de IA deve ser fácil de inspecionar, aplicar e reverter. “Envie apenas os arquivos modificados” pode ser uma regra útil para a entrega, mas o projeto completo continua sendo necessário. O código-fonte costuma depender de cenas, recursos, configurações e dados gerados pela engine que precisam corresponder à versão de referência do projeto.

Este guia usa como exemplo um jogo fictício de gestão hoteleira em que uma regra de checkout tardio precisa de um pequeno ajuste. O cenário é hipotético. Nenhum projeto recebeu um patch, foi exportado ou passou por testes. O fluxo abaixo ajuda você a pedir uma alteração pontual e preparar uma entrega que outra pessoa da equipe de desenvolvimento possa revisar.
Defina a versão de referência e a alteração solicitada
Antes de editar, identifique a versão exata do projeto, a versão da engine, a branch ou cópia de trabalho e o arquivo que controla o comportamento. Registre o que deve mudar e o que deve permanecer igual. No exemplo, um checkout tardio pode alterar a disponibilidade da equipe de limpeza sem mudar as tarifas dos quartos, as regras de chegada dos hóspedes ou a programação diária da folha de pagamento.
Forneça ao assistente apenas o contexto necessário: o script relevante, o código que o chama, o esquema de dados e as convenções do projeto. Se ele precisar de mais arquivos para entender as dependências, forneça esses arquivos em vez de pedir que faça suposições. Solicite primeiro um plano de alteração e depois um patch que liste cada arquivo adicionado, modificado ou removido, além de quaisquer dependências de cenas, recursos, configurações ou migrações.
Mantenha uma versão de referência local limpa. O controle de versão oferece um ponto de comparação estável. Para um teste pontual, uma cópia separada também serve. Evite misturar o patch com alterações sem relação com a tarefa. Um ponto de partida limpo facilita identificar exatamente o que o assistente mudou.
Revise a lista de arquivos e o conteúdo do diff
Use a ferramenta de controle de versão para conferir o escopo e, em seguida, examine as alterações linha por linha. A documentação do Git descreve visualizações do diff como name-only e name-status, que listam os caminhos alterados. Essas visualizações ajudam a responder à pergunta “quais arquivos mudaram?”. Elas não informam se o patch está correto, se o código compila ou se a alteração se limita ao comportamento pretendido.
Compare cada arquivo modificado com o pedido. Verifique se a alteração na lógica é pontual e procure novas dependências, trechos de código removidos, mudanças nos valores padrão e edições em sistemas compartilhados. Leia os arquivos novos com o mesmo cuidado dedicado aos modificados. Confira se alguma cena faz referência a um script renomeado, se algum campo de dados precisa de um valor padrão e se uma mudança no agendamento afeta dados salvos ou outro sistema.
Peça uma explicação breve sobre o motivo de cada alteração. Se um arquivo-fonte tiver um arquivo gerado associado ou um artefato de importação da engine, pergunte se o projeto o gera novamente. Evite aceitar uma grande reescrita só porque a lista de arquivos é curta. Uma única alteração em um gerenciador pode afetar o comportamento do jogo inteiro.
Diferencie a entrega de código-fonte da exportação do jogo
Um patch de código-fonte é um conjunto de alterações para aplicar a um projeto que corresponda à versão de referência. Ele pode incluir um script e um arquivo de dados e deixar de fora cenas, sprites, configurações ou metadados da engine. Aplique o patch ao projeto completo correspondente e siga as etapas habituais de edição, importação, compilação e exportação desse projeto. Uma pasta com apenas parte do código-fonte pode não funcionar por conta própria.
Algumas engines oferecem formatos específicos para pacotes de patch. A documentação de linha de comando da versão estável do Godot descreve a opção export-patch para arquivos alterados e a opção patches. Ela também explica como os comandos de exportação dependem dos perfis de exportação configurados e o que considerar sobre a exportação base de cada perfil. Esse recurso de empacotamento é específico do Godot. Evite presumir que um ZIP de arquivos-fonte modificados seja equivalente ou que o mesmo mecanismo se aplique ao Unity ou a outra engine.

Se a entrega for destinada à revisão, inclua os arquivos modificados, um diff legível, notas sobre as dependências, as versões do projeto e da engine e instruções exatas para aplicar o patch. Se a entrega for uma build para uma plataforma ou um patch da engine, use o fluxo de exportação compatível com a engine e teste o artefato que será entregue. Identifique o tipo de entrega.
Peça um patch que outra pessoa da equipe possa entender
Um pedido bem delimitado pode especificar que o assistente deve alterar apenas a regra de agendamento do checkout tardio, preservar a atribuição de quartos, os preços, as chegadas e a folha de pagamento, manter intactas as cenas sem relação com a alteração, listar os arquivos modificados e novos, explicar as dependências necessárias e incluir um procedimento de reversão. Peça ao assistente um diff unificado ou uma pasta que contenha apenas os arquivos alterados em relação a uma versão de referência identificada.
Revise o patch antes de copiar os arquivos para o projeto de trabalho. Confirme que os caminhos são relativos à raiz do projeto, que os nomes dos arquivos estão corretos, que o pacote não inclui segredos nem arquivos de cache locais e que o código novo segue as convenções do projeto. Se o patch incluir um arquivo inteiro para substituição, compare-o com a versão de referência para evitar a perda de conteúdo que não faz parte da alteração.
Depois de aplicar o patch, consulte o status no controle de versão. Se o assistente disser que alterou dois arquivos, mas o diff mostrar mudanças em dez, interrompa o processo e investigue o motivo. Arquivos gerados podem mudar durante uma importação pela engine. Separe essas alterações das mudanças intencionais no código-fonte e siga as regras habituais do repositório do projeto.
Aplique o patch, compile e verifique o comportamento
Aplique o patch a uma cópia ou branch limpa e abra o projeto completo com a versão da engine prevista para ele. Resolva problemas de importação e erros de compilação antes de avaliar o comportamento solicitado. No exemplo do hotel, verifique a data do checkout tardio, a disponibilidade do quarto, a chegada do hóspede e a escala da equipe de limpeza. Confirme também que os preços e a folha de pagamento permanecem iguais.
Mantenha um registro de antes e depois com a versão do projeto, os arquivos modificados, as etapas, o resultado esperado e o resultado observado. Teste um fluxo normal, um caso limite e a reversão. Se os dados alterados forem persistentes, teste também se eles são salvos e recarregados corretamente. Se o resultado for uma build para download, teste esse artefato na plataforma de destino em vez de depender da prévia no editor.

Planeje a reversão e limite seu escopo
Antes de aplicar qualquer alteração, salve um ponto de restauração limpo. Se o patch falhar, restaure apenas os arquivos que ele alterou ou reverta o commit isolado. O comando restore do Git pode restaurar caminhos específicos, mas, ao restaurar um caminho, também descarta as alterações que ele tiver na árvore de trabalho. Antes de usar o comando, verifique se há trabalho sem relação com o patch.
Verifique também a reversão. Reabra o projeto, confirme que o comportamento anterior voltou e certifique-se de que o trabalho ainda sem commit foi preservado. Evite comandos de reset ou limpeza de amplo alcance quando o patch do assistente estiver misturado com outras alterações locais.
Perguntas frequentes
Posso enviar apenas os arquivos-fonte modificados do jogo a um assistente de IA?
Sim, desde que o assistente também receba os trechos de código relacionados, as convenções do projeto e as restrições aplicáveis. Mantenha uma versão de referência local do projeto completo, solicite um diff e confira se a entrega lista as dependências dos arquivos modificados. Informe os caminhos e os detalhes das versões nas notas de entrega.
Um pacote com os arquivos modificados gera uma build completa do jogo?
Não. Os arquivos-fonte podem depender de cenas, recursos, configurações, arquivos gerados ou dados de importação da engine que ficaram fora do pacote. Aplique o patch ao projeto completo correspondente e compile ou exporte pelo processo habitual do projeto. Quem fizer a revisão precisa saber qual versão de referência do projeto completo deve usar.
Como listar apenas os arquivos modificados com o Git?
Use uma visualização do diff do Git, como name-only ou name-status, para comparar com a versão de referência pretendida. Depois, examine também o conteúdo do diff. Uma lista de arquivos mostra o escopo das alterações, mas não indica se o código está correto ou se é seguro. Confirme que sua árvore de trabalho está limpa o suficiente para interpretar o diff.
O Godot pode exportar apenas os arquivos alterados?
O tutorial de linha de comando da versão estável do Godot documenta a opção export-patch para arquivos alterados e listas de patches. Ela depende do perfil de exportação e de uma exportação base compatível e não equivale a um ZIP comum da pasta de código-fonte nem a uma build independente. Siga os requisitos de perfil e de exportação base documentados para essa versão da engine.
Como reverter um patch no código de um jogo feito com IA?
Antes de aplicar as alterações, preserve a versão de referência ou salve um ponto de restauração limpo no controle de versão. Restaure apenas os arquivos revisados ou reverta o patch. Evite comandos de limpeza de amplo alcance quando houver trabalho ainda sem commit. Em seguida, compile novamente e confirme que o projeto restaurado compila e que o comportamento original voltou.
Deixe claro o que está sendo entregue
Mantenha o projeto completo como referência oficial. Envie um patch pequeno e fácil de revisar, com as dependências e a versão de referência, e depois compile e teste pelo fluxo habitual do projeto. Assim, quem receber o patch terá os arquivos modificados de que precisa e saberá que eles fazem parte de um projeto maior.
Se você tiver outra ideia e quiser criar um protótipo jogável no navegador, experimente o SEELE AI Game Maker. Essa é uma opção independente para criar protótipos, sem recursos para aplicar patches ao código ou exportar projetos existentes.


