docs: 공통 결정 사항, 분식집 경제 수치표, 설계서 결정 반영

- DECISIONS.md: Rojo 개발 방식 비교, MarketplaceService 결제 규칙,
  ProfileStore, 유료 랜덤 뽑기 배제, Kids/Select 출시 연령 조건, 일정
- bunsik-tycoon/ECONOMY.md + tools/economy_sim.py: 첫 10분 수치표와 시뮬레이터
- 각 SPEC.md: 잘못된 GamePassService 표기 수정, MVP·일정 갱신, 결정 사항 절 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-10 00:05:38 +09:00
parent 6d4f9b1372
commit ae4657aac0
7 changed files with 377 additions and 30 deletions

115
DECISIONS.md Normal file
View File

@@ -0,0 +1,115 @@
# 공통 결정 사항
두 프로젝트에 같이 적용되는 결정입니다. 2026-10-10 기준으로 조사해서 정했고, 근거 링크를 붙였습니다.
프로젝트별 결정은 각 `SPEC.md` 끝의 "결정 사항" 절에 있습니다.
## 0. 역할 분담
- 코드(Luau)는 AI가 이 리포에 작성합니다. 사용자는 Lua를 몰라도 됩니다.
- 사용자는 계정·인증, Studio에서 플레이 테스트, 맵이나 외형 확인, 출시 버튼 누르기를 맡습니다.
- 사용자가 직접 해야 하는 일은 그때그때 순서대로 안내합니다.
## 1. 개발 방식: Rojo
| 방식 | 장점 | 단점 |
|---|---|---|
| Studio에서만 작업 | 설치할 게 없음. 튜토리얼 대부분이 이 방식 | 코드가 `.rbxl` 파일 안에 들어가 git으로 변경 내역을 못 봄. AI가 쓴 코드를 사람이 복사해 붙여 넣어야 함. 실수하면 되돌리기 어려움 |
| Studio Script Sync (공식, 2026-06 정식 출시) | Studio에 내장. 설치가 간단 | 스크립트·폴더만 동기화. 파일이 사용자 PC에 있어야 하고, Studio 없이 빌드할 수 없어서 AI가 서버에서 혼자 만들고 시험할 수 없음 |
| **Rojo (선택)** | 리포가 원본이 됨. AI가 리눅스 서버에서 `rojo build`로 게임 파일을 만들고, Open Cloud API로 업로드·테스트까지 할 수 있음. 업계 표준(v7.7.1, 2026-10-02 릴리스) | 처음 설정이 필요함. Studio에서 만든 맵·모델은 리포로 다시 옮기는 단계가 있음 |
정한 작업 흐름:
1. AI가 Luau 코드와 설정을 리포에 커밋합니다.
2. 서버에서 `rojo build`로 `.rbxl`을 만들고, 코드 검사(luau-lsp, selene, StyLua)를 돌립니다.
3. Open Cloud Luau Execution API로 로블록스 서버에서 테스트 스크립트를 실행합니다(1회 5분 제한).
4. Open Cloud Place Publishing API로 테스트용 플레이스에 올리고, 사용자는 로블록스에서 바로 플레이해 봅니다.
5. 맵이나 외형을 Studio에서 손봤다면 `rojo syncback`으로 리포에 다시 넣습니다.
리포 구조(분식집 기준, 아이돌도 같은 모양):
```
bunsik-tycoon/
default.project.json Rojo 설정
src/server/ 서버 코드(돈, 세이브, 결제)
src/client/ 화면 UI, 입력
src/shared/ 경제 수치표 같은 공용 데이터
assets/ 맵·모델(.rbxm)
tools/ 시뮬레이터 등 개발 도구
```
근거: https://github.com/rojo-rbx/rojo/releases , https://create.roblox.com/docs/scripting/sync , https://create.roblox.com/docs/cloud/guides/usage-place-publishing , https://create.roblox.com/docs/cloud/reference/features/luau-execution
## 2. 결제: MarketplaceService
- `GamePassService`는 지금 쓰는 서비스가 아닙니다. 남아 있는 기능은 폐기된 `PlayerHasPass` 하나뿐입니다.
- 게임패스: `MarketplaceService:UserOwnsGamePassAsync`로 보유 확인, `PromptGamePassPurchase`로 결제 창.
- 개발자 상품: `PromptProductPurchase`로 결제 창, `ProcessReceipt`에서 지급합니다.
- 결제 한 번에 정확히 한 번만 지급하는 규칙(MVP 필수):
1. 플레이어가 서버에 있고 세이브 데이터가 로드됐는지 확인합니다. 아니면 `NotProcessedYet`.
2. 세이브 데이터의 "처리한 PurchaseId 목록"에 이미 있으면 지급하지 않고 `PurchaseGranted`.
3. 없으면 지급과 PurchaseId 기록을 같은 저장에 넣습니다.
4. 중간에 실패하면 `NotProcessedYet`을 돌려줘서 로블록스가 다시 시도하게 합니다.
5. 결제 창이 닫힐 때 오는 `PromptProductPurchaseFinished`로는 절대 지급하지 않습니다.
근거: https://create.roblox.com/docs/production/monetization/developer-products
## 3. 세이브: ProfileStore
- DataStore를 직접 쓰지 않고 loleris의 ProfileStore를 씁니다. ProfileService의 공식 후속작입니다.
- 세션 잠금 기능이 있어서, 서버를 옮길 때 데이터가 덮어써지거나 아이템이 복사되는 문제를 막습니다. DataStore에는 이 기능이 기본으로 없습니다.
- 5분마다 자동 저장하고, 나갈 때도 저장합니다. 개발자 상품 처리 예제가 공식 문서에 있어서 2번 규칙과 바로 이어집니다.
- 설치는 `ProfileStore.luau` 파일 하나를 리포에 넣는 방식으로 합니다(버전 고정).
근거: https://github.com/MadStudioRoblox/ProfileStore , https://devforum.roblox.com/t/profilestore-save-your-player-data-easy-datastore-module/3190543
## 4. 가챠(랜덤 뽑기)
정한 원칙: **로벅스로 사는 랜덤 뽑기는 만들지 않습니다.** 로벅스로는 원하는 아이템을 직접 삽니다.
- 로블록스 규칙상 돈을 낸 랜덤 뽑기는 결과 전체와 확률(합 100%)을 결제 전에 보여 줘야 합니다. 로벅스로 산 게임 화폐로 뽑아도 똑같이 적용되고, 강화 실패 확률이나 행운 부스터도 여기에 포함됩니다(2026-05 공지).
- 영국, 브라질, 벨기에, 네덜란드 등은 막혀 있어서 `PolicyService`의 `ArePaidRandomItemsRestricted`로 막아야 하고, 설문(Maturity & Compliance Questionnaire)에도 신고해야 합니다.
- 한국은 2024-03부터 모든 온라인 게임에 확률 공개가 의무입니다(연 매출 1억 원 이하는 면제).
- 그래서 뽑기를 넣는다면(아이돌 2차) **게임 안에서 무료로만 모으는 뽑기권**으로 돌립니다. 로벅스와 연결된 화폐로는 뽑을 수 없게 해서 유료 랜덤 아이템 규정 밖에 둡니다. 그래도 확률표는 공개합니다.
- 매출은 "기간 한정 상점"(며칠마다 바뀌는 직접 구매 목록)으로 냅니다. 랜덤 없이도 지금 안 사면 사라진다는 이유가 생깁니다.
근거: https://create.roblox.com/docs/production/monetization/paid-random-items , https://devforum.roblox.com/t/clarifying-requirements-for-paid-random-items/4654622
## 5. 출시 대상 연령 (가장 큰 변수)
2026-06-16부터 로블록스 계정이 나이별로 나뉘었습니다.
- Roblox Kids(5~8세), Roblox Select(9~15세) 계정에는 **새 게임이 바로 보이지 않습니다.**
- 새 게임은 처음에 **나이 확인을 마친 16세 이상**에게만 공개됩니다.
- 초중생에게 보이려면 두 가지가 다 필요합니다.
- 제작자: 나이 확인(18세 이상은 신분증, 미만은 얼굴 인식), 2단계 인증, 그리고 게임당 환불형 수수료 또는 가입한 지 2개월이 넘은 Premium/Plus 구독.
- 게임: 60일 안에 "충성도 높은 나이 확인 유저"(계정 기간·플레이 시간·최근 결제 이력으로 판정)의 플레이 250회. 또는 50,000 로벅스를 내고 빠른 심사.
이에 따른 결정:
- 분식집은 처음부터 **한국어·영어 둘 다** 지원합니다. 첫 60일은 전 세계 16세 이상이 플레이하므로 "K-푸드 타이쿤"으로 해외 유저도 잡아야 합니다.
- 출시하기 전에 사용자 계정의 나이 확인과 2단계 인증을 미리 끝냅니다.
- 출시 후 60일 동안은 250회 달성이 목표입니다. 유튜브·틱톡 쇼츠 홍보, 필요하면 로블록스 광고(Ads Manager)를 씁니다.
- 광고 수익(보상형 동영상, 게임 속 광고)은 13세 미만에게 표시되지 않고 조건도 높아서 기대하지 않습니다.
근거: https://create.roblox.com/docs/production/publishing/kids-and-select , https://devforum.roblox.com/t/roblox-kids-and-select-global-launch-upcoming-updates-to-eligibility-ads-manager-and-expedited-review/4685717
## 6. 수익 구조
- 주 수익: 게임패스(영구)와 개발자 상품(소모성).
- 가격은 아이들이 사기 쉬운 낮은 구간부터 시작합니다(개발자 상품 25~199 로벅스, 게임패스 149~299 로벅스).
- 로블록스 Managed Pricing(2026-06)이 판매량이 쌓이면 지역별 가격과 가격 테스트를 자동으로 해 줍니다.
- 부가 수익: Creator Rewards. 결제 이력이 있는 유저가 우리 게임을 오래 하면 로블록스가 따로 지급합니다.
- 현금화(DevEx): 만 13세 이상, 이메일 인증, 번 로벅스 30,000 이상. 환율은 1 로벅스당 0.0038달러, 30,000 로벅스면 약 114달러입니다. 해외 거주자는 W-8BEN 세금 서류를 냅니다. 한국 세금 처리는 세무 상담을 권합니다.
근거: https://create.roblox.com/docs/production/monetization/developer-exchange , https://create.roblox.com/docs/creator-rewards
## 7. 일정
코드는 AI가 쓰므로, 일정을 정하는 건 사용자의 준비·테스트 시간과 출시 후 60일 심사입니다.
사용자가 하루 1~2시간 테스트할 수 있다고 보고 잡았습니다.
| 기간 | 내용 |
|---|---|
| 0주차 | 사용자 준비: 2단계 인증, 나이 확인, Studio 설치, Open Cloud API 키 발급(안내 제공) |
| 분식집 1~3주 | MVP 제작·테스트·출시(16세 이상 공개) |
| 분식집 출시 후 60일 | 250회 달성, 업데이트 1~2회 |
| 아이돌 (분식집 출시 2~3주 뒤 착수) | 약 4주. 의상 에셋 작업이 많음 |
마일스톤별 세부 일정은 각 `SPEC.md`에 있습니다.

