AI로 검토하고 적용하기 쉬운 소규모 게임 패치 만들기

기존 게임에서 필요한 부분만 수정하고 변경된 소스 파일을 묶으세요. diff를 검토한 뒤 로컬에서 패치를 적용하고 결과를 확인하세요.

Seele Editorial Team수정일 2026년 11월 16일

AI의 도움을 받아 게임을 수정할 때는 변경 사항을 쉽게 검토하고 적용하고 되돌릴 수 있어야 합니다. ‘변경된 파일만 전달한다’는 원칙은 유용할 수 있지만, 전체 프로젝트는 여전히 필요합니다. 소스 코드는 프로젝트의 기준 버전과 일치해야 하는 씬, 에셋, 설정, 엔진이 생성한 데이터에 의존하는 경우가 많습니다.

개발자가 전체 프로젝트와 한눈에 들어오는 파일 변경 목록을 나란히 놓고 호텔 일정 관리 코드의 작은 변경 사항을 검토하는 모습.
가상의 개발 상황을 그린 이미지입니다. 실제 저장소나 완성된 패치를 보여 주는 것은 아닙니다.

이 가이드에서는 늦은 체크아웃 규칙을 조금 수정해야 하는 가상의 호텔 경영 게임을 예로 듭니다. 실제 프로젝트에 패치를 적용하거나 프로젝트를 내보내거나 테스트한 적은 없습니다. 아래 절차를 따르면 수정 범위를 좁혀 요청하고 다른 개발자가 검토할 수 있는 형태로 변경 사항을 전달할 수 있습니다.

기준 버전과 요청할 변경 사항 정하기

수정하기 전에 정확한 프로젝트 버전과 엔진 버전, 작업할 브랜치 또는 복사본, 해당 동작을 담당하는 파일을 확인하세요. 무엇을 바꾸고 무엇을 유지할지 적어 두세요. 예를 들어 늦은 체크아웃으로 객실 청소가 가능한 시간대를 조정하되 객실 요금, 투숙객 도착 규칙, 일일 급여 처리 일정은 그대로 둘 수 있습니다.

AI 어시스턴트에게는 작업에 필요한 최소한의 맥락을 제공하세요. 관련 스크립트, 호출부, 데이터 스키마, 프로젝트의 작업 규칙을 알려 주면 됩니다. 의존 관계를 파악하는 데 파일이 더 필요하다면 추측하게 두지 말고 해당 파일을 제공하세요. 먼저 변경 계획을 요청한 다음, 추가·수정·삭제되는 모든 파일과 관련 씬, 에셋, 설정, 마이그레이션 의존성을 명시한 패치를 요청하세요.

로컬에 깨끗한 기준 상태를 확보하세요. 버전 관리를 사용하면 안정적인 비교 기준을 마련할 수 있고, 일회성 실험이라면 별도 복사본으로도 충분합니다. 패치에 관련 없는 수정 사항을 섞지 마세요. 시작 상태가 깨끗하면 어시스턴트가 정확히 무엇을 바꿨는지 파악하기 쉽습니다.

파일 목록과 실제 diff 검토하기

버전 관리 도구로 변경 범위를 파악한 뒤 줄 단위로 변경 내용을 확인하세요. Git 문서에는 변경된 경로를 나열하는 name-only, name-status 같은 diff 표시 옵션이 나와 있습니다. 이 옵션을 사용하면 어떤 파일이 바뀌었는지 확인할 수 있습니다. 패치가 올바른지, 컴파일되는지, 변경이 의도한 동작에만 영향을 주는지는 실제 내용을 검토해야 알 수 있습니다.

변경된 파일을 하나씩 요청 내용과 대조하세요. 로직 변경이 필요한 범위에 그치는지 살펴보고, 새 의존성, 삭제된 코드, 바뀐 기본값, 공용 시스템의 수정 사항이 있는지 확인하세요. 새 파일도 수정된 파일만큼 꼼꼼히 읽으세요. 이름이 바뀐 스크립트를 참조하는 씬이 있는지, 데이터 필드에 기본값이 필요한지, 일정 변경이 저장 데이터나 다른 시스템에 영향을 주는지 확인하세요.

각 파일을 변경한 이유를 간단히 설명해 달라고 하세요. 소스 파일에 대응하는 자동 생성 파일이나 엔진의 가져오기 과정에서 생기는 산출물이 있다면 프로젝트에서 이를 다시 생성하는지 물어보세요. 변경 파일 목록이 짧다는 이유만으로 대대적인 재작성을 받아들이지 마세요. 매니저 하나만 수정해도 게임 전반의 동작이 달라질 수 있습니다.

소스 파일 전달과 게임 내보내기 구분하기

