Files

139 lines
12 KiB
Markdown

# 분식집 타이쿤 (Bunsik Tycoon) — 로블록스 게임 설계서
## 1. 한 줄 컨셉
떡볶이 포장마차에서 시작해 전국 체인 분식 제국까지 키우는 한국형 음식점 타이쿤.
타겟: 한국 초등학생 중심(글로벌 K-푸드 유저로 확장 가능), 1인 개발.
출시 직후 60일은 16세 이상만 볼 수 있으므로 한국어·영어를 같이 지원해 글로벌 K-푸드 유저부터 잡습니다(결정 사항 D 참고).
## 2. 왜 되는가 (근거)
- 음식점 타이쿤의 검증된 성공공식 = "점진적 성장 + 소유(꾸미기) + 소셜"을 그대로 계승.
- 분식(떡볶이·김밥·순대·튀김)은 한국 초딩에게 극도로 친숙 → 진입 즉시 몰입.
- 먹방/ASMR 트렌드와 결합 용이, 해외엔 K-푸드로 신선.
- 핵심 루프가 단순해 1인 제작 현실적. IP 리스크 0(오리지널 테마).
## 3. 핵심 루프 (Core Loop)
요리 → 손님 서빙 → 돈 수금 → 업그레이드(메뉴·설비·인테리어·직원) → 가게 확장 → 반복
- 1분 안에 이해되는 단순함이 생명.
- "하나만 더" 심리를 만드는 보상 타이밍 설계가 핵심.
## 4. 진행 단계 (Progression) — 성장의 쾌감
- 1단계: 떡볶이 포장마차 1대, 테이블 1개 (튜토리얼)
- 2단계: 메뉴 추가(김밥·순대·튀김·어묵), 손님 증가
- 3단계: 실내 분식집으로 확장, 직원 고용
- 4단계: 2층(2026-10-14 사용자 요청으로 2호점 대신), 인테리어 테마(건물 디자인) 해금
- 5단계: 전국 체인 + 한정 메뉴 + 별 5개 평점 제국
## 5. 주요 시스템
- 요리 시스템: 재료 → 조리대에서 완성 → 접시에 담기 (초반 수동 → 후반 자동). 조작은 결정 사항 B 참고
- 손님 AI: 입장 → 자리 착석 → 주문 → 대기 → 식사 → 돈 지불 → 퇴장
- 동선/배치가 서빙 속도에 영향(배치 잘못 = 느림 = 평점↓ = 수익↓) → 전략적 깊이
- 평점 시스템: 서빙 속도·청결·메뉴 다양성으로 별점 → 손님 유입량 결정
- 인테리어/꾸미기: 바닥·벽·테이블·간판 커스터마이징 (소유감 = 리텐션)
- 직원 고용: NPC 또는 친구를 셰프/서버로 (MVP는 NPC 알바생 1명, 친구 고용은 2차)
## 6. 수익화 (Monetization)
게임패스(영구):
- 2배 수익 (Double Money)
- 자동 요리사 (Auto-Cook)
- VIP 인테리어/간판 테마
- 추가 가게 슬롯
개발자 상품(소모성):
- 돈 부스트 팩
- 한정 메뉴/스킨 직접 구매(기간 한정 상점). 로벅스 랜덤 뽑기는 넣지 않음(`../DECISIONS.md` 4번)
수익화 원칙: 미성년자 대상이므로 과도한 결제 유도 금지, "부모가 봐도 괜찮은" 선 유지(로블록스 정책 준수).
## 7. MVP 범위 (1~2주 목표)
포함:
- 떡볶이 포장마차 1종 + 메뉴 3개(떡볶이·김밥·순대)
- 서버당 6명, 1인 1부지
- 손님 AI 기본(주문→서빙→지불)
- 돈 수금 + 업그레이드 10개(`ECONOMY.md`의 첫 10분 표) + 실내 확장 1단계
- ProfileStore 세이브(돈·해금 상태·처리한 결제 기록)
- 게임패스 1개(2배 수익) + 개발자 상품 1개(돈 부스트 팩, 결제 1회 = 지급 1회 검증용)
- 한국어·영어 UI
제외(2차 업데이트):
- 친구 고용, 멀티플로어, 인테리어 자유도, 오프라인 수익, 체인점(리버스), 남의 가게 손님으로 가기
- 가챠는 2차에도 넣지 않음
## 8. 제작 일정 (마일스톤)
제작·테스트는 AI가 하고, 사용자는 마일스톤마다 직접 플레이해 보는 것만 한다고 보고 3주로 잡았습니다(원안 14일).
- M0 (0주차): 사용자 계정 준비(2단계 인증, 나이 확인, 빈 게임 Publish 1회, API 키) + Rojo 골격(완료)
- M1~M4: 맵·조리·손님·업그레이드 20개(1단계 10 + 2단계 10)·세이브·게임패스·개발자 상품·한국어/영어 UI(2026-10-12 완료, 비공개 게임 버전 6에 올림. 사용자 플레이 테스트 단계. 해 보는 법은 `PLAYTEST.md`)
- M5 (3주차): 사용자 플레이 테스트 반영·밸런싱 + 게임 아이콘/썸네일 + 설문 작성 + 출시(16세 이상 공개)
- 출시 후 60일: 초중생 계정 공개 조건(조건 충족 유저의 고유 플레이 250회, 약 250명) 달성
## 9. 기술 스택
- 언어: Luau (Roblox Studio), 코드는 Rojo로 리포에서 관리
- 저장: ProfileStore (DataStoreService 위에서 세션 잠금 제공)
- 수익화: MarketplaceService (게임패스 보유 확인·결제 창, 개발자 상품 ProcessReceipt)
- 개발 도구: Rojo, luau-lsp, selene, StyLua, Open Cloud(업로드·원격 테스트)
- 핵심 난이도: 중하 (전투/물리 없음, 수치 성장 + AI 동선 위주)
## 10. 성장/바이럴 전략
- 로블록스 알고리즘은 "플레이 유지시간"으로 노출 결정 → 첫 1분 몰입 설계 최우선.
- 친구 초대 보상(코드/선물)으로 바이럴.
- 틱톡/유튜브 쇼츠용 "먹방" 포인트(ASMR 조리음) 넣기.
## 11. 리스크/주의
- IP: 오리지널 테마라 안전. 실제 브랜드명(종로김밥 등) 사용 금지.
- 밸런싱: 초반 성장이 너무 느리면 이탈 → 첫 10분 보상 촘촘히.
- 세이브 데이터 손실 방지(DataStore 예외처리) 필수. → ProfileStore 세션 잠금으로 해결.
- 출시 대상 연령: 첫 60일은 16세 이상만 볼 수 있음. 초등학생에게 닿으려면 조건 충족 유저의 고유 플레이 250회(같은 유저 반복은 제외, 약 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. 요리 조작: 요리 창(메뉴 고르기 → 메뉴별 조리 과정 → 완성) + 들고 가서 내려놓기
2026-10-13 사용자 요청으로 "버튼 꾹 누르기"에서 바꿨습니다. 코드는 `src/shared/Recipes.luau`(과정·진행 상태), `src/client/Kitchen.luau`(화면).
1. 조리대에 다가가 버튼(PC는 E키, 휴대폰은 터치)을 누르면 요리 창이 열립니다. 창이 열린 동안은 캐릭터가 움직이지 않습니다.
2. 메뉴 고르기: 해금된 메뉴 카드에 손님 얼굴과 주문 수(x2)가 붙고 통통 튑니다. 주문이 없는 메뉴는 흐리게, 안 산 메뉴는 자물쇠입니다.
- 주문 없는 메뉴는 고를 수 없습니다. 아무도 안 시킨 접시를 들고 갇히는 일을 막기 위해서입니다(서버도 같은 규칙으로 검사).
3. 조리: 메뉴마다 2~3단계이고, 단계마다 조작이 다릅니다. 창 안 어디를 눌러도 되고 실패는 없습니다.
- 떡볶이(팬): 떡 넣기(톡톡) → 양념 붓기(꾹) → 젓기(문지르기)
- 김밥(도마): 재료 올리기(톡톡) → 말기(문지르기) → 썰기(톡톡)
- 순대(찜기): 넣기(톡톡) → 찌기(꾹) → 썰기(톡톡)
- 어묵(냄비): 꼬치에 끼우기(톡톡) → 국물에 담그기(꾹)
- 튀김(튀김기): 튀김옷(문지르기) → 튀기기(꾹) → 건지기(톡톡)
- 단계 표시는 글 대신 도구 그림 동그라미 1-2-3, 손가락 그림이 할 동작(톡톡·꾹·좌우로 문지르기)을 보여 줍니다. 누를 때마다 재료가 쌓이고 효과음이 납니다.
4. 완성: 접시가 튀어나오고 마스코트 떡이가 기뻐합니다. 주문이 남고 손에 자리가 있으면 바로 다음 메뉴 고르기, 아니면 창이 닫힙니다.
5. 완성된 접시를 손에 들고 주문한 손님 테이블에 가면 자동으로 놓입니다. 손님 머리 위 말풍선은 음식 그림이고, 받으면 하트로 바뀝니다.
- 다른 게임과 비교해 정한 것: Papa's 시리즈·Cooking Mama처럼 단계마다 다른 짧은 동작을 쓰되, 어린아이가 실패하면 그만두므로 태우기·시간 제한은 넣지 않았습니다(Restaurant Tycoon 2도 실패 없음). 한 접시 4~6초로 짧게 하고, 반복이 지루해지지 않게 "화구" 업그레이드가 누르는 양을 60%·40%로 줄이고 "알바생"이 자동으로 만들어 줍니다.
- 한 접시에 손이 더 가므로 1단계 메뉴 값을 올렸습니다(`ECONOMY.md`).
### C. 경제 수치
- 첫 10분 표: `ECONOMY.md`. 첫 구매 0:05, 10번째 구매(실내 확장) 9:39.
- 시뮬레이터: `tools/sim.luau`(실제 게임 로직 Shop.luau를 봇이 플레이). 표는 1단계 10개 + 2단계 10개.
### D. 출시 대상과 언어
- 출시 직후 60일은 나이 확인을 마친 16세 이상만 볼 수 있습니다. 그동안 조건 충족 유저의 고유 플레이 250회(서로 다른 유저 약 250명)를 모아야 초중생 계정(Kids·Select)에 공개됩니다.
- 그래서 MVP부터 한국어·영어를 같이 넣고, 홍보는 "K-푸드 타이쿤"으로 해외 유저까지 노립니다.
- 콘텐츠 등급은 Minimal(가장 낮은 단계)을 목표로 합니다. Kids 계정은 Minimal·Mild만 볼 수 있습니다.
### F. 2026-10-14 개편(사용자 요청 목록 반영)
- 업그레이드를 갈래별로 나눔: 건물(포장마차 → 실내 분식집 → 2층), 메뉴, 판매 금액, 손님 속도, 화구, 쟁반, 알바생 기능. 수치는 `ECONOMY.md`, 코드는 `src/shared/Economy.luau`.
- 손님 간격 6초 → 10초(느리게). 빨리 오게 하는 방법: 손님 속도 갈래, 홍보 알바(x0.75), 손님 러시(유료, 10분 x0.5).
- 꾸미기: 테이블·의자·소품을 사서 원하는 곳에 놓고, 조리대(수레)도 옮김. 의자는 테이블의 앞·뒤·왼쪽·오른쪽 중 한 곳에 붙음(손님이 테이블을 보고 앉고 접시가 테이블 위에 놓이게). 검사는 서버가 다시 함: 부지 안, 겹침 없음, 문 앞·계단 비움, 문에서 조리대 앞과 모든 의자까지 길이 있어야 함(`src/shared/Floor.luau`). 손님은 그 길을 따라 걷고, 2층 손님은 계단을 올라감.
- 알바생: 알바생 기능 업그레이드 뒤 역할별 고용(요리·서빙·홍보). 시급은 1분마다 나가고, 돈이 모자라면 빚 없이 쉼.
- 가게 이름: 20자, TextService 필터를 거친 글만 다른 사람에게 보임(필터 실패 시 기본 이름). 무지개 이름은 게임패스.
- 건물 디자인: 실내 분식집부터. 무료 3종(기본·민트·벽돌), 유료 게임패스 2종(사탕 궁전·한옥).
- 홍보: 보상형 광고(AdService)를 보면 옆 가게 손님이 최대 3명 옴. 광고는 13세 미만·일부 지역에는 나오지 않고, 게임이 공개되고 월 방문자 2,000명 이상 등 조건을 채워야 나옵니다. 그래서 광고를 볼 수 없으면 광고 없이 3분마다 홍보할 수 있게 했습니다(광고가 진행을 막지 않게 하라는 로블록스 규칙에도 맞음). NPC 이웃 가게 손님부터 데려옵니다.
- 손님 쫓아내기(유료): 고른 옆 가게의 음식을 아직 못 받은 손님이 모두 일어나 우리 빈자리만큼 우리 가게로 옴. 다른 플레이어 가게에도 쓸 수 있어서 "돈 내고 남 괴롭히기"로 신고될 수 있습니다. 그래서 당한 가게는 3분 보호, 먹는 손님·플레이어 손님은 건드리지 않음, 당한 사람에게 알림. 출시 전에 NPC 이웃 가게에만 쓰게 바꿀지 다시 정합니다.
- 손님 외형: 사람이 가장 많이, 가끔 동물 손님.
### E. 가격(초안, 출시 후 Managed Pricing으로 조정)
| 상품 | 종류 | 가격 |
|---|---|---|
| 2배 수익 | 게임패스 | 199 로벅스 |
| 돈 부스트 팩(현재 매출 10분치) | 개발자 상품 | 25 로벅스 |
| 무지개 가게 이름 | 게임패스 | 99 로벅스 |
| 사탕 궁전·한옥 디자인 | 게임패스 | 각 149 로벅스 |
| 손님 러시(10분), 손님 쫓아내기(1회) | 개발자 상품 | 각 15 로벅스 |