View File

@@ -9,4 +9,8 @@
제작 순서: 분식집 타이쿤으로 Luau·DataStore·게임패스·출시 과정을 먼저 경험한 뒤, 비주얼 작업량이 큰 아이돌 게임에 도전합니다.
현재 단계: 설계서(계획) 다듬는 중
공통 결정 사항(개발 방식, 결제, 세이브, 가챠, 출시 연령, 일정): [DECISIONS.md](DECISIONS.md)
분식집 첫 10분 경제 수치표: [bunsik-tycoon/ECONOMY.md](bunsik-tycoon/ECONOMY.md)
현재 단계: 결정 사항 확정, 다음은 Rojo 프로젝트 골격과 사용자 계정 준비

55
bunsik-tycoon/ECONOMY.md Normal file
View File

@@ -0,0 +1,55 @@
# 분식집 타이쿤 — 첫 10분 경제 수치표 (초안)
목표: 첫 구매는 10초 안에, 그 뒤로는 40~90초마다 하나씩 사고, 10분 무렵 "실내 분식집 확장"(2단계)에 닿게 합니다.
숫자는 `tools/economy_sim.py`로 1초 단위 시뮬레이션을 돌려 맞췄습니다. 표를 고치면 시뮬레이터도 같이 고치고 다시 돌립니다.
## 기본 설정
| 항목 | 값 | 설명 |
|---|---|---|
| 처음 테이블 수 | 1 | 동시에 앉을 수 있는 손님 수 |
| 손님 간격 | 6초 | 빈자리가 없으면 그냥 지나감 |
| 조리 시간 | 2.5초 | 조리대에서 버튼을 누르고 있는 시간 |
| 왕복 시간 | 약 5초 | 조리대 → 테이블 → 조리대 |
| 식사 시간 | 6초 | 다 먹으면 자리가 빔 |
| 시작 돈 | 0 | |
## 메뉴 가격
| 메뉴 | 한 접시 | 해금 |
|---|---|---|
| 떡볶이 | 10 | 처음부터 |
| 김밥 | 20 | 구매 2번 |
| 순대 | 35 | 구매 6번 |
손님은 해금된 메뉴를 돌아가며 주문합니다.
## 구매 순서와 시점
"도달 시각"은 쉬지 않고 최적으로 플레이했을 때의 값입니다. 실제 아이들은 1.3~1.5배쯤 걸릴 것으로 보고, 출시 전 플레이 테스트로 다시 맞춥니다.
| # | 구매 | 비용 | 효과 | 도달 시각 | 2배 게임패스 |
|---|---|---|---|---|---|
| 1 | 테이블 2 | 10 | 테이블 1 → 2 | 0:08 | 0:08 |
| 2 | 김밥 해금 | 40 | 메뉴 추가(20) | 0:46 | 0:28 |
| 3 | 간판 Lv1 | 70 | 손님 간격 6 → 5초 | 1:32 | 0:46 |
| 4 | 화구 Lv1 | 90 | 조리 2.5 → 1.5초 | 2:22 | 1:12 |
| 5 | 테이블 3 | 120 | 테이블 2 → 3 | 3:23 | 1:42 |
| 6 | 순대 해금 | 160 | 메뉴 추가(35) | 4:33 | 2:25 |
| 7 | 양념 비법 Lv1 | 240 | 모든 메뉴 가격 1.5배 | 5:50 | 3:07 |
| 8 | 알바생 고용 | 360 | 조리 자동, 플레이어는 나르기만 | 7:14 | 3:49 |
| 9 | 테이블 4 | 480 | 테이블 3 → 4, 손님 간격 5 → 4초 | 8:31 | 4:26 |
| 10 | 실내 분식집 확장 | 600 | 2단계 진입(새 맵 구역, 다음 업그레이드 줄) | 10:01 | 5:11 |
구매 간격은 8초 → 38초 → 46초 → … → 90초로 조금씩 늘어납니다. 비용은 한 단계에 약 1.3배씩 오릅니다.
## 10분 이후 규칙 (2단계부터)
- 같은 종류 업그레이드의 다음 레벨 비용은 이전 비용의 1.15배로 시작하고, 매출이 느는 속도에 맞춰 시뮬레이터로 조정합니다.
- 구매 간격 목표: 2단계는 1~2분, 3단계는 2~4분.
- 오프라인 수익과 체인점(리버스, 영구 수익 배율)은 2차 업데이트에서 넣습니다.
## 게임패스·상품과의 관계
- 2배 수익 게임패스는 진행 속도를 약 2배로 만듭니다(위 표의 오른쪽 열). 무과금 유저도 10분에 확장할 수 있으니, 결제하지 않아도 답답하지 않은 선입니다.
- 돈 부스트 팩(개발자 상품)은 "현재 1분 매출 × N분" 방식으로 줍니다. 고정 금액으로 주면 후반에는 쓸모가 없어지고 초반에는 밸런스를 깨기 때문입니다.

