Un cambio en un juego hecho con ayuda de IA debería ser fácil de revisar, aplicar y revertir. «Envía solo los archivos modificados» puede ser una regla útil para la entrega, pero el proyecto completo sigue siendo necesario. El código fuente suele depender de escenas, recursos, ajustes y datos generados por el motor que deben corresponder a la versión de referencia del proyecto.

Esta guía utiliza un juego ficticio de gestión hotelera en el que hay que retocar una regla sobre la salida tardía de los huéspedes. El caso es hipotético. No se ha aplicado ningún parche ni se ha exportado o probado ningún proyecto. El proceso que se describe a continuación te ayudará a pedir un cambio puntual y a preparar una entrega que otro desarrollador pueda revisar.
Define la versión de referencia y el cambio solicitado
Antes de editar, identifica la versión exacta del proyecto, la versión del motor, la rama o copia de trabajo y el archivo que controla el comportamiento. Anota qué debe cambiar y qué debe mantenerse. En este ejemplo, una salida tardía puede alterar la disponibilidad del personal de limpieza sin afectar a los precios de las habitaciones, las reglas de llegada de los huéspedes ni el calendario diario de nóminas.
Facilita al asistente el contexto mínimo necesario, incluido el script pertinente, el código que lo llama, el esquema de datos y las convenciones del proyecto. Si necesita más archivos para entender las dependencias, facilítaselos para evitar que tenga que hacer suposiciones. Pide primero un plan de cambios y después un parche que enumere todos los archivos añadidos, modificados o eliminados, así como cualquier dependencia de escenas, recursos, ajustes o migraciones.
Conserva una versión de referencia limpia en local. El control de versiones te da un punto de comparación estable. Para un experimento puntual, basta con una copia aparte. Mantén el parche separado de otros cambios. Partir de una versión limpia facilita identificar exactamente qué ha cambiado el asistente.
Revisa la lista de archivos y el diff completo
Usa la herramienta de control de versiones para ver el alcance del parche y luego revisa los cambios línea por línea. La documentación de Git recoge opciones de diff como name-only y name-status para listar las rutas que han cambiado. Estas opciones ayudan a responder a la pregunta «¿Qué archivos han cambiado?». Para saber si el parche es correcto, si el código compila o si el cambio se limita al comportamiento previsto, hace falta revisar algo más que esa lista.
Comprueba cada archivo modificado frente a la petición original. Revisa si el cambio de lógica se ciñe a lo pedido y busca nuevas dependencias, código eliminado, cambios en los valores predeterminados y modificaciones en sistemas compartidos. Lee los archivos nuevos con la misma atención que los modificados. Comprueba si alguna escena hace referencia a un script renombrado, si algún campo necesita un valor predeterminado y si el cambio de horario afecta a las partidas guardadas o a otro sistema.
Pide una breve explicación de por qué se ha cambiado cada archivo. Si un archivo fuente tiene asociado un archivo generado o un artefacto de importación del motor, pregunta si el proyecto lo regenera. Evita dar por buena una reescritura extensa solo porque la lista de archivos entregados sea corta. Un cambio en un único gestor puede alterar el comportamiento de todo el juego.
Distingue entre una entrega de código fuente y una exportación del juego
Un parche de código fuente es un conjunto de cambios que se aplican a un proyecto compatible. Puede incluir un script y un archivo de datos y dejar fuera escenas, sprites, configuración o metadatos del motor. Aplícalo al proyecto completo correspondiente y sigue los pasos habituales de edición, importación, compilación y exportación de ese proyecto. Una carpeta con solo parte del código fuente puede necesitar el resto del proyecto para ejecutarse.
Algunos motores admiten formatos específicos para empaquetar parches. La documentación de la versión estable de Godot sobre la línea de comandos describe la opción export-patch para archivos modificados y la opción patches. También explica cómo los comandos de exportación se vinculan a los ajustes preestablecidos y qué hay que tener en cuenta con la exportación base. Es una función de empaquetado propia de Godot. Evita dar por hecho que un ZIP con los archivos fuente modificados sea equivalente o que Unity u otro motor ofrezcan el mismo mecanismo.

