Community코딩 & 개발github.com

BaronCyrus/ship-steam

Unity 게임을 Windows 버전으로 빌드하여 Steam에 출시하기 위한 가이드입니다. Steamworks 등록부터 스토어 페이지 제출, 빌드 심사까지의 전체 과정을 다룹니다.

ship-steam란 무엇인가요?

이 스킬은 개발자가 Unity 게임을 Windows 64비트 빌드로 만들어 Steam에 출시하는 전체 과정을 안내합니다. Steamworks 파트너 등록, 비밀 유지 계약 및 Steam 배포 계약 체결, 100달러 등록비 납부, 은행 및 W-8BEN 세금 정보 입력, 신분증 제출 등 모든 선행 단계를 다룹니다. 또한 macOS에서 Mono 스크립팅 백엔드를 사용하여 Windows 빌드를 생성하는 방법, SteamPipe를 통한 빌드 업로드, 스토어 페이지 및 빌드 심사 제출 절차를 포함합니다. 현재 P1(계정) 및 P2(결제, 세금, 신원 인증)는 실제 테스트를 완료했으며, P3(Windows 빌드)는 빈 프로젝트에서만 테스트되었습니다. P4~P6(앱 생성, 빌드 업로드, 출시)은 아직 실전 경험이 없으며, 공식 문서를 기반으로 한 계획 단계입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BaronCyrus/ShipMyGame/tree/HEAD/skills/ship-steam

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Steam: Steamworks 등록부터 심사 제출까지 (계획 중)

상태: 이 채널은 '계획 중'이며, 아직 실제 '심사 중' 단계까지 진행되지 않았습니다.

  • [실측] 완료된 단계: P1 계정, P2 결제, 세금 및 신원 인증 (2026-11-03, 중국 본토 개인 개발자, 서류 업로드 완료, Steam 심사 대기 중). P3 패키징 스크립트는 빈 프로젝트에서만 실행 성공.
  • 완료되지 않은 단계: P4 이후는 개요와 공식 링크만 있습니다. 해당 단계에 도달하면 실제 백엔드 페이지를 기준으로 하며, 여기와 다른 점은 진행 기록의 'skill과 불일치' 항목에 기록합니다.

선행: ship-my-game의 1~4단계가 완료되었는지 확인하세요 (진행 기록, 채널, 체크리스트, 브라우저). 완료되지 않았다면 먼저 읽으십시오. 이 채널의 진행 상황은 진행 기록의 ## steam 섹션에 기록됩니다.

기밀 유지: Steamworks 백엔드 페이지는 모두 Valve 기밀로 표시되어 있으며, 《Steam 배포 계약》의 조항 자체도 기밀 정보입니다. 백엔드에서 읽은 내용은 사용자에게 설명할 수 있지만, 이 저장소, 진행 기록 또는 공개되는 어떤 장소에도 복사해서는 안 됩니다. 이 스킬은 공개 문서의 규칙과 작업 경험만 기록합니다.

시작 전 사용자에게 다음 세 가지를 물어보고 답변을 진행 기록에 기록하십시오:

  1. 어떤 Steam 계정으로 등록합니까? 새로 생성된 계정은 '제한된 계정'이며, 계정의 스토어 국가는 첫 구매 위치에 따라 결정됩니다. 자세한 내용은 onboarding.md 1절을 참조하십시오.
  2. 결제 수금에 사용할 계정: 국내 은행 (SWIFT 송금) 또는 제3자 플랫폼의 미국 수취 계정? P1에서 법정 영문 이름을 입력하기 전에, 이 계정이 인식하는 영문 예금주명을 먼저 확인하고 Steam에 그대로 입력하십시오. 양쪽이 일치하지 않으면 은행 정보를 저장할 수 없으며, 이름과 성의 순서가 달라도 안 됩니다 [실측-실패 → 수정 완료]. Steam에 이름을 입력한 후 변경하려면 Steam 쪽에서 처음부터 다시 등록해야 합니다 (세금 설문을 제출한 경우, 먼저 고객 지원에 문의하여 세금 설문 및 신원 인증을 취소해야 함). 결제 플랫폼 쪽에서는 스크린샷을 통한 심사 및 추가 등록이 필요하므로 모두 시간이 오래 걸립니다. Payoneer가 인식하는 이름과 확인 위치는 onboarding.md 2절을 참조하십시오.
  3. 어떤 게임을 Steam에 출시합니까? 게임에 광고가 포함되어 있습니까? Steam은 광고를 비즈니스 모델로 하는 애플리케이션을 허용하지 않습니다 공식.

그런 다음 사용자에게 일정을 알려주십시오:

항목소요 시간근거
은행, 세금, 신원 심사15~30일; 실제로 세금 정보 제출 후 백엔드에 최대 약 30영업일 소요 표시공식; [실측]
등록비 납부부터 판매 가능까지30일. 입문 문서에는 21일이라고 쓰여 있지만, Steam Direct 페이지와 일치하지 않으므로 30일로 준비Steam Direct, 입문 문서
'Coming Soon' 페이지 공개판매까지 최소 2주공식
스토어 페이지 심사일반적으로 3~5영업일, 출시 예정일 최소 7일 전 제출 권장공식
빌드 심사1~5일공식

