- 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>
7.6 KiB
0주차 준비: 계정 만들기부터 API 키 발급까지
사용자(2004년생, 만 18세 이상, Windows)가 직접 하는 준비 단계입니다. 2026-10-10 기준으로 확인했고, 2026-10-12에 "제작·테스트는 AI가 전부"로 바뀐 내용을 반영했습니다. 순서대로 하면 되고, 1~5는 오늘 해 두는 게 좋습니다. 계정이 만들어진 지 2일이 지나야 게임을 공개할 수 있기 때문입니다.
1. 계정 만들기 (PC 브라우저, 5분)
- https://www.roblox.com 에서 가입(Sign Up)을 누릅니다.
- 생년월일을 실제 생일로 넣습니다. 나중에 신분증으로 나이를 확인할 때 생일이 다르면 실패합니다.
- 사용자 이름(Username)을 정합니다.
- 게임 페이지에 "만든 사람"으로 그대로 보입니다. 실명은 피하고, 스튜디오 이름처럼 쓸 이름으로 정합니다(예:
BunsikStudio). - 정한 이름:
tkrmagid(2026-10-12). - 영문·숫자·밑줄(_) 1개, 3~20자입니다. 나중에 바꾸려면 1,000 로벅스가 듭니다.
- 표시 이름(Display Name)은 따로 있고 무료로 바꿀 수 있습니다.
- 게임 페이지에 "만든 사람"으로 그대로 보입니다. 실명은 피하고, 스튜디오 이름처럼 쓸 이름으로 정합니다(예:
- 비밀번호를 정하고 가입을 마칩니다. 사람 확인 퍼즐이 나오면 풉니다.
- 설정(톱니바퀴) → Account Info에서 이메일을 추가하고 메일의 인증 링크를 누릅니다. 현금화(DevEx)와 계정 복구에 필요합니다.
2. 2단계 인증 켜기 (5분)
- 휴대폰에 Google Authenticator나 Microsoft Authenticator를 설치합니다.
- 설정 → Security → 2-Step Verification에서 Authenticator App을 켭니다.
- 화면의 QR 코드를 앱으로 찍고, 앱에 나온 6자리 숫자를 넣습니다.
- 백업 코드는 꼭 저장합니다. 휴대폰을 잃어버리면 이 코드로만 들어갈 수 있습니다. 종이에 적거나 비밀번호 관리 앱에 넣어 두세요.
이메일 인증 방식도 있지만, 메일 계정이 털리면 같이 뚫려서 앱 방식을 씁니다.
3. 신분증으로 나이 확인 (10분)
만 18세 이상은 초중생 공개 조건에 신분증 확인이 필요합니다. 16세 이상 공개에 필요한 나이 확인도 이걸로 같이 끝납니다.
- 설정 → Account Info → 생일 아래의 나이 확인 버튼(Continue with ID)을 누릅니다.
- PC에서는 QR 코드가 나옵니다. 휴대폰 카메라로 찍으면 휴대폰에서 이어서 진행합니다.
- 신분증 앞면을 찍고, 셀카를 찍습니다. 여권이나 운전면허증이 가장 무난합니다.
- 보통 몇 분 안에 끝납니다. 오래 걸리면 하루쯤 기다려 봅니다.
신분증 확인은 로블록스가 계약한 Persona라는 회사가 처리합니다.
4. Studio로 빈 게임 한 번 올리기 (15분, 딱 한 번)
게임 제작과 테스트는 AI가 서버에서 하지만, 새 게임을 만드는 공식 API가 없어서 게임 자리 하나는 Studio에서 만들어야 합니다. 그 뒤로는 Studio를 열 일이 없습니다.
요구 사항: Windows 10 이상, 메모리 3GB 이상, 화면 1600×900 이상.
- https://create.roblox.com 에 로그인하고 Studio 다운로드 버튼을 누릅니다.
- 받은
RobloxStudio.exe를 실행하고, 설치가 끝나면 같은 계정으로 로그인합니다. - 새로 만들기에서 Baseplate를 엽니다. 아무것도 고치지 않습니다.
- 위 메뉴 File → Publish to Roblox를 누릅니다.
- 새 게임 만들기 창에서 이름은
Bunsik Tycoon, 만든 사람은 본인 계정, 기기는 컴퓨터·휴대폰·태블릿을 모두 고르고 Create를 누릅니다. - 올라가면 비공개 상태로 만들어집니다. 그대로 두고 Studio를 닫습니다.
- https://create.roblox.com/dashboard/creations 에서
Bunsik Tycoon을 누르고, 브라우저 주소창의 주소를 복사해 둡니다(AI에게 보낼 것).
5. Open Cloud API 키 만들기 (10분, 딱 한 번)
AI가 서버에서 게임을 올리고, 로블록스 서버에서 테스트를 돌리고, 에셋·게임패스를 등록할 때 쓰는 열쇠입니다. 계정 비밀번호와 달리 이 게임 하나, 이 서버 IP 하나로 권한을 좁힐 수 있습니다.
- https://create.roblox.com/dashboard/credentials?activeTab=ApiKeysTab 에서 Create API Key를 누릅니다.
- Name:
ejclaw-server - 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 | 만든 이미지·모델 올리기(게임 단위 제한 없음) |
- Security → Accepted IP Addresses에
211.213.11.141하나만 넣습니다. 키가 새어도 이 서버 밖에서는 못 씁니다. 서버 IP가 바뀌면 AI가 알려 드립니다. - Expiration은 비워 둡니다(60일 동안 안 쓰면 자동으로 만료됩니다).
- Save & Generate Key를 누르고, 나온 키를 Copy Key to Clipboard로 복사합니다. 이 화면을 닫으면 다시 볼 수 없습니다.
- 키를 디스코드 방에 붙여 넣으면 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