Steam에 게임을 출시하려고 하는데 빌드 업로드가 안 될 때 확인할 것

Steam 출시 준비를 하다 보면 처음 막히는 지점이 보통 여기입니다.

“빌드는 만들었는데 Steamworks에 안 올라가요.” “업로드는 된 것 같은데 대시보드에서 안 보여요.” “Depot이 뭔지 모르겠어요.”

처음이면 정상입니다. Steam 빌드 업로드는 게임 빌드만 만드는 것과 별개로, Steamworks 설정까지 맞아야 합니다.

먼저 확인할 것

1. Steamworks 앱과 Depot이 연결되어 있는지

Steam은 게임 파일을 바로 앱에 올리는 구조가 아니라, Depot이라는 단위에 빌드를 올립니다.

확인할 것:

• 앱이 생성되어 있는지
• Depot이 생성되어 있는지
• 해당 Depot이 앱에 연결되어 있는지
• 빌드 설정에서 어떤 Depot을 사용할지 지정했는지

Depot 설정이 빠져 있으면 빌드를 올려도 제대로 연결되지 않을 수 있습니다.

2. 실행 파일 경로가 맞는지

Windows 빌드라면 보통 .exe 파일이 기준이 됩니다.

확인할 것:

• 빌드 폴더 안에 실행 파일이 있는지
• 실행 파일 이름이 바뀌지 않았는지
• Steamworks에서 실행 옵션에 해당 .exe 경로를 제대로 넣었는지

예를 들어 빌드 폴더 구조가 바뀌었는데 실행 경로를 예전 그대로 두면, 업로드 후 실행이 안 될 수 있습니다.

3. SteamPipe 설정 파일을 확인했는지

SteamPipe 업로드는 설정 파일을 기준으로 동작합니다.

특히 확인할 것:

• App ID가 맞는지
• Depot ID가 맞는지
• ContentRoot 경로가 실제 빌드 폴더를 가리키는지
• FileMapping 경로가 잘못되어 있지 않은지

경로 문제 때문에 업로드가 실패하는 경우가 많습니다.

4. 빌드 업로드 후 “활성화”까지 했는지

빌드를 업로드했다고 바로 출시 빌드가 되는 것은 아닙니다.

업로드 후에는 Steamworks에서 해당 빌드를 확인하고, 브랜치에 연결해야 합니 다.

확인할 것:

• 업로드된 빌드가 Builds 목록에 보이는지
• default 브랜치 또는 테스트 브랜치에 연결했는지
• 테스트 계정에서 설치/실행이 되는지

5. 처음에는 테스트 브랜치로 확인하기

처음부터 default 브랜치에 올리기보다 테스트 브랜치를 만들어 확인하는 것을 추천합니다.

예:

• internal-test
• beta
• review-build

이런 브랜치에 먼저 올린 뒤, 설치와 실행을 확인하고 문제가 없으면 default로 옮기는 방식이 안전합니다.

빠른 체크리스트

• Steamworks 앱 생성 완료
• Depot 생성 완료
• Depot ID 확인
• App ID 확인
• 빌드 폴더 경로 확인
• .exe 실행 파일 확인
• SteamPipe 설정 파일 확인
• 업로드 후 Builds 목록 확인
• 브랜치 연결 확인
• 테스트 계정으로 설치/실행 확인

정리

Steam 빌드 업로드가 안 될 때는 대부분 게임 코드 문제가 아니라, Steamworks 앱, Depot, SteamPipe 설정, 브랜치 연결 문제인 경우가 많습니 다.

처음 출시를 준비한다면 “빌드 파일을 만들었다”에서 끝내지 말고, Steamworks에서 Depot 생성 → SteamPipe 업로드 → 빌드 확인 → 브랜치 연결 → 테스트 실행 순서로 점검해보면 좋습니다.