Files
roblox-project/bunsik-tycoon/SPEC.md
EJClaw 802ba10e1a feat(bunsik): MVP 전체 구현 — 맵, 요리·서빙, 손님 NPC, 업그레이드 20개, 세이브, 결제, 한/영 UI
- Shop.luau: 손님·주문·조리·서빙·구매 순수 로직(lune 단위 테스트, 시뮬레이터 공용)
- 서버: World(부지 6칸), PlotBuilder(파트 모형), PlotController, Npc(트윈 이동), Data(ProfileStore), Receipts(결제 1회 = 지급 1회), Game
- 클라이언트: Hud(돈·다음 업그레이드·목록·결제·언어·튜토리얼), 내 조리대 전용 버튼, 튜토리얼 화살표, 주인 전용 테스트 버튼
- 2단계 업그레이드 10개 추가, 파이썬 시뮬레이터를 실제 로직 기반 tools/sim.luau로 교체
- tools/cloud.py: 업로드, 원격 Luau 실행, 게임패스·개발자 상품 생성, 서버 인원 설정
- tests/cloud/integration.luau: 로블록스 서버 통합 테스트 514개 통과
- check.sh에 luau-lsp 타입 검사 추가, ProfileStore 고정 버전 포함

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 01:34:06 +09:00

8.3 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가 하고, 사용자는 마일스톤마다 직접 플레이해 보는 것만 한다고 보고 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. 요리 조작: 누르고 있기 + 들고 가서 내려놓기

  1. 조리대에 다가가면 "떡볶이 만들기" 버튼이 뜹니다(로블록스 기본 ProximityPrompt). PC는 E키, 모바일은 화면 터치.
  2. 버튼을 2.5초 누르고 있으면 완성됩니다. 게이지가 차고, 지글지글 조리음이 납니다(쇼츠용 ASMR 포인트).
  3. 완성된 접시를 손에 들고 주문한 손님 테이블에 가면 자동으로 놓입니다.
  4. 손님이 먹고 돈을 내면 동전이 튀어나오고 "+10" 숫자가 뜹니다.
  • 타이밍 맞추기는 넣지 않습니다. 어린 아이가 실패하면 바로 그만두기 때문입니다.
  • 손님 머리 위 말풍선에 메뉴 그림을 띄워서 글을 못 읽어도 알 수 있게 합니다.
  • 처음 접속하면 화살표가 조리대 → 손님 순서로 안내합니다. 첫 서빙까지 30초 안이 목표입니다.
  • "화구" 업그레이드로 누르는 시간이 짧아지고, "알바생"을 고용하면 조리가 자동이 됩니다.

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만 볼 수 있습니다.

E. 가격(초안, 출시 후 Managed Pricing으로 조정)

상품 종류 가격
2배 수익 게임패스 199 로벅스
돈 부스트 팩(현재 매출 10분치) 개발자 상품 25 로벅스
자동 요리사, VIP 테마, 추가 가게 슬롯 게임패스(2차) 149~299 로벅스