본인 작업

작업단계
Steam 계정 생성; Steam 및 Steamworks 로그인 (비밀번호, Steam Guard 코드)P1
비밀 유지 계약 및 《Steam 배포 계약》 서명: 먼저 3~5문장으로 요점을 설명하면 사용자가 직접 체크하고 인증번호를 입력P1
100달러 등록비 납부P1
은행 계좌 및 외국 세금 번호 입력; W-8BEN 서명; 신분증 사진 및 신분증 소지 셀카 촬영 후 업로드P2
제3자 결제 플랫폼에 예금주명 표기 방식 추가 등록 (필요시)P2
스토어 페이지 및 빌드 심사 제출, 출시 클릭: 사용자가 '제출'이라고 말하면 AI가 클릭하고, 권한 시스템에 막히면 사용자가 클릭P4~P6

엔지니어링 요구 사항

ship-my-game 3단계에서 아래 표와의 차이점을 확인하십시오. 자세한 내용은 references/build.md를 참조하십시오.

항목요구 사항근거
플랫폼Windows 64비트—
스크립트 백엔드Mac에서는 Mono만 가능: Unity는 macOS에서 Windows용 IL2CPP 크로스 컴파일을 지원하지 않으며, Mac용 Hub도 'Windows Build Support (Mono)' 모듈만 제공합니다. IL2CPP를 사용하려면 Windows에서 빌드해야 함공식; [실측]
모듈Windows Build Support (Mono), 설치 방법은 build.md 2절 참조[실측: 6000.6.5f1]
씬 리스트Build Settings의 씬 리스트는 비어 있을 수 없음; scripts/ShipSteamBuild.cs는 빈 리스트에서 직접 오류 발생[실측-실패 → 수정 완료]
광고Steam 버전은 광고 SDK 및 광고 진입점을 제거공식
Steamworks SDK도전 과제, 클라우드 저장 등 기능은 아직 실측되지 않음—

단계

명령어 및 링크의 상대 경로 (scripts/…, ../ship-my-game/…)는 이 스킬 디렉토리를 기준으로 합니다.

P1 계정: Steamworks 파트너, 두 계약, 등록비 [실측]

  1. onboarding.md 1절에 따라 Steam 계정 및 네트워크를 준비하십시오. 계정 생성 및 등록비 납부 시 프록시를 사용하지 마십시오. 그렇지 않으면 계정의 스토어 국가가 다른 국가로 설정됩니다.
  2. 결제 수취 계정이 인식하는 영문 예금주명을 확인하고 (시작 전 2번 질문), 법정 영문 이름의 표기 방식을 결정하십시오: 예금주명과 철자, 이름/성 순서, 공백까지 완전히 일치해야 합니다. onboarding.md 2절을 참조하십시오.
  3. https://partner.steamgames.com/ 을 열고 사용자에게 로그인을 요청하십시오 (모바일 Steam 앱 QR 코드가 가장 빠름). 'Steamworks 가입'을 클릭하고 onboarding.md 2절에 따라 법정 영문 이름, 회사 형태, 현재 주소를 입력한 후 비밀 유지 계약에 서명하십시오.
  4. 메인 패널로 돌아와 '기능 추가'에서 '게임 또는 소프트웨어 판매' 등록으로 이동: 《Steam 배포 계약》에 서명한 후 등록비를 납부하십시오. onboarding.md 3절을 참조하십시오.

완료 기준:

  • 회사 정보 페이지의 법정 이름이 결제 수취 계정이 인식하는 특정 예금주명과 완전히 일치해야 합니다.
  • 회사 정보 페이지의 '서명된 계약'에 비밀 유지 계약과 소프트웨어 배포 계약 두 개가 있어야 합니다.
  • 등록비가 납부되었으며, 납부 날짜가 진행 기록에 기록되어야 합니다 (30일 판매 대기 기간은 이 날짜부터 계산).
  • 계정의 스토어 국가가 사용자의 실제 거주 국가와 일치해야 합니다.

P2 결제, 세금 및 신원 인증 [실측: 서류 업로드 완료, 심사 대기 중]

  1. 은행 정보: 먼저 은행 계좌 소재 국가를 선택하면 양식 필드가 변경됩니다. 수취인 영문 이름은 법정 영문 이름과 완전히 일치해야 합니다. payouts.md 2, 3절을 참조하십시오.
  2. 세금 설문 (제3자 Tax Identity, W-8BEN 생성): 이메일은 반드시 Steam 계정에 연결된 이메일을 입력해야 합니다. 외국 세금 번호는 18자리 주민등록번호를 입력하십시오. 페이지별 내용은 payouts.md 4절을 참조하십시오.
  3. 신분증: 세금 정보 제출 후 메인 패널에 서류 업로드 대기 항목이 나타납니다 (실측 당일 나타남). 요청 페이지의 조건을 사용자에게 하나씩 읽어주십시오. 신분증 사진과 신분증 소지 셀카를 한 번에 모두 업로드하고 30일 이내에 완료하십시오. payouts.md 5절을 참조하십시오.

