Use IA para criar um pequeno patch de jogo que você possa revisar e aplicar

Faça uma alteração pontual em um jogo existente e reúna os arquivos-fonte modificados em um pacote. Revise o diff, aplique o patch localmente e verifique o resultado.

Seele Editorial TeamAtualizado 16 de novembro de 2026

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.

Uma pessoa desenvolvedora revisa uma pequena alteração no código de agendamento de um hotel, com o projeto completo e uma lista clara das diferenças entre os arquivos lado a lado.
Ilustração de um cenário fictício de desenvolvimento, sem mostrar um repositório real ou um patch concluído.

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.

Um pequeno conjunto de arquivos-fonte modificados se encaixa no projeto completo correspondente do jogo de hotel, enquanto as cenas e os recursos que dependem deles permanecem no lugar.
A entrega dos arquivos modificados ainda precisa do contexto do projeto correspondente.

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.

A tela de agendamento de um hotel é comparada antes e depois de um pequeno patch, com uma versão de referência salva para permitir a reversão.
A imagem ilustra como seria a revisão. Ela não comprova que um patch tenha sido aplicado ou testado.

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.

Fontes

SEELE AI

Transforme este guia em um projeto jogável.

Comece com um briefing claro e evolua sua ideia no Workspace da Seele AI.

Começar a criar