View File

@@ -3,6 +3,7 @@
## 1. 한 줄 컨셉
떡볶이 포장마차에서 시작해 전국 체인 분식 제국까지 키우는 한국형 음식점 타이쿤.
타겟: 한국 초등학생 중심(글로벌 K-푸드 유저로 확장 가능), 1인 개발.
출시 직후 60일은 16세 이상만 볼 수 있으므로 한국어·영어를 같이 지원해 글로벌 K-푸드 유저부터 잡습니다(결정 사항 D 참고).
## 2. 왜 되는가 (근거)
- 음식점 타이쿤의 검증된 성공공식 = "점진적 성장 + 소유(꾸미기) + 소셜"을 그대로 계승.
@@ -23,12 +24,12 @@
- 5단계: 전국 체인 + 한정 메뉴 + 별 5개 평점 제국
## 5. 주요 시스템
- 요리 시스템: 재료 → 조리대에서 완성 → 접시에 담기 (초반 수동 → 후반 자동)
- 요리 시스템: 재료 → 조리대에서 완성 → 접시에 담기 (초반 수동 → 후반 자동). 조작은 결정 사항 B 참고
- 손님 AI: 입장 → 자리 착석 → 주문 → 대기 → 식사 → 돈 지불 → 퇴장
- 동선/배치가 서빙 속도에 영향(배치 잘못 = 느림 = 평점↓ = 수익↓) → 전략적 깊이
- 평점 시스템: 서빙 속도·청결·메뉴 다양성으로 별점 → 손님 유입량 결정
- 인테리어/꾸미기: 바닥·벽·테이블·간판 커스터마이징 (소유감 = 리텐션)
- 직원 고용: NPC 또는 친구를 셰프/서버로
- 직원 고용: NPC 또는 친구를 셰프/서버로 (MVP는 NPC 알바생 1명, 친구 고용은 2차)
## 6. 수익화 (Monetization)
게임패스(영구):
@@ -38,30 +39,37 @@
- 추가 가게 슬롯
개발자 상품(소모성):
- 돈 부스트 팩
- 한정 메뉴/스킨 뽑기(가챠)
- 한정 메뉴/스킨 직접 구매(기간 한정 상점). 로벅스 랜덤 뽑기는 넣지 않음(`../DECISIONS.md` 4번)
수익화 원칙: 미성년자 대상이므로 과도한 결제 유도 금지, "부모가 봐도 괜찮은" 선 유지(로블록스 정책 준수).
## 7. MVP 범위 (1~2주 목표)
포함:
- 떡볶이 포장마차 1종 + 메뉴 3개(떡볶이·김밥·순대)
- 서버당 6명, 1인 1부지
- 손님 AI 기본(주문→서빙→지불)
- 돈 수금 + 업그레이드 2~3단계
- DataStore 세이브(돈·해금 상태)
- 게임패스 1개(2배 수익)만 우선
- 돈 수금 + 업그레이드 10개(`ECONOMY.md`의 첫 10분 표) + 실내 확장 1단계
- ProfileStore 세이브(돈·해금 상태·처리한 결제 기록)
- 게임패스 1개(2배 수익) + 개발자 상품 1개(돈 부스트 팩, 결제 1회 = 지급 1회 검증용)
- 한국어·영어 UI
제외(2차 업데이트):
- 친구 고용, 멀티플로어, 가챠, 인테리어 자유도
- 친구 고용, 멀티플로어, 인테리어 자유도, 오프라인 수익, 체인점(리버스), 남의 가게 손님으로 가기
- 가챠는 2차에도 넣지 않음
## 8. 제작 일정 (마일스톤)
- M1 (3일): 맵 + 조리대/요리 기본 + 돈 수금
- M2 (3일): 손님 AI 동선·주문·지불
- M3 (3일): 업그레이드·확장 + DataStore 세이브
- M4 (2일): 게임패스 연동 + UI 다듬기
- M5 (3일): 테스트·밸런싱 + 썸네일/아이콘 + 출시
코드는 AI가 쓰고 사용자가 매일 1~2시간 테스트한다고 보고 3주로 잡았습니다(원안 14일).
- M0 (0주차): 사용자 계정 준비(2단계 인증, 나이 확인, Studio 설치, API 키) + Rojo 골격
- M1 (1주차 전반): 부지 배정 + 맵 블록아웃 + 조리대/요리 + 돈 수금
- M2 (1주차 후반): 손님 AI 동선·주문·지불
- M3 (2주차 전반): 업그레이드 10개·실내 확장 + ProfileStore 세이브
- M4 (2주차 후반): 게임패스·개발자 상품 + UI 다듬기 + 한국어·영어
- M5 (3주차): 플레이 테스트·밸런싱 + 썸네일/아이콘 + 설문 작성 + 출시(16세 이상 공개)
- 출시 후 60일: 초중생 계정 공개 조건(충성 유저 플레이 250회) 달성
## 9. 기술 스택
- 언어: Luau (Roblox Studio)
- 저장: DataStoreService (플레이어 진행도)
- 수익화: GamePassService / MarketplaceService
- 언어: Luau (Roblox Studio), 코드는 Rojo로 리포에서 관리
- 저장: ProfileStore (DataStoreService 위에서 세션 잠금 제공)
- 수익화: MarketplaceService (게임패스 보유 확인·결제 창, 개발자 상품 ProcessReceipt)
- 개발 도구: Rojo, luau-lsp, selene, StyLua, Open Cloud(업로드·원격 테스트)
- 핵심 난이도: 중하 (전투/물리 없음, 수치 성장 + AI 동선 위주)
## 10. 성장/바이럴 전략
@@ -72,4 +80,42 @@
## 11. 리스크/주의
- IP: 오리지널 테마라 안전. 실제 브랜드명(종로김밥 등) 사용 금지.
- 밸런싱: 초반 성장이 너무 느리면 이탈 → 첫 10분 보상 촘촘히.
- 세이브 데이터 손실 방지(DataStore 예외처리) 필수.
- 세이브 데이터 손실 방지(DataStore 예외처리) 필수. → ProfileStore 세션 잠금으로 해결.
- 출시 대상 연령: 첫 60일은 16세 이상만 볼 수 있음. 초등학생에게 닿으려면 충성 유저 플레이 250회가 필요(`../DECISIONS.md` 5번).
## 12. 결정 사항 (2026-10-10)
공통 결정(개발 방식, 결제, 세이브, 가챠, 출시 연령, 일정)은 `../DECISIONS.md`에 있습니다.
### A. 서버 구조: 서버당 6명, 1인 1부지
- 서버 하나에 최대 6명. 맵에 부지 6칸을 깔고, 들어오면 빈 부지를 하나 받습니다.
- 비슷한 게임들의 기준: Grow a Garden 4명, Restaurant Tycoon 2 9명. 손님 NPC가 부지마다 돌아다니므로 6명이면 서버 부하와 북적임이 적당합니다.
- 가게는 부지 기준 상대 위치로 저장합니다. 다음 접속 때 다른 칸을 받아도 그대로 다시 지어집니다.
- 소셜(MVP): 남의 가게에 걸어 들어가 구경할 수 있고, 친구와 같은 서버에서 놉니다.
- 소셜(2차): 친구 가게의 손님이 되어 주문하기, 친구를 직원으로 고용하기.
### B. 요리 조작: 누르고 있기 + 들고 가서 내려놓기
1. 조리대에 다가가면 "떡볶이 만들기" 버튼이 뜹니다(로블록스 기본 ProximityPrompt). PC는 E키, 모바일은 화면 터치.
2. 버튼을 2.5초 누르고 있으면 완성됩니다. 게이지가 차고, 지글지글 조리음이 납니다(쇼츠용 ASMR 포인트).
3. 완성된 접시를 손에 들고 주문한 손님 테이블에 가면 자동으로 놓입니다.
4. 손님이 먹고 돈을 내면 동전이 튀어나오고 "+10" 숫자가 뜹니다.
- 타이밍 맞추기는 넣지 않습니다. 어린 아이가 실패하면 바로 그만두기 때문입니다.
- 손님 머리 위 말풍선에 메뉴 그림을 띄워서 글을 못 읽어도 알 수 있게 합니다.
- 처음 접속하면 화살표가 조리대 → 손님 순서로 안내합니다. 첫 서빙까지 30초 안이 목표입니다.
- "화구" 업그레이드로 누르는 시간이 짧아지고, "알바생"을 고용하면 조리가 자동이 됩니다.
### C. 경제 수치
- 첫 10분 표: `ECONOMY.md`. 첫 구매 0:08, 10번째 구매(실내 확장) 10:01.
- 시뮬레이터: `tools/economy_sim.py`.
### D. 출시 대상과 언어
- 출시 직후 60일은 나이 확인을 마친 16세 이상만 볼 수 있습니다. 그동안 충성 유저 플레이 250회를 모아야 초중생 계정(Kids·Select)에 공개됩니다.
- 그래서 MVP부터 한국어·영어를 같이 넣고, 홍보는 "K-푸드 타이쿤"으로 해외 유저까지 노립니다.
- 콘텐츠 등급은 Minimal(가장 낮은 단계)을 목표로 합니다. Kids 계정은 Minimal·Mild만 볼 수 있습니다.
### E. 가격(초안, 출시 후 Managed Pricing으로 조정)
| 상품 | 종류 | 가격 |
|---|---|---|
| 2배 수익 | 게임패스 | 199 로벅스 |
| 돈 부스트 팩(현재 매출 10분치) | 개발자 상품 | 25 로벅스 |
| 자동 요리사, VIP 테마, 추가 가게 슬롯 | 게임패스(2차) | 149~299 로벅스 |