완료 기준:

  • 은행 정보가 저장되었고, 세금 정보가 제출되었으며, 신분증 사진과 셀카가 업로드되고 업로드 확인을 받았습니다.
  • 진행 기록의 '대기 중'에 서류 업로드 날짜, 예상 종료 날짜 (최대 약 30영업일) 및 Steamworks 메인 패널에서 결과를 확인하라는 내용이 기록되어야 합니다.
  • 제3자 결제 플랫폼 사용 시: Steam의 법정 영문 이름이 플랫폼이 인식하는 예금주명 목록에 있어야 합니다 (Payoneer의 경우 USD 계좌 상세의 '기타 수취인 이름'에서 확인).

P3 Windows 빌드 [실측: 빈 프로젝트]

  1. Windows Build Support (Mono) 모듈을 설치하십시오. build.md 2절을 참조하십시오.
  2. scripts/ShipSteamBuild.cs를 게임의 Assets/Editor/에 복사한 후 빌드하십시오:
    ../ship-my-game/scripts/unity_build.sh <프로젝트_디렉토리> Win64 ShipSteamBuild.Win64 steam-win64 -shipVersion 1.0.0
    
  3. 자체 점검: 로그에 [ShipSteam] Succeeded가 있어야 합니다. file Builds/Steam/Windows/<제품명>.exe 출력이 PE32+ executable (GUI) x86-64여야 합니다. 같은 디렉토리에 MonoBleedingEdge가 있어야 합니다.
  4. Steam 버전에서 광고를 제거하십시오. Mac에서는 Windows 패키지를 실행할 수 없습니다: Windows 컴퓨터가 있다면 사용자에게 실제로 플레이해 보도록 요청하십시오. 이 단계는 아직 이 저장소에서 실측되지 않았습니다.

완료 기준: 64비트 Windows 패키지가 있어야 합니다. 진행 기록에 버전 번호, 패키지 크기 및 Windows에서 실행되었는지 여부가 기록되어야 합니다.

P4 앱 및 스토어 페이지 생성 (실측되지 않음)

  • 메인 패널의 '새 애플리케이션 생성'은 등록비로 얻은 크레딧을 사용합니다. 먼저 애플리케이션을 생성하십시오.
  • 스토어 페이지를 작성하고, 그래픽 자산을 업로드하고, 가격을 설정한 후 스토어 페이지 심사를 제출하십시오. 승인 후 'Coming Royal'로 공개되며, 최소 2주 후에 판매할 수 있습니다.
  • 근거: Coming Royal, 스토어 그래픽 자산, 출시 프로세스.

완료 기준: 스토어 페이지가 심사에 들어갔습니다. 이 채널의 첫 번째 '심사 중' 단계입니다. 이 단계에 도달하면 MAINTAINING.md에 따라 Steam을 README의 '수집됨' 목록에 추가하는 것을 고려하십시오.

P5 빌드 업로드 (실측되지 않음)

완료 기준: 빌드가 심사에 들어갔습니다.

P6 출시 (실측되지 않음)

  • 스토어 페이지와 빌드가 모두 심사를 통과하고, 'Coming Royal' 기간이 2주가 지나고, 등록비 납부 후 30일이 지난 후, 심사 게이트에 따라 사용자에게 출시할 내용을 나열합니다. 사용자가 '출시'라고 말한 후에 클릭하십시오.
  • 근거: 출시 프로세스.

대기 기간

  • Steam 계정 심사 대기 (최대 약 30영업일): 서류를 다시 업로드하거나 세금 설문을 다시 제출하지 마십시오. 그렇지 않으면 대기열 끝으로 밀려납니다. 이 기간 동안 Steam 버전 빌드 (광고 제거, PC 조작에 맞게 조정) 및 스토어 자료와 카피를 준비하십시오. 실제로 심사 기간 동안 메인 패널에서 새 애플리케이션을 이미 생성할 수 있었습니다 [실측].
  • 제3자 플랫폼의 예금주명 심사 대기 (실측 두 번째 제출 당일 통과): 통과 후 USD 계좌 상세의 '기타 수취인 이름'에서 새 표기 방식이 목록에 있는지 확인하십시오. payouts.md 3절을 참조하십시오.
  • 결제 수금: Valve는 매월 전월 수익을 지급하며, 기본적으로 100달러가 모일 때까지 지급하지 않으며 USD로만 지급합니다. payouts.md 1절을 참조하십시오. 국내로 입금된 후의 환전 및 개인 소득세는 payouts-china.md를 참조하십시오.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