Files
roblox-project/SETUP.md
EJClaw c7af87c646 feat(bunsik): 직접 만든 효과음 4개, 게임 아이콘·썸네일
- tools/sfx.py: 동전·구매·확장·조리음 합성, 오디오 에셋으로 업로드(Sounds.luau)
- 구매·확장 소리는 클라이언트에서 2D로, 동전 소리는 손님 자리에서 재생
- tools/art.py: 게임 아이콘(512)과 썸네일(1920x1080) 그림 추가
- cloud.py: 오디오 업로드·에셋 상태 조회 명령, 통합 테스트에 효과음 소유 확인(526개 통과)
- DECISIONS: 에셋은 없으면 직접 만든다는 원칙과 현황

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 01:40:00 +09:00

7.6 KiB
Raw Permalink Blame History

0주차 준비: 계정 만들기부터 API 키 발급까지

사용자(2004년생, 만 18세 이상, Windows)가 직접 하는 준비 단계입니다. 2026-10-10 기준으로 확인했고, 2026-10-12에 "제작·테스트는 AI가 전부"로 바뀐 내용을 반영했습니다. 순서대로 하면 되고, 1~5는 오늘 해 두는 게 좋습니다. 계정이 만들어진 지 2일이 지나야 게임을 공개할 수 있기 때문입니다.

1. 계정 만들기 (PC 브라우저, 5분)

  1. https://www.roblox.com 에서 가입(Sign Up)을 누릅니다.
  2. 생년월일을 실제 생일로 넣습니다. 나중에 신분증으로 나이를 확인할 때 생일이 다르면 실패합니다.
  3. 사용자 이름(Username)을 정합니다.
    • 게임 페이지에 "만든 사람"으로 그대로 보입니다. 실명은 피하고, 스튜디오 이름처럼 쓸 이름으로 정합니다(예: BunsikStudio).
    • 정한 이름: tkrmagid (2026-10-12).
    • 영문·숫자·밑줄(_) 1개, 3~20자입니다. 나중에 바꾸려면 1,000 로벅스가 듭니다.
    • 표시 이름(Display Name)은 따로 있고 무료로 바꿀 수 있습니다.
  4. 비밀번호를 정하고 가입을 마칩니다. 사람 확인 퍼즐이 나오면 풉니다.
  5. 설정(톱니바퀴) → Account Info에서 이메일을 추가하고 메일의 인증 링크를 누릅니다. 현금화(DevEx)와 계정 복구에 필요합니다.

2. 2단계 인증 켜기 (5분)

  1. 휴대폰에 Google Authenticator나 Microsoft Authenticator를 설치합니다.
  2. 설정 → Security → 2-Step Verification에서 Authenticator App을 켭니다.
  3. 화면의 QR 코드를 앱으로 찍고, 앱에 나온 6자리 숫자를 넣습니다.
  4. 백업 코드는 꼭 저장합니다. 휴대폰을 잃어버리면 이 코드로만 들어갈 수 있습니다. 종이에 적거나 비밀번호 관리 앱에 넣어 두세요.

이메일 인증 방식도 있지만, 메일 계정이 털리면 같이 뚫려서 앱 방식을 씁니다.

3. 신분증으로 나이 확인 (10분)

만 18세 이상은 초중생 공개 조건에 신분증 확인이 필요합니다. 16세 이상 공개에 필요한 나이 확인도 이걸로 같이 끝납니다.

  1. 설정 → Account Info → 생일 아래의 나이 확인 버튼(Continue with ID)을 누릅니다.
  2. PC에서는 QR 코드가 나옵니다. 휴대폰 카메라로 찍으면 휴대폰에서 이어서 진행합니다.
  3. 신분증 앞면을 찍고, 셀카를 찍습니다. 여권이나 운전면허증이 가장 무난합니다.
  4. 보통 몇 분 안에 끝납니다. 오래 걸리면 하루쯤 기다려 봅니다.

신분증 확인은 로블록스가 계약한 Persona라는 회사가 처리합니다.

4. Studio로 빈 게임 한 번 올리기 (15분, 딱 한 번)

게임 제작과 테스트는 AI가 서버에서 하지만, 새 게임을 만드는 공식 API가 없어서 게임 자리 하나는 Studio에서 만들어야 합니다. 그 뒤로는 Studio를 열 일이 없습니다.

요구 사항: Windows 10 이상, 메모리 3GB 이상, 화면 1600×900 이상.

  1. https://create.roblox.com 에 로그인하고 Studio 다운로드 버튼을 누릅니다.
  2. 받은 RobloxStudio.exe를 실행하고, 설치가 끝나면 같은 계정으로 로그인합니다.
  3. 새로 만들기에서 Baseplate를 엽니다. 아무것도 고치지 않습니다.
  4. 위 메뉴 File → Publish to Roblox를 누릅니다.
  5. 새 게임 만들기 창에서 이름은 Bunsik Tycoon, 만든 사람은 본인 계정, 기기는 컴퓨터·휴대폰·태블릿을 모두 고르고 Create를 누릅니다.
  6. 올라가면 비공개 상태로 만들어집니다. 그대로 두고 Studio를 닫습니다.
  7. https://create.roblox.com/dashboard/creations 에서 Bunsik Tycoon을 누르고, 브라우저 주소창의 주소를 복사해 둡니다(AI에게 보낼 것).