View File

@@ -0,0 +1,93 @@
"""분식집 타이쿤 첫 10분 경제 시뮬레이터.
ECONOMY.md 표의 숫자를 바꾸면 이 파일의 표도 같이 바꾸고 다시 돌려서
구매 시점이 목표 범위에 드는지 확인한다.
python3 bunsik-tycoon/tools/economy_sim.py # 기본
python3 bunsik-tycoon/tools/economy_sim.py --x2 # 2배 수익 게임패스
모델(1초 단위, 결정적):
- 손님은 SPAWN초마다 1명 오고, 빈자리가 없으면 돌아간다.
- 플레이어는 한 번에 한 접시: 조리(cook초) + 왕복(WALK초) 후 서빙.
- 접시가 도착하면 바로 계산되고, 손님은 EAT초 먹고 나간다. 자리는 그때 빈다.
- 알바생을 고용하면 조리는 알바생이 하고 플레이어는 나르기만 한다.
- 돈이 다음 구매 비용 이상이 되면 즉시 산다(가장 빠른 플레이어 기준).
"""
import sys
WALK = 5 # 조리대 -> 테이블 -> 조리대 왕복(초)
EAT = 6 # 먹는 시간(초)
MENUS = {"떡볶이": 10, "김밥": 20, "순대": 35} # 한 접시 기본 가격
# (이름, 비용, 효과) seats=테이블 수, spawn=손님 간격(초), cook=조리 시간(초),
# price=가격 배율, helper=알바생(조리 자동)
PURCHASES = [
("테이블 2", 10, {"seats": 2}),
("김밥 해금", 40, {"menu": "김밥"}),
("간판 Lv1", 70, {"spawn": 5}),
("화구 Lv1", 90, {"cook": 1.5}),
("테이블 3", 120, {"seats": 3}),
("순대 해금", 160, {"menu": "순대"}),
("양념 비법 Lv1", 240, {"price": 1.5}),
("알바생 고용", 360, {"helper": True}),
("테이블 4", 480, {"seats": 4, "spawn": 4}),
("실내 분식집 확장", 600, {}),
]
def simulate(mult=1.0, limit=1200):
st = {"seats": 1, "spawn": 6, "cook": 2.5, "helper": False, "price": 1.0,
"menus": ["떡볶이"]}
money = 0.0
t = 0
next_spawn = 0
waiting = [] # 주문하고 기다리는 손님 수(카운트)
eating = [] # 식사 끝나는 시각 목록
busy_until = 0 # 들고 있는 접시가 손님에게 도착하는 시각
carrying = None # 들고 있는 접시 가격
menu_i = 0
log = []
nxt = 0
while t < limit and nxt < len(PURCHASES):
# 식사 끝난 손님 퇴장(자리 반환)
eating = [e for e in eating if e > t]
# 손님 입장
if t >= next_spawn:
if len(waiting) + len(eating) + (carrying is not None) < st["seats"]:
waiting.append(t)
next_spawn = t + st["spawn"]
# 배달 완료 -> 계산
if carrying is not None and t >= busy_until:
money += carrying * st["price"] * mult
eating.append(t + EAT)
carrying = None
# 다음 접시 시작
if carrying is None and waiting:
waiting.pop(0)
cook = 0 if st["helper"] else st["cook"]
busy_until = t + cook + WALK
carrying = MENUS[st["menus"][menu_i % len(st["menus"])]]
menu_i += 1
# 구매
name, cost, eff = PURCHASES[nxt]
if money >= cost:
money -= cost
if "menu" in eff:
st["menus"].append(eff["menu"])
for k in ("seats", "spawn", "cook", "helper", "price"):
if k in eff:
st[k] = eff[k]
log.append((t, name, cost))
nxt += 1
t += 1
return log
if __name__ == "__main__":
mult = 2.0 if "--x2" in sys.argv else 1.0
prev = 0
print(f"수익 배율 x{mult:g}")
for t, name, cost in simulate(mult):
print(f"{t//60:2d}:{t%60:02d} (+{t-prev:3d}s) {name:<12} {cost:>5}원")
prev = t

