이번 단계에서는 언리얼 프로젝트를 GitHub에 업로드하고, README 파일을 작성해봅니다. 아직 사전 준비를 완료하지 않았다면 Step 0. 사전 준비 를 먼저 진행해주세요.


1-1. 레포지토리 생성하기

레포지토리(Repository)는 프로젝트의 모든 파일과 변경 이력을 저장하는 공간입니다. 줄여서 "레포"라고도 부릅니다.

GitHub Desktop을 실행하고 GitHub 계정을 연동한 뒤, Create a New Repository를 선택합니다.

스크린샷 2026-01-09 202408.png

각 항목을 다음과 같이 설정합니다:

항목 설정 방법
Name 언리얼 프로젝트 폴더 이름 (예: ShootBox)
Local path 프로젝트 폴더의 상위 폴더 선택
Git ignore UnrealEngine 선택

⚠️ Local path 설정 주의

예를 들어 프로젝트가 D:/Projects/ShootBox에 있다면, Local path는 D:/Projects로 설정합니다. Name에 입력한 폴더명과 합쳐져서 D:/Projects/ShootBox가 레포지토리가 됩니다.

.gitignore란?

Git이 추적하지 않을 파일 목록을 정의하는 파일입니다. 언리얼 프로젝트에는 빌드할 때마다 자동 생성되는 파일들이 많은데, 이런 파일들은 굳이 Git에 저장할 필요가 없습니다.

UnrealEngine을 선택하면 다음과 같은 항목들이 자동으로 제외됩니다:


1-2. GitHub에 업로드하기

Create repository를 클릭하면 로컬(내 PC)에 Git 저장소가 생성됩니다. 하지만 아직 GitHub 서버에는 올라가지 않은 상태입니다.