5. Open Cloud API 키 만들기 (10분, 딱 한 번)

AI가 서버에서 게임을 올리고, 로블록스 서버에서 테스트를 돌리고, 에셋·게임패스를 등록할 때 쓰는 열쇠입니다. 계정 비밀번호와 달리 이 게임 하나, 이 서버 IP 하나로 권한을 좁힐 수 있습니다.

  1. https://create.roblox.com/dashboard/credentials?activeTab=ApiKeysTab 에서 Create API Key를 누릅니다.
  2. Name: ejclaw-server
  3. Access Permissions에서 아래 API를 하나씩 추가합니다. 각 API마다 Restrict by Experience 스위치를 직접 켜고(처음엔 꺼져 있음) Bunsik Tycoon을 고른 뒤, 오른쪽 작업(Operations)을 고릅니다. 목록 이름이 표와 조금 다르면 검색칸에 앞부분만 입력해 찾습니다.
API (Select API System) 고를 작업 쓰는 곳
universe-places write 게임 파일 올리기
luau-execution-sessions 보이는 것 전부 로블록스 서버에서 테스트 실행
universe read, write 게임 설정 읽기, 출시 때 공개 전환
game-pass read, write 게임패스 등록
developer-product read, write 개발자 상품 등록
asset read, write 만든 이미지·모델 올리기(게임 단위 제한 없음)
  1. Security → Accepted IP Addresses에 211.213.11.141 하나만 넣습니다. 키가 새어도 이 서버 밖에서는 못 씁니다. 서버 IP가 바뀌면 AI가 알려 드립니다.
  2. Expiration은 비워 둡니다(60일 동안 안 쓰면 자동으로 만료됩니다).
  3. Save & Generate Key를 누르고, 나온 키를 Copy Key to Clipboard로 복사합니다. 이 화면을 닫으면 다시 볼 수 없습니다.
  4. 키를 디스코드 방에 붙여 넣으면 AI가 바로 서버의 비밀 저장소로 옮깁니다. 옮겼다는 답이 오면 그 메시지는 지워 주세요.

발급 결과 (2026-10-12)

  • 키는 서버 secrets.json의 roblox.opencloud/bunsik-tycoon에 있습니다. 리포와 채팅에는 넣지 않습니다.
  • Bunsik Tycoon: universe 10770390863, 루트 플레이스 98118751156219.
  • 서버에서 확인한 것: 게임 설정 읽기·수정, 게임패스·개발자 상품 목록, 에셋 읽기, Rojo 빌드 업로드(Saved 버전 4), 그 버전에서 Luau 원격 실행. 모두 성공했습니다.
  • 2026-10-12 API로 만든 것: 게임패스 Double Money (2배 수익) 199 로벅스(ID 2026574937), 개발자 상품 Money Boost (돈 부스트) 25 로벅스(ID 3717970589), 서버 인원 6명, 게임 설명, 효과음 오디오 4개(직접 합성).
  • 게임 아이콘(bunsik-tycoon/art/game_icon.png)과 썸네일(art/thumbnail_1.png)은 그려 두었습니다. 올리는 공식 API가 없어서 출시 직전에 Creator Hub → Bunsik Tycoon → Places → Thumbnails 화면에서 직접 올립니다(그때 화면 순서를 안내).

6. 나중에 할 것 (지금은 안 해도 됨)

  • 로벅스 1,000개 구매: 분식집을 초중생에게 공개할 때 낼 환불형 수수료입니다. 출시 직전에 삽니다(DECISIONS.md 5절).
  • 설문(Maturity & Compliance Questionnaire): 출시 직전에 화면 순서대로 안내합니다.
  • 마일스톤마다 테스트 게임 링크를 드리면 10~20분 직접 해 보고 느낌만 알려 주세요.

다 했으면 알려 줄 것

  • 2단계 인증과 신분증 나이 확인이 끝났는지
  • 4번 7단계에서 복사한 Bunsik Tycoon 주소
  • 5번에서 만든 API 키
  • 막힌 화면이 있으면 그 화면 캡처

근거: https://create.roblox.com/docs/production/publishing/kids-and-select , https://create.roblox.com/docs/production/publishing/account-verification , https://create.roblox.com/docs/studio/setup , https://create.roblox.com/docs/cloud/auth/api-keys , https://create.roblox.com/docs/cloud/guides/usage-place-publishing