Si preparas una entrega para revisión, incluye los archivos modificados, un diff legible, notas sobre las dependencias, las versiones del proyecto y del motor, e instrucciones precisas para aplicar el parche. Si vas a entregar una compilación para una plataforma concreta o un parche en el formato del motor, genéralo con el proceso de exportación que admite el motor y prueba ese mismo artefacto. Indica qué tipo de entrega estás haciendo.
Pide un parche que otro desarrollador pueda entender
Para acotar la petición, pide que se cambie únicamente la regla que ajusta los horarios cuando hay una salida tardía y que se mantengan la asignación de habitaciones, los precios, las llegadas y las nóminas. Indica que se dejen intactas las escenas ajenas al cambio, que se enumeren los archivos modificados y nuevos, que se expliquen las dependencias necesarias y que se incluya un procedimiento para revertir el parche. Pide al asistente un diff unificado o una carpeta que contenga solo los archivos que hayan cambiado, con respecto a una versión de referencia identificada.
Revisa el parche antes de copiarlo al proyecto de trabajo. Comprueba que las rutas sean relativas a la raíz del proyecto, que los nombres de archivo sean correctos, que el parche esté libre de secretos y archivos de caché locales y que el código nuevo siga las convenciones del proyecto. Si el parche sustituye un archivo entero, compáralo con la versión de referencia para evitar que se pierda contenido ajeno al cambio.
Después de aplicar el parche, consulta el estado del control de versiones. Si el asistente dice que ha modificado dos archivos y el diff muestra cambios en diez, detente y averigua el motivo. Algunos archivos generados pueden cambiar al importar el proyecto en el motor. Identifica esos cambios por separado de los cambios previstos en el código fuente y sigue las normas habituales del repositorio.
Aplica el parche, compila y verifica el comportamiento
Aplica el parche a una copia o a una rama limpia y abre el proyecto completo con la versión del motor que le corresponde. Resuelve los problemas de importación y los errores de compilación antes de evaluar el comportamiento solicitado. En el ejemplo del hotel, comprueba la fecha de salida tardía, la disponibilidad de la habitación, la llegada de los huéspedes y el horario de limpieza. Confirma también que los precios y las nóminas ajenos al cambio siguen igual.
Registra el antes y el después, con la versión del proyecto, los archivos modificados, los pasos, el resultado esperado y el resultado observado. Prueba un caso normal, un caso límite y la reversión del parche. Si los datos modificados se guardan de forma persistente, prueba también a guardar y volver a cargar. Si el resultado es una compilación descargable, prueba ese mismo artefacto en la plataforma de destino. La vista previa del editor por sí sola es insuficiente.

Revierte solo los cambios del parche
Antes de aplicar cualquier cambio, conserva un punto de restauración limpio. Si el parche falla, restaura solo los archivos que haya cambiado o revierte el commit que lo contiene de forma aislada. El comando restore de Git permite restaurar rutas concretas. Al restaurar una ruta también se descartan los cambios que tenga en ese momento en el árbol de trabajo, así que comprueba primero si contiene trabajo ajeno al parche.
Verifica también la reversión. Vuelve a abrir el proyecto, comprueba que se recupera el comportamiento anterior y asegúrate de que se conservan los cambios sin confirmar. Evita los comandos de restablecimiento o limpieza que afecten a todo el proyecto cuando el parche del asistente esté mezclado con otros cambios locales.
Preguntas frecuentes
¿Puedo enviar a un asistente de IA solo los archivos fuente modificados del juego?
Sí, si el asistente recibe también el código relacionado que sea pertinente, las convenciones del proyecto y sus restricciones. Conserva en local la versión de referencia del proyecto completo, pide un diff y comprueba que la entrega enumera las dependencias que necesitan los archivos modificados. Indica claramente las rutas y las versiones en la nota de entrega.
¿Un paquete con los archivos modificados equivale a una compilación completa del juego?
No. Los archivos fuente pueden depender de escenas, recursos, ajustes, archivos generados o datos de importación del motor que el paquete no incluya. Aplica el parche al proyecto completo correspondiente y compila o exporta mediante el proceso habitual del proyecto. La persona que revise el parche debe saber qué versión de referencia del proyecto completo necesita.
¿Cómo puedo listar solo los archivos modificados con Git?
Usa una opción de diff de Git como name-only o name-status con respecto a la versión de referencia que corresponda y revisa también el diff completo. Una lista de archivos muestra el alcance de los cambios. Por sí sola, no permite saber si el código es correcto o seguro. Comprueba que el árbol de trabajo esté lo bastante limpio como para interpretar el diff.
¿Puede Godot exportar solo los archivos modificados?
El tutorial de línea de comandos de la versión estable de Godot documenta la opción export-patch para archivos modificados y describe las listas de parches. Esta opción depende de los ajustes preestablecidos de exportación y de una exportación base compatible. Su resultado no equivale a un ZIP cualquiera con una carpeta de código fuente ni a una compilación independiente. Sigue los requisitos sobre los ajustes preestablecidos y la exportación base que recoge la documentación de esa versión del motor.
¿Cómo revierto un parche del código de un juego hecho con IA?
Conserva la versión de referencia o un punto de restauración limpio en el control de versiones antes de aplicar los cambios. Restaura solo los archivos revisados o revierte el parche. Después, vuelve a compilar y comprueba el comportamiento original. Evita los comandos de limpieza que puedan afectar a cambios sin confirmar. Confirma que el proyecto restaurado compila y recupera su comportamiento original.
Deja claro qué entregas
Mantén el proyecto completo como referencia principal. Envía un parche pequeño y fácil de revisar, con sus dependencias y su versión de referencia, y sigue el proceso habitual del proyecto para compilarlo y probarlo. Así, el otro desarrollador recibe los archivos modificados que necesita y sabe que forman parte de un proyecto completo.
Si tienes otra idea para un prototipo jugable en el navegador, prueba SEELE AI Game Maker. Es una vía independiente para crear prototipos, sin funciones para aplicar parches al código ni exportar proyectos existentes.


