- 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>
96 lines
7.6 KiB
Markdown
96 lines
7.6 KiB
Markdown
# 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 | 만든 이미지·모델 올리기(게임 단위 제한 없음) |
|
||
|
||
4. Security → Accepted IP Addresses에 `211.213.11.141` 하나만 넣습니다. 키가 새어도 이 서버 밖에서는 못 씁니다. 서버 IP가 바뀌면 AI가 알려 드립니다.
|
||
5. Expiration은 비워 둡니다(60일 동안 안 쓰면 자동으로 만료됩니다).
|
||
6. **Save & Generate Key**를 누르고, 나온 키를 **Copy Key to Clipboard**로 복사합니다. 이 화면을 닫으면 다시 볼 수 없습니다.
|
||
7. 키를 디스코드 방에 붙여 넣으면 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
|