View File

@@ -37,32 +37,33 @@
- 자동 연습
- 프리미엄 무대 연출 해금
개발자 상품(소모성):
- 의상/악세서리 가챠(랜덤 뽑기) — 이 장르 핵심 매출
- 의상/악세서리 직접 구매(기간 한정 상점) — 이 장르 핵심 매출. 뽑기는 무료로 모은 뽑기권으로만(결정 사항 D)
- 스탯 부스트, 팬 부스트
원칙: 미성년자 대상 과금 규정 준수, 과도 유도 금지.
## 8. MVP 범위 (1~2주 목표)
포함:
- 아이돌 캐릭터 1명 생성 + 기본 스탯 4종
- 아이돌 캐릭터 1명 생성(플레이어 본인, 게임 전용 표준 체형) + 기본 스탯 4종
- 연습 미니게임 1종(타이밍)
- 무대 1개(점수→팬·돈)
- 의상 5~10종 꾸미기 + 장착
- DataStore 세이브(스탯·의상·팬)
- 의상 5~10종 꾸미기 + 장착(2D 의상 텍스처 + 3D 헤어·악세서리)
- ProfileStore 세이브(스탯·의상·팬·처리한 결제 기록)
- 게임패스 1개(VIP)
제외(2차):
- 그룹 결성, 앨범/콘서트 시스템, 가챠, 월드투어
- 그룹 결성, 앨범/콘서트 시스템, 무료 뽑기권 가챠, 월드투어, 자작 타이틀곡
## 9. 제작 일정 (마일스톤)
- M1 (3일): 캐릭터 생성 + 스탯 UI + 연습 미니게임
- M2 (3일): 무대 시스템(점수→보상)
- M3 (3일): 꾸미기(의상 장착/구매) + DataStore
- M4 (2일): 게임패스 연동 + UI 다듬기
- M5 (3일): 테스트·밸런싱 + 썸네일/아이콘 + 출시
분식집 출시 2~3주 뒤에 착수해서 약 4주로 잡았습니다(원안 14일). 의상 에셋 작업이 가장 큰 몫입니다.
- M1 (1주차): 표준 체형 캐릭터 생성 + 스탯 UI + 연습 미니게임
- M2 (2주차 전반): 무대 시스템(리듬 노트→점수→보상)
- M3 (2주차 후반~3주차): 꾸미기(의상 장착/구매) + ProfileStore. 첫날 의상 적용 방식 검증(결정 사항 C)
- M4 (3주차 후반): 게임패스 연동 + UI 다듬기 + 한국어·영어
- M5 (4주차): 테스트·밸런싱 + 썸네일/아이콘 + 출시
## 10. 기술 스택
- 언어: Luau (Roblox Studio)
- 저장: DataStoreService
- 수익화: GamePassService / MarketplaceService
- 언어: Luau (Roblox Studio), 코드는 Rojo로 리포에서 관리
- 저장: ProfileStore
- 수익화: MarketplaceService (게임패스 보유 확인·결제 창, 개발자 상품 ProcessReceipt)
- 핵심 난이도: 중 (캐릭터/의상 비주얼 에셋 작업 비중이 큼 ← 분식집보다 품 많이 듦)
## 11. 리스크/주의
@@ -73,3 +74,36 @@
## 12. 제작 순서 추천
1차: 분식집 타이쿤으로 Luau·DataStore·게임패스·출시 전 과정 경험.
2차: 그 경험 위에 이 아이돌 게임(비주얼 품이 큰 프로젝트) 도전.
## 13. 결정 사항 (2026-10-10)
공통 결정(개발 방식, 결제, 세이브, 가챠, 출시 연령, 일정)은 `../DECISIONS.md`에 있습니다.
### A. 아이돌 = 플레이어 본인, 게임 전용 표준 체형
- 플레이어가 직접 아이돌이 됩니다. 게임에 들어오면 캐릭터가 게임 전용 표준 몸(R15 한 종류)으로 바뀌고, 피부색·얼굴·헤어는 게임 안 프리셋에서 고릅니다.
- 대표적인 꾸미기 게임 Dress to Impress가 쓰는 방식입니다. 본인 캐릭터라 애착이 생기고, 몸이 하나라 모든 의상이 똑같이 잘 맞습니다.
- 아바타와 NPC 중 고르게 하는 안은 넣지 않았습니다. 로블록스 아바타는 키·체형·겹쳐 입는 옷이 사람마다 달라서, 의상 하나를 만들 때마다 여러 체형에 맞춰 봐야 합니다. 1인 개발로는 의상 수가 절반 이하로 줄어듭니다.
- 출시 후 반응을 보고 "연습생 NPC 키우기"(그룹 멤버)를 2차 그룹 기능과 함께 검토합니다.
### B. 음악
- MVP 리듬 게임 곡: 로블록스 크리에이터 스토어의 라이선스 음원(APM, Monstercat, DistroKid, Too Lost 등 10만 곡 이상)을 씁니다. 로블록스 안에서는 무료이고 권리 처리가 끝나 있습니다.
- 곡이 내려갈 수 있으므로, 곡 ID와 노트 채보를 설정 파일 하나에 모아 두고 바로 바꿀 수 있게 합니다.
- 2차 "자작 타이틀곡": AI 음악 생성 도구의 **상업적 이용이 허락된 유료 요금제**로 만듭니다(예: Suno 무료 요금제는 상업 이용 불가). 실제 K-pop 곡과 비슷하게 들리는 프롬프트는 쓰지 않습니다. 업로드한 음원은 비공개 상태로 우리 게임에만 권한을 줍니다.
- 실제 K-pop 곡은 어떤 형태로도 쓰지 않습니다.
- 리듬 판정은 `Sound.TimePosition`(음악 재생 위치) 기준으로 하고, 판정 범위를 넓게 잡아 실패 없이 점수만 달라지게 합니다. 모바일 지연 보정 설정을 넣습니다.
### C. 의상
- 로블록스 카탈로그 아이템은 팔 수 없으니 전부 게임 전용으로 직접 만들고, 게임 안 화폐·VIP·개발자 상품으로 팝니다. 마켓플레이스에는 올리지 않습니다.
- 옷(상의·하의·원피스): 2D 의상 텍스처. AI 이미지 생성으로 디자인 초안을 만들고 템플릿에 맞춰 다듬습니다. 표준 몸이 하나라 템플릿 하나로 다 맞습니다.
- 헤어·모자·악세서리: 3D. Studio의 Mesh Generation(문장으로 3D 모델 생성)으로 만들거나, 크리에이터 스토어 무료 모델 중 출처가 확실한 것만 씁니다.
- 검증할 것: 마켓플레이스에 올리지 않은 이미지를 게임 안에서 옷 텍스처로 바로 입힐 수 있는지 공식 문서로 확인하지 못했습니다. M3 첫날 Studio에서 시험하고, 안 되면 3D 의상 파츠를 몸에 붙이는 방식으로 바꿉니다.
- AI로 만든 에셋도 로블록스 심사는 결과물만 봅니다. 실존 브랜드 로고나 실존 아이돌 의상을 그대로 따라 하지 않습니다.
### D. 가챠
- 로벅스로 사는 랜덤 뽑기는 만들지 않습니다(`../DECISIONS.md` 4번).
- 2차에서 넣는다면 연습·무대로만 모으는 무료 뽑기권으로 돌리고, 확률표는 공개합니다.
- 매출은 기간 한정 상점(며칠마다 바뀌는 의상 목록)과 VIP 게임패스로 냅니다.
### E. 출시 대상
- 분식집과 같은 조건입니다. 첫 60일은 16세 이상만 볼 수 있으니 한국어·영어를 같이 넣고, 글로벌 K-pop 팬부터 노립니다.
- 콘텐츠 등급은 Minimal 또는 Mild를 목표로 합니다. 의상 노출 수위도 여기에 맞춥니다.