Files
roblox-project/bunsik-tycoon/SPEC.md
EJClaw ae4657aac0 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>
2026-10-10 00:05:38 +09:00

8.0 KiB

분식집 타이쿤 (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호점/멀티플로어, 인테리어 테마 해금
  • 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가 쓰고 사용자가 매일 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), 코드는 Rojo로 리포에서 관리
  • 저장: ProfileStore (DataStoreService 위에서 세션 잠금 제공)
  • 수익화: MarketplaceService (게임패스 보유 확인·결제 창, 개발자 상품 ProcessReceipt)
  • 개발 도구: Rojo, luau-lsp, selene, StyLua, Open Cloud(업로드·원격 테스트)
  • 핵심 난이도: 중하 (전투/물리 없음, 수치 성장 + AI 동선 위주)

10. 성장/바이럴 전략

  • 로블록스 알고리즘은 "플레이 유지시간"으로 노출 결정 → 첫 1분 몰입 설계 최우선.
  • 친구 초대 보상(코드/선물)으로 바이럴.
  • 틱톡/유튜브 쇼츠용 "먹방" 포인트(ASMR 조리음) 넣기.

11. 리스크/주의

  • IP: 오리지널 테마라 안전. 실제 브랜드명(종로김밥 등) 사용 금지.
  • 밸런싱: 초반 성장이 너무 느리면 이탈 → 첫 10분 보상 촘촘히.
  • 세이브 데이터 손실 방지(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 로벅스