docs: 제작·테스트를 AI가 전부 맡는 역할 분담, 빈 게임 Publish·API 키 발급 안내
- 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>
This commit is contained in:
28
DECISIONS.md
28
DECISIONS.md
@@ -5,9 +5,16 @@
|
||||
|
||||
## 0. 역할 분담
|
||||
|
||||
- 코드(Luau)는 AI가 이 리포에 작성합니다. 사용자는 Lua를 몰라도 됩니다.
|
||||
- 사용자는 계정·인증, Studio에서 플레이 테스트, 맵이나 외형 확인, 출시 버튼 누르기를 맡습니다.
|
||||
- 사용자가 직접 해야 하는 일은 그때그때 순서대로 안내합니다.
|
||||
2026-10-12 사용자 요청으로 바꿨습니다: **에셋 검색, 제작, 테스트까지 AI가 서버에서 전부 합니다.**
|
||||
|
||||
- AI가 하는 일: Luau 코드, 맵·UI 제작, Creator Store 에셋 검색과 가져오기, 자동 테스트(단위 테스트와 로블록스 서버 원격 실행), 테스트 플레이스 업로드, 게임패스·개발자 상품 등록, 썸네일 제작과 업로드.
|
||||
- 사용자가 하는 일은 본인 계정으로만 되는 것만 남깁니다.
|
||||
1. 계정 준비: 2단계 인증, 신분증 나이 확인(`SETUP.md` 1~3).
|
||||
2. 게임 자리 만들기 1회: Studio에서 빈 게임을 한 번 Publish합니다. 새 게임을 만드는 공식 API가 없어서 이 한 번은 Studio가 필요합니다(`SETUP.md` 4).
|
||||
3. Open Cloud API 키 발급 1회(`SETUP.md` 5).
|
||||
4. 돈·법적 절차: 로벅스 수수료 결제, 설문(Maturity & Compliance Questionnaire), DevEx.
|
||||
5. (권장) 출시 전 직접 플레이해 보고 느낌 말해 주기. 재미와 조작감은 자동 테스트로 판단할 수 없습니다.
|
||||
- AI가 사용자 계정 비밀번호나 로그인 쿠키(.ROBLOSECURITY)를 받아서 대신 로그인하는 방식은 쓰지 않습니다. 계정 전체 권한이 넘어가고 2단계 인증도 무의미해집니다. API 키는 게임 하나와 서버 IP로 권한을 좁힐 수 있어서 이쪽을 씁니다.
|
||||
|
||||
## 1. 개발 방식: Rojo
|
||||
|
||||
@@ -24,6 +31,15 @@
|
||||
4. Open Cloud Place Publishing API로 테스트용 플레이스에 올리고, 사용자는 로블록스에서 바로 플레이해 봅니다.
|
||||
5. 맵이나 외형을 Studio에서 손봤다면 `rojo syncback`으로 리포에 다시 넣습니다.
|
||||
|
||||
에셋 확보 방식(2026-10-12 확인):
|
||||
- 검색: Creator Store 검색 API(`apis.roblox.com/toolbox-service/v2/assets:search`). 인증 없이도 결과가 나오는 것을 서버에서 확인했습니다.
|
||||
- 가져오기: Luau Execution 작업 안에서 `AssetService:LoadAssetAsync`로 무료 공개 에셋을 불러오고(`AllowInsertFreeAssets` 필요), `.rbxm`으로 직렬화해 받아서 리포 `assets/`에 넣습니다. 리포가 계속 원본으로 남습니다.
|
||||
- 직접 만든 이미지·모델·소리: Open Cloud Assets API로 올립니다. 업로드마다 로블록스 검수가 붙습니다.
|
||||
- 주의: Place Publishing API는 Union(PartOperation)과 SurfaceAppearance를 올리지 못합니다. 그래서 Union 대신 Part 조합이나 MeshPart를 씁니다.
|
||||
- 원격 실행 한도: 작업 1회 5분, 키 주인 기준 분당 5회 생성.
|
||||
|
||||
근거: https://create.roblox.com/docs/cloud/reference/features/luau-execution , https://create.roblox.com/docs/cloud/guides/usage-place-publishing , https://create.roblox.com/docs/cloud/reference/features/assets , https://create.roblox.com/docs/reference/engine/classes/AssetService
|
||||
|
||||
리포 구조(분식집 기준, 아이돌도 같은 모양):
|
||||
```
|
||||
bunsik-tycoon/
|
||||
@@ -128,12 +144,12 @@ bunsik-tycoon/
|
||||
|
||||
## 7. 일정
|
||||
|
||||
코드는 AI가 쓰므로, 일정을 정하는 건 사용자의 준비·테스트 시간과 출시 후 60일 심사입니다.
|
||||
사용자가 하루 1~2시간 테스트할 수 있다고 보고 잡았습니다.
|
||||
제작과 테스트는 AI가 하므로, 일정을 정하는 건 사용자의 계정 준비와 출시 후 60일 심사입니다.
|
||||
사용자의 직접 플레이 확인은 마일스톤마다 10~20분이면 됩니다.
|
||||
|
||||
| 기간 | 내용 |
|
||||
|---|---|
|
||||
| 0주차 | 사용자 준비: 계정 생성, 2단계 인증, 신분증 나이 확인, Studio 설치(`SETUP.md`), Open Cloud API 키 발급 |
|
||||
| 0주차 | 사용자 준비: 계정 생성, 2단계 인증, 신분증 나이 확인, 빈 게임 Publish 1회, Open Cloud API 키 발급(`SETUP.md`) |
|
||||
| 분식집 1~3주 | MVP 제작·테스트·출시(16세 이상 공개) |
|
||||
| 분식집 출시 후 60일 | 조건 충족 유저 고유 플레이 250회(약 250명) 달성, 업데이트 1~2회 |
|
||||
| 아이돌 (분식집 출시 2~3주 뒤 착수) | 약 4주. 의상 에셋 작업이 많음 |
|
||||
|
||||
@@ -15,4 +15,10 @@
|
||||
|
||||
사용자 준비(계정·2단계 인증·나이 확인·Studio 설치): [SETUP.md](SETUP.md)
|
||||
|
||||
현재 단계: 결정 사항 확정, 사용자 계정 준비 중. 다음은 Rojo 프로젝트 골격
|
||||
현재 단계: 분식집 Rojo 골격 완료, 사용자 계정 준비와 API 키 발급 대기. 다음은 테스트 플레이스 업로드와 원격 테스트 연결
|
||||
|
||||
개발 도구 설치와 검사:
|
||||
```
|
||||
rokit install # rojo, selene, stylua, lune (버전은 rokit.toml)
|
||||
bunsik-tycoon/tools/check.sh # 스타일·린트·단위 테스트·빌드
|
||||
```
|
||||
|
||||
54
SETUP.md
54
SETUP.md
@@ -1,7 +1,7 @@
|
||||
# 0주차 준비: 계정 만들기부터 Studio 설치까지
|
||||
# 0주차 준비: 계정 만들기부터 API 키 발급까지
|
||||
|
||||
사용자(2004년생, 만 18세 이상, Windows)가 직접 하는 준비 단계입니다. 2026-10-10 기준으로 확인했습니다.
|
||||
순서대로 하면 되고, 1~4는 오늘 해 두는 게 좋습니다. 계정이 만들어진 지 2일이 지나야 게임을 공개할 수 있기 때문입니다.
|
||||
사용자(2004년생, 만 18세 이상, Windows)가 직접 하는 준비 단계입니다. 2026-10-10 기준으로 확인했고, 2026-10-12에 "제작·테스트는 AI가 전부"로 바뀐 내용을 반영했습니다.
|
||||
순서대로 하면 되고, 1~5는 오늘 해 두는 게 좋습니다. 계정이 만들어진 지 2일이 지나야 게임을 공개할 수 있기 때문입니다.
|
||||
|
||||
## 1. 계정 만들기 (PC 브라우저, 5분)
|
||||
|
||||
@@ -9,6 +9,7 @@
|
||||
2. 생년월일을 **실제 생일**로 넣습니다. 나중에 신분증으로 나이를 확인할 때 생일이 다르면 실패합니다.
|
||||
3. 사용자 이름(Username)을 정합니다.
|
||||
- 게임 페이지에 "만든 사람"으로 그대로 보입니다. 실명은 피하고, 스튜디오 이름처럼 쓸 이름으로 정합니다(예: `BunsikStudio`).
|
||||
- 정한 이름: `tkrmagid` (2026-10-12).
|
||||
- 영문·숫자·밑줄(_) 1개, 3~20자입니다. 나중에 바꾸려면 1,000 로벅스가 듭니다.
|
||||
- 표시 이름(Display Name)은 따로 있고 무료로 바꿀 수 있습니다.
|
||||
4. 비밀번호를 정하고 가입을 마칩니다. 사람 확인 퍼즐이 나오면 풉니다.
|
||||
@@ -34,24 +35,53 @@
|
||||
|
||||
신분증 확인은 로블록스가 계약한 Persona라는 회사가 처리합니다.
|
||||
|
||||
## 4. Roblox Studio 설치 (10분)
|
||||
## 4. Studio로 빈 게임 한 번 올리기 (15분, 딱 한 번)
|
||||
|
||||
게임 제작과 테스트는 AI가 서버에서 하지만, **새 게임을 만드는 공식 API가 없어서** 게임 자리 하나는 Studio에서 만들어야 합니다. 그 뒤로는 Studio를 열 일이 없습니다.
|
||||
|
||||
요구 사항: Windows 10 이상, 메모리 3GB 이상, 화면 1600×900 이상.
|
||||
|
||||
1. https://create.roblox.com 에 로그인하고 Studio 다운로드 버튼을 누릅니다.
|
||||
2. 받은 `RobloxStudio.exe`를 실행하고 설치가 끝나면 Launch Studio를 누릅니다.
|
||||
3. 방금 만든 계정으로 로그인합니다.
|
||||
4. 빈 템플릿(Baseplate)을 하나 열어서 화면이 뜨는지만 확인하고 닫습니다.
|
||||
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. 다음 단계에서 같이 할 것 (지금은 안 해도 됨)
|
||||
## 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 | 게임 파일 올리기 |
|
||||
| universe.place.luau-execution-session | read, write | 로블록스 서버에서 테스트 실행 |
|
||||
| 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가 바로 서버의 비밀 저장소로 옮깁니다. **옮겼다는 답이 오면 그 메시지는 지워 주세요.**
|
||||
|
||||
## 6. 나중에 할 것 (지금은 안 해도 됨)
|
||||
|
||||
- Open Cloud API 키 발급: 테스트용 플레이스를 만든 뒤, 권한을 그 게임 하나로 좁혀서 만듭니다. 화면을 보면서 안내합니다.
|
||||
- 로벅스 1,000개 구매: 분식집을 초중생에게 공개할 때 낼 환불형 수수료입니다. 출시 직전에 삽니다(DECISIONS.md 5절).
|
||||
- 설문(Maturity & Compliance Questionnaire): 출시 직전에 화면 순서대로 안내합니다.
|
||||
- 마일스톤마다 테스트 게임 링크를 드리면 10~20분 직접 해 보고 느낌만 알려 주세요.
|
||||
|
||||
## 다 했으면 알려 줄 것
|
||||
|
||||
- 사용자 이름(게임 페이지에 보일 이름)
|
||||
- 2단계 인증, 나이 확인, Studio 설치가 끝났는지
|
||||
- 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/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
|
||||
|
||||
@@ -56,8 +56,8 @@
|
||||
- 가챠는 2차에도 넣지 않음
|
||||
|
||||
## 8. 제작 일정 (마일스톤)
|
||||
코드는 AI가 쓰고 사용자가 매일 1~2시간 테스트한다고 보고 3주로 잡았습니다(원안 14일).
|
||||
- M0 (0주차): 사용자 계정 준비(2단계 인증, 나이 확인, Studio 설치, API 키) + Rojo 골격
|
||||
제작·테스트는 AI가 하고, 사용자는 마일스톤마다 직접 플레이해 보는 것만 한다고 보고 3주로 잡았습니다(원안 14일).
|
||||
- M0 (0주차): 사용자 계정 준비(2단계 인증, 나이 확인, 빈 게임 Publish 1회, API 키) + Rojo 골격(완료)
|
||||
- M1 (1주차 전반): 부지 배정 + 맵 블록아웃 + 조리대/요리 + 돈 수금
|
||||
- M2 (1주차 후반): 손님 AI 동선·주문·지불
|
||||
- M3 (2주차 전반): 업그레이드 10개·실내 확장 + ProfileStore 세이브
|
||||
|
||||
Reference in New Issue
Block a user