소스 패치는 기준 버전이 일치하는 프로젝트에 적용하는 변경 사항의 묶음입니다. 스크립트와 데이터 파일을 포함하더라도 씬, 스프라이트, 설정, 엔진 메타데이터는 빠져 있을 수 있습니다. 대상 전체 프로젝트에 패치를 적용하고 해당 프로젝트에서 평소 사용하는 편집기, 가져오기, 빌드, 내보내기 절차를 따르세요. 소스 파일 일부만 담긴 폴더는 단독으로 실행되지 않을 수 있습니다.

일부 엔진은 전용 패치 패키지를 지원합니다. Godot 안정 버전의 명령줄 문서에는 변경된 파일을 내보내는 export-patch 옵션과 patches 옵션이 설명되어 있습니다. 이 문서에서는 내보내기 명령에 설정된 프리셋을 사용하는 방법과 기준 내보내기 결과물에 관해 고려할 사항도 다룹니다. 이는 Godot 전용 패키징 기능입니다. 변경된 소스 파일을 ZIP으로 묶으면 같은 결과를 얻을 수 있다거나 Unity 또는 다른 엔진에도 같은 방식이 적용된다고 가정하지 마세요.

변경된 소스 파일 몇 개가 기준 버전이 일치하는 호텔 게임의 전체 프로젝트에 들어가고, 해당 파일이 의존하는 씬과 에셋은 제자리에 남아 있는 모습.
변경된 파일만 전달하더라도 그 파일이 적용될 프로젝트의 맥락은 필요합니다.

검토자에게 전달할 자료라면 변경된 파일, 읽기 쉬운 diff, 의존성 참고 사항, 프로젝트와 엔진 버전, 정확한 적용 절차를 포함하세요. 특정 플랫폼용 빌드나 엔진 패치가 필요하다면 엔진이 지원하는 내보내기 절차로 만들고 해당 결과물 자체를 테스트하세요. 어떤 결과물을 전달하는지 명시하세요.

다른 개발자가 이해할 수 있는 패치 요청하기

작업 범위를 명확히 정하려면 이렇게 요청할 수 있습니다. ‘늦은 체크아웃 일정 규칙만 수정하세요. 객실 배정, 요금, 투숙객 도착, 급여 처리는 그대로 두고 관련 없는 씬은 수정하지 마세요. 변경하거나 추가한 파일을 모두 나열하고, 필요한 의존성을 설명하고, 롤백 절차를 포함하세요.’ 기준 버전을 명시한 뒤, 이를 기준으로 통합 diff를 제공하거나 변경된 파일만 별도 디렉터리에 정리해 달라고 요청하세요.

작업 중인 프로젝트에 파일을 덮어쓰기 전에 패치를 검토하세요. 경로가 프로젝트 루트 기준의 상대 경로인지, 파일 이름이 정확한지, 비밀 정보나 로컬 캐시 파일이 포함되지 않았는지, 새 코드가 프로젝트 규칙을 따르는지 확인하세요. 파일 전체를 교체하는 패치라면 기준 버전과 비교해 변경 범위 밖의 내용이 사라지지 않는지 확인하세요.

패치를 적용한 뒤 버전 관리 도구에서 상태를 확인하세요. 어시스턴트는 파일 두 개를 수정했다고 했는데 diff에 파일 열 개가 나온다면 작업을 멈추고 이유를 살펴보세요. 엔진에서 가져오기를 실행하는 동안 자동 생성 파일이 바뀔 수 있습니다. 이런 변경은 의도한 소스 수정과 구분하고 프로젝트의 기존 저장소 관리 규칙을 따르세요.

패치를 적용하고 빌드한 뒤 동작 확인하기

복사본이나 깨끗한 브랜치에 패치를 적용한 뒤 프로젝트에 맞는 엔진 버전으로 전체 프로젝트를 여세요. 요청한 동작을 평가하기 전에 가져오기 문제와 빌드 오류를 해결하세요. 호텔 게임 예시에서는 늦은 체크아웃 날짜, 객실 이용 가능 여부, 투숙객 도착, 객실 청소 일정을 확인하세요. 변경과 무관한 요금과 급여 처리에도 변화가 없는지 확인하세요.

프로젝트 버전, 변경된 파일, 재현 절차, 예상 결과, 실제 결과를 변경 전후로 기록하세요. 정상적인 사용 흐름과 경계 사례를 테스트하고, 변경된 데이터가 유지되는 경우에는 저장과 다시 불러오기도 테스트하세요. 롤백도 테스트하세요. 다운로드할 수 있는 빌드를 만들었다면 편집기 미리보기에만 의존하지 말고 대상 플랫폼에서 해당 빌드를 테스트하세요.

