9.2 KiB
공통 결정 사항
두 프로젝트에 같이 적용되는 결정입니다. 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에서 만든 맵·모델은 리포로 다시 옮기는 단계가 있음 |
정한 작업 흐름:
- AI가 Luau 코드와 설정을 리포에 커밋합니다.
- 서버에서
rojo build로.rbxl을 만들고, 코드 검사(luau-lsp, selene, StyLua)를 돌립니다. - Open Cloud Luau Execution API로 로블록스 서버에서 테스트 스크립트를 실행합니다(1회 5분 제한).
- Open Cloud Place Publishing API로 테스트용 플레이스에 올리고, 사용자는 로블록스에서 바로 플레이해 봅니다.
- 맵이나 외형을 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 필수):
- 플레이어가 서버에 있고 세이브 데이터가 로드됐는지 확인합니다. 아니면
NotProcessedYet. - 세이브 데이터의 "처리한 PurchaseId 목록"에 이미 있으면 지급하지 않고
PurchaseGranted. - 없으면 지급과 PurchaseId 기록을 같은 저장에 넣습니다.
- 중간에 실패하면
NotProcessedYet을 돌려줘서 로블록스가 다시 시도하게 합니다. - 결제 창이 닫힐 때 오는
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(915세) 계정에는 새 게임이 바로 보이지 않습니다. - 새 게임은 처음에 나이 확인을 마친 16세 이상에게만 공개됩니다.
- 초중생에게 보이려면 두 가지가 다 필요합니다.
- 제작자: 나이 확인(18세 이상은 신분증, 미만은 얼굴 인식), 2단계 인증, 그리고 게임당 환불형 수수료 또는 가입한 지 2개월이 넘은 Premium/Plus 구독.
- 게임: 60일 안에 "충성도 높은 나이 확인 유저"(계정 기간·플레이 시간·최근 결제 이력으로 판정)의 고유 플레이 250회(공식 표현 "250 unique plays". 같은 유저가 여러 번 해도 늘지 않으므로, 사실상 조건을 갖춘 서로 다른 유저 약 250명이 필요). 또는 50,000 로벅스를 내고 빠른 심사.
이에 따른 결정:
- 분식집은 처음부터 한국어·영어 둘 다 지원합니다. 첫 60일은 전 세계 16세 이상이 플레이하므로 "K-푸드 타이쿤"으로 해외 유저도 잡아야 합니다.
- 출시하기 전에 사용자 계정의 나이 확인과 2단계 인증을 미리 끝냅니다.
- 출시 후 60일 동안은 조건 충족 유저 고유 플레이 250회(약 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 로벅스, 게임패스 149299 로벅스). - 로블록스 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회(약 250명) 달성, 업데이트 1~2회 |
| 아이돌 (분식집 출시 2~3주 뒤 착수) | 약 4주. 의상 에셋 작업이 많음 |
마일스톤별 세부 일정은 각 SPEC.md에 있습니다.