- DECISIONS.md: 0절 역할 분담 변경, 에셋 확보 방식(Creator Store 검색, LoadAssetAsync, Assets API), 일정 문구 - SETUP.md: Studio는 빈 게임 Publish 1회만, API 키 권한·IP 제한 표 - SPEC.md, README.md: M0 진행 상황과 도구 사용법 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.5 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 | 게임 파일 올리기 |
| universe.place.luau-execution-session | read, write | 로블록스 서버에서 테스트 실행 |
| 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가 바로 서버의 비밀 저장소로 옮깁니다. 옮겼다는 답이 오면 그 메시지는 지워 주세요.
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