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:
115
DECISIONS.md
Normal file
115
DECISIONS.md
Normal 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`에 있습니다.
|
||||
@@ -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
55
bunsik-tycoon/ECONOMY.md
Normal 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분" 방식으로 줍니다. 고정 금액으로 주면 후반에는 쓸모가 없어지고 초반에는 밸런스를 깨기 때문입니다.
|
||||
@@ -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 로벅스 |
|
||||
|
||||
BIN
bunsik-tycoon/tools/__pycache__/economy_sim.cpython-314.pyc
Normal file
BIN
bunsik-tycoon/tools/__pycache__/economy_sim.cpython-314.pyc
Normal file
Binary file not shown.
93
bunsik-tycoon/tools/economy_sim.py
Normal file
93
bunsik-tycoon/tools/economy_sim.py
Normal 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
|
||||
@@ -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를 목표로 합니다. 의상 노출 수위도 여기에 맞춥니다.
|
||||
|
||||
Reference in New Issue
Block a user