From ae4657aac0dbe3cae6fe168c0f5fd002577220c1 Mon Sep 17 00:00:00 2001 From: EJClaw Date: Sat, 10 Oct 2026 00:05:38 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EA=B3=B5=ED=86=B5=20=EA=B2=B0=EC=A0=95?= =?UTF-8?q?=20=EC=82=AC=ED=95=AD,=20=EB=B6=84=EC=8B=9D=EC=A7=91=20?= =?UTF-8?q?=EA=B2=BD=EC=A0=9C=20=EC=88=98=EC=B9=98=ED=91=9C,=20=EC=84=A4?= =?UTF-8?q?=EA=B3=84=EC=84=9C=20=EA=B2=B0=EC=A0=95=20=EB=B0=98=EC=98=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- DECISIONS.md | 115 ++++++++++++++++++ README.md | 6 +- bunsik-tycoon/ECONOMY.md | 55 +++++++++ bunsik-tycoon/SPEC.md | 78 +++++++++--- .../__pycache__/economy_sim.cpython-314.pyc | Bin 0 -> 4182 bytes bunsik-tycoon/tools/economy_sim.py | 93 ++++++++++++++ kpop-idol/SPEC.md | 60 +++++++-- 7 files changed, 377 insertions(+), 30 deletions(-) create mode 100644 DECISIONS.md create mode 100644 bunsik-tycoon/ECONOMY.md create mode 100644 bunsik-tycoon/tools/__pycache__/economy_sim.cpython-314.pyc create mode 100644 bunsik-tycoon/tools/economy_sim.py diff --git a/DECISIONS.md b/DECISIONS.md new file mode 100644 index 0000000..d476f11 --- /dev/null +++ b/DECISIONS.md @@ -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`에 있습니다. diff --git a/README.md b/README.md index 52cd491..ce6c667 100644 --- a/README.md +++ b/README.md @@ -9,4 +9,8 @@ 제작 순서: 분식집 타이쿤으로 Luau·DataStore·게임패스·출시 과정을 먼저 경험한 뒤, 비주얼 작업량이 큰 아이돌 게임에 도전합니다. -현재 단계: 설계서(계획) 다듬는 중 +공통 결정 사항(개발 방식, 결제, 세이브, 가챠, 출시 연령, 일정): [DECISIONS.md](DECISIONS.md) + +분식집 첫 10분 경제 수치표: [bunsik-tycoon/ECONOMY.md](bunsik-tycoon/ECONOMY.md) + +현재 단계: 결정 사항 확정, 다음은 Rojo 프로젝트 골격과 사용자 계정 준비 diff --git a/bunsik-tycoon/ECONOMY.md b/bunsik-tycoon/ECONOMY.md new file mode 100644 index 0000000..6a6c8af --- /dev/null +++ b/bunsik-tycoon/ECONOMY.md @@ -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분" 방식으로 줍니다. 고정 금액으로 주면 후반에는 쓸모가 없어지고 초반에는 밸런스를 깨기 때문입니다. diff --git a/bunsik-tycoon/SPEC.md b/bunsik-tycoon/SPEC.md index 39f7b55..8b8d494 100644 --- a/bunsik-tycoon/SPEC.md +++ b/bunsik-tycoon/SPEC.md @@ -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 로벅스 | diff --git a/bunsik-tycoon/tools/__pycache__/economy_sim.cpython-314.pyc b/bunsik-tycoon/tools/__pycache__/economy_sim.cpython-314.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0f091928f466162289d651d6104e23015f0c05e7 GIT binary patch literal 4182 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 테이블 -> 조리대 왕복(초) +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 diff --git a/kpop-idol/SPEC.md b/kpop-idol/SPEC.md index 7d81e6c..a32aeff 100644 --- a/kpop-idol/SPEC.md +++ b/kpop-idol/SPEC.md @@ -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를 목표로 합니다. 의상 노출 수위도 여기에 맞춥니다.