작은 패치를 적용하기 전후의 호텔 일정 화면을 비교하며, 롤백에 사용할 기준 버전이 저장되어 있는 모습.
검토 과정을 설명하기 위한 이미지입니다. 실제로 패치를 적용하거나 테스트했다는 증거는 아닙니다.

되돌릴 범위를 확인하고 필요한 부분만 롤백하기

변경 사항을 적용하기 전에 깨끗한 기준 상태를 저장해 두세요. 패치가 실패하면 패치가 바꾼 파일만 복원하거나 패치만 담은 커밋을 되돌리세요. Git의 restore 명령은 선택한 경로를 복원할 수 있지만, 그 경로에 있는 현재 작업 트리의 변경 사항도 사라집니다. 먼저 다른 작업이 섞여 있는지 확인하세요.

롤백 결과도 검증하세요. 프로젝트를 다시 열어 이전 동작이 돌아왔는지, 커밋하지 않은 작업이 지워지지 않았는지 확인하세요. 어시스턴트의 패치에 다른 로컬 변경 사항이 섞여 있다면 광범위한 초기화나 정리 명령은 피하세요.

자주 묻는 질문

AI 어시스턴트에게 변경된 게임 소스 파일만 보내도 되나요?

네. 해당 파일과 관련된 주변 코드, 프로젝트 규칙, 제약 조건도 함께 제공해야 합니다. 기준이 되는 전체 프로젝트는 로컬에 보관하고 diff를 요청하세요. 전달 자료에 변경된 파일이 필요로 하는 의존성이 나열되어 있는지도 확인하세요. 전달 메모에는 경로와 버전 정보를 명확히 적으세요.

변경된 파일만 묶어도 완전한 게임 빌드가 되나요?

아니요. 소스 파일은 패키지에 포함되지 않은 씬, 에셋, 설정, 자동 생성 파일, 엔진 가져오기 데이터에 의존할 수 있습니다. 기준 버전이 일치하는 전체 프로젝트에 패치를 적용하고 평소 절차에 따라 빌드하거나 내보내세요. 검토자도 전체 프로젝트의 어느 버전이 필요한지 알아야 합니다.

Git에서 수정된 파일만 나열하려면 어떻게 하나요?

대상 기준 버전과 비교할 때 name-only 또는 name-status 같은 Git diff 표시 옵션을 사용한 뒤 실제 diff도 살펴보세요. 파일 목록으로는 변경 범위를 파악할 수 있지만 코드의 정확성이나 안전성까지 판단할 수는 없습니다. diff를 해석하는 데 방해가 될 변경 사항이 작업 트리에 섞여 있지 않은지 확인하세요.

Godot에서 변경된 파일만 내보낼 수 있나요?

Godot 안정 버전의 명령줄 튜토리얼은 변경된 파일과 패치 목록을 다루는 export-patch 옵션을 설명합니다. 이 기능을 사용하려면 내보내기 프리셋과 호환되는 기준 내보내기 결과물이 필요합니다. 일반적인 소스 폴더 ZIP 파일이나 독립 실행형 빌드와는 다릅니다. 사용 중인 엔진 버전의 문서에 명시된 프리셋과 기준 내보내기 요건을 따르세요.

AI가 만든 게임 코드 패치는 어떻게 롤백하나요?

변경 사항을 적용하기 전에 기준 버전을 보관하거나 버전 관리에서 깨끗한 시점을 확보하세요. 검토한 파일만 복원하거나 패치를 되돌린 뒤, 복원된 프로젝트가 정상적으로 빌드되고 원래 동작이 돌아오는지 확인하세요. 커밋하지 않은 작업에 영향을 줄 수 있는 광범위한 정리 명령은 피하세요.

전달할 내용 명확히 하기

전체 프로젝트를 기준으로 삼으세요. 검토하기 쉬운 작은 패치에 의존성과 기준 버전을 명시해 전달하고, 프로젝트의 평소 절차에 따라 빌드하고 테스트하세요. 그러면 다른 개발자가 필요한 변경 파일을 받으면서도 해당 파일만으로 완성된 게임이 제공되는 것은 아니라는 점을 알 수 있습니다.

브라우저에서 플레이할 수 있는 별도의 프로토타입 아이디어가 있다면 SEELE AI Game Maker를 사용해 보세요. 이 도구는 별도의 프로토타입 제작용이며, 코드를 패치하거나 기존 프로젝트를 내보내는 기능은 제공하지 않습니다.

출처

SEELE AI

이 가이드를 플레이할 수 있는 작품으로 만드세요.

구체적인 기획으로 시작해 Seele AI 워크스페이스에서 개선하세요.

만들기 시작