15 KiB
공통 결정 사항
두 프로젝트에 같이 적용되는 결정입니다. 2026-10-10 기준으로 조사해서 정했고, 근거 링크를 붙였습니다.
프로젝트별 결정은 각 SPEC.md 끝의 "결정 사항" 절에 있습니다.
0. 역할 분담
2026-10-12 사용자 요청으로 바꿨습니다: 에셋 검색, 제작, 테스트까지 AI가 서버에서 전부 합니다.
- AI가 하는 일: Luau 코드, 맵·UI 제작, Creator Store 에셋 검색과 가져오기, 자동 테스트(단위 테스트와 로블록스 서버 원격 실행), 테스트 플레이스 업로드, 게임패스·개발자 상품 등록, 썸네일 제작과 업로드.
- 사용자가 하는 일은 본인 계정으로만 되는 것만 남깁니다.
- 계정 준비: 2단계 인증, 신분증 나이 확인(
SETUP.md1~3). - 게임 자리 만들기 1회: Studio에서 빈 게임을 한 번 Publish합니다. 새 게임을 만드는 공식 API가 없어서 이 한 번은 Studio가 필요합니다(
SETUP.md4). - Open Cloud API 키 발급 1회(
SETUP.md5). - 돈·법적 절차: 로벅스 수수료 결제, 설문(Maturity & Compliance Questionnaire), DevEx.
- (권장) 출시 전 직접 플레이해 보고 느낌 말해 주기. 재미와 조작감은 자동 테스트로 판단할 수 없습니다.
- 계정 준비: 2단계 인증, 신분증 나이 확인(
- AI가 사용자 계정 비밀번호나 로그인 쿠키(.ROBLOSECURITY)를 받아서 대신 로그인하는 방식은 쓰지 않습니다. 계정 전체 권한이 넘어가고 2단계 인증도 무의미해집니다. API 키는 게임 하나와 서버 IP로 권한을 좁힐 수 있어서 이쪽을 씁니다.
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으로 리포에 다시 넣습니다.
에셋 확보 방식(2026-10-12 확인):
- 검색: Creator Store 검색 API(
apis.roblox.com/toolbox-service/v2/assets:search). 인증 없이도 결과가 나오는 것을 서버에서 확인했습니다. - 가져오기: Luau Execution 작업 안에서
AssetService:LoadAssetAsync로 불러오고SerializationService:SerializeInstancesAsync로.rbxm을 받아 리포assets/에 넣습니다. 2026-10-14 확인: 로블록스가 만든 에셋만 불러와지고, 남이 만든 무료 모델은 "User is not authorized"로 막힙니다(AllowInsertFreeAssets는 스크립트에서 쓸 수 없음). 아바타 아이템(옷·머리·동물 번들)은HumanoidDescription으로 소유 없이 NPC에 입힐 수 있습니다(bunsik-tycoon/assets/npc_assets.md). - 직접 만든 이미지·모델·소리: Open Cloud Assets API로 올립니다. 업로드마다 로블록스 검수가 붙습니다.
- 주의: Place Publishing API는 Union(PartOperation)과 SurfaceAppearance를 올리지 못합니다. 그래서 Union 대신 Part 조합이나 MeshPart를 씁니다.
- 원칙(2026-10-12 사용자 요청): 마음에 드는 에셋이 없으면 직접 만듭니다. 분식집은 지금 모두 직접 만든 것입니다.
- 맵·가게·음식 모형: 코드로 Part를 조합(
src/server/PlotBuilder.luau,Food.luau) - 효과음 4개:
tools/sfx.py로 합성해 오디오 에셋으로 업로드(sfx/, ID는src/shared/Sounds.luau) - 게임패스·상품 아이콘, 게임 아이콘, 썸네일:
tools/art.py로 그림(art/) - 로블록스 기본 제공만 그대로 씀: 손님 NPC의 아바타(로블록스가 만든 옷·머리·얼굴·동물 번들, 2026-10-14부터), 기본 걷기·앉기 애니메이션
- 맵·가게·음식 모형: 코드로 Part를 조합(
- 원격 실행 한도: 작업 1회 5분, 키 주인 기준 분당 5회 생성.
근거: https://create.roblox.com/docs/cloud/reference/features/luau-execution , https://create.roblox.com/docs/cloud/guides/usage-place-publishing , https://create.roblox.com/docs/cloud/reference/features/assets , https://create.roblox.com/docs/reference/engine/classes/AssetService
리포 구조(분식집 기준, 아이돌도 같은 모양):
bunsik-tycoon/
default.project.json Rojo 설정
src/server/ 서버 코드(돈, 세이브, 결제)
src/client/ 화면 UI, 입력
src/shared/ 경제 수치표 같은 공용 데이터
art/ 직접 그린 아이콘·썸네일(PNG)
sfx/ 직접 합성한 효과음(OGG)
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단계 인증, 그리고 게임당 1,000 로벅스 환불형 수수료 또는 2개월 이상 연속 유지한 Plus/Premium 구독.
- 게임: 60일 안에 "충성도 높은 나이 확인 유저"(계정 기간·플레이 시간·최근 60일 안에 로블록스 어디서든 결제한 이력으로 판정)의 고유 플레이 250회(공식 표현 "250 unique plays". 같은 유저가 여러 번 해도 늘지 않으므로, 사실상 조건을 갖춘 서로 다른 유저 약 250명이 필요). 또는 50,000 로벅스 환불형 수수료를 내고 48시간 빠른 심사.
- 진행 상황은 Creator Hub의 Audience > Reach(Audience Reach) 화면에서 실시간으로 봅니다.
- 기준은 계속 낮아지는 중입니다: 2026-08-19에 500 → 250. RDC 2026(9월)에서 11월부터 100으로 낮춘다는 발표가 보도됐지만, 2026-10-10 공식 문서는 아직 250입니다.
이에 따른 결정:
- 분식집은 처음부터 한국어·영어 둘 다 지원합니다. 첫 60일은 전 세계 16세 이상이 플레이하므로 "K-푸드 타이쿤"으로 해외 유저도 잡아야 합니다.
- 출시하기 전에 사용자 계정의 나이 확인(신분증)과 2단계 인증을 미리 끝냅니다. 순서는
SETUP.md. - 출시 후 60일 동안은 조건 충족 유저 고유 플레이 250회(약 250명) 달성이 목표입니다.
5-1. 수수료 vs 구독: 1,000 로벅스 환불형 수수료로 정함 (2026-10-10)
| 환불형 수수료 | Plus 구독 | |
|---|---|---|
| 비용 | 게임당 1,000 로벅스. 자격을 얻고 90일 뒤 자동 환불(자격을 못 얻어도 낸 날부터 90일 뒤 환불) | 월 4.99달러. 돌려받지 못함 |
| 기다림 | 바로 낼 수 있음 | 2개월 연속 구독한 뒤부터 인정. 지금 구독해도 12월에야 됨 |
| 업데이트 | 게임당 한 번 냄(환불받은 뒤 업데이트할 때 다시 내야 하는지는 문서에 없음. 다시 내더라도 또 환불됨) | 초중생용으로 게임을 새로 올리거나 업데이트할 때마다 구독이 살아 있어야 함 |
- 수수료는 결국 돌려받는 돈이라 실제 비용이 0에 가깝고, 기다릴 필요도 없습니다.
- 돌려받은 로벅스는 광고 크레딧으로 바꿔 쓸 수 있습니다.
- 잃는 경우는 게임이 커뮤니티 규칙 위반으로 영구 삭제될 때뿐입니다.
- 내는 시점: 분식집 출시 직후 Audience > Reach에서 냅니다. 아이돌은 아이돌 출시 때 따로 냅니다.
5-2. 광고 예산: 처음엔 0, 조건부로 최대 50달러 (2026-10-10)
- Ads Manager에 초중생 공개 조건을 채우는 전용 목표(Engagement)가 생겼습니다. 조건을 갖춘 유저에게 광고를 보여 줘서 기준 숫자를 직접 올리는 용도입니다. 대신 일반 광고보다 플레이당 단가가 비쌉니다.
- 로블록스 문서도 "많은 게임이 광고 없이 기준을 채운다"고 하고, 기준이 11월에 100명으로 내려갈 가능성도 있어서 처음부터 돈을 쓰지 않습니다.
- 규칙:
- 출시 후 14일은 광고 없이 쇼츠 홍보와 업데이트로 모읍니다.
- 14일째 Audience Reach가 기준의 50% 미만이면 Engagement 광고를 하루 10달러씩 5일(상한 50달러) 돌립니다.
- 3~5일 돌려도 숫자가 거의 안 오르면 광고를 끄고 첫 5분 경험(튜토리얼, 첫 구매까지 시간)부터 고칩니다. 문서가 권하는 순서도 같습니다.
- 기준을 채우면 광고는 자동으로 멈추지 않으니 바로 끕니다.
- 50,000 로벅스 빠른 심사는 쓰지 않습니다. 환불은 되지만 90일 동안 500달러 넘는 돈이 묶이고, 정해진 날짜에 맞춰 출시해야 하는 상황이 아니기 때문입니다.
- 광고 수익(보상형 동영상, 게임 속 광고)은 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 , https://create.roblox.com/docs/production/publishing/publish-games-and-places#optional-fees , https://create.roblox.com/docs/production/promotion/ads-manager , https://devforum.roblox.com/t/highly-engaged-player-threshold-drops-to-250/4820164
6. 수익 구조
- 주 수익: 게임패스(영구)와 개발자 상품(소모성).
- 가격은 아이들이 사기 쉬운 낮은 구간부터 시작합니다(개발자 상품 25
199 로벅스, 게임패스 149299 로벅스). - 로블록스 Managed Pricing(2026-06)이 판매량이 쌓이면 지역별 가격과 가격 테스트를 자동으로 해 줍니다.
- 부가 수익: Creator Rewards. 결제 이력이 있는 유저가 우리 게임을 오래 하면 로블록스가 따로 지급합니다.
- 현금화(DevEx): 만 13세 이상(사용자는 2004년생이라 해당), 이메일 인증, 번 로벅스 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일 심사입니다. 사용자의 직접 플레이 확인은 마일스톤마다 10~20분이면 됩니다.
| 기간 | 내용 |
|---|---|
| 0주차 | 사용자 준비: 계정 생성, 2단계 인증, 신분증 나이 확인, 빈 게임 Publish 1회, Open Cloud API 키 발급(SETUP.md) |
| 분식집 1~3주 | MVP 제작·테스트·출시(16세 이상 공개) |
| 분식집 출시 후 60일 | 조건 충족 유저 고유 플레이 250회(약 250명) 달성, 업데이트 1~2회 |
| 아이돌 (분식집 출시 2~3주 뒤 착수) | 약 4주. 의상 에셋 작업이 많음 |
마일스톤별 세부 일정은 각 SPEC.md에 있습니다.