Files
roblox-project/DECISIONS.md

15 KiB

공통 결정 사항

두 프로젝트에 같이 적용되는 결정입니다. 2026-10-10 기준으로 조사해서 정했고, 근거 링크를 붙였습니다. 프로젝트별 결정은 각 SPEC.md 끝의 "결정 사항" 절에 있습니다.

0. 역할 분담

2026-10-12 사용자 요청으로 바꿨습니다: 에셋 검색, 제작, 테스트까지 AI가 서버에서 전부 합니다.

  • AI가 하는 일: Luau 코드, 맵·UI 제작, Creator Store 에셋 검색과 가져오기, 자동 테스트(단위 테스트와 로블록스 서버 원격 실행), 테스트 플레이스 업로드, 게임패스·개발자 상품 등록, 썸네일 제작과 업로드.
  • 사용자가 하는 일은 본인 계정으로만 되는 것만 남깁니다.
    1. 계정 준비: 2단계 인증, 신분증 나이 확인(SETUP.md 1~3).
    2. 게임 자리 만들기 1회: Studio에서 빈 게임을 한 번 Publish합니다. 새 게임을 만드는 공식 API가 없어서 이 한 번은 Studio가 필요합니다(SETUP.md 4).
    3. Open Cloud API 키 발급 1회(SETUP.md 5).
    4. 돈·법적 절차: 로벅스 수수료 결제, 설문(Maturity & Compliance Questionnaire), DevEx.
    5. (권장) 출시 전 직접 플레이해 보고 느낌 말해 주기. 재미와 조작감은 자동 테스트로 판단할 수 없습니다.
  • 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에서 만든 맵·모델은 리포로 다시 옮기는 단계가 있음

정한 작업 흐름:

  1. AI가 Luau 코드와 설정을 리포에 커밋합니다.
  2. 서버에서 rojo build로 .rbxl을 만들고, 코드 검사(luau-lsp, selene, StyLua)를 돌립니다.
  3. Open Cloud Luau Execution API로 로블록스 서버에서 테스트 스크립트를 실행합니다(1회 5분 제한).
  4. Open Cloud Place Publishing API로 테스트용 플레이스에 올리고, 사용자는 로블록스에서 바로 플레이해 봅니다.
  5. 맵이나 외형을 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부터), 기본 걷기·앉기 애니메이션
  • 원격 실행 한도: 작업 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 필수):
    1. 플레이어가 서버에 있고 세이브 데이터가 로드됐는지 확인합니다. 아니면 NotProcessedYet.
    2. 세이브 데이터의 "처리한 PurchaseId 목록"에 이미 있으면 지급하지 않고 PurchaseGranted.
    3. 없으면 지급과 PurchaseId 기록을 같은 저장에 넣습니다.
    4. 중간에 실패하면 NotProcessedYet을 돌려줘서 로블록스가 다시 시도하게 합니다.
    5. 결제 창이 닫힐 때 오는 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(58세), 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명으로 내려갈 가능성도 있어서 처음부터 돈을 쓰지 않습니다.
  • 규칙:
    1. 출시 후 14일은 광고 없이 쇼츠 홍보와 업데이트로 모읍니다.
    2. 14일째 Audience Reach가 기준의 50% 미만이면 Engagement 광고를 하루 10달러씩 5일(상한 50달러) 돌립니다.
    3. 3~5일 돌려도 숫자가 거의 안 오르면 광고를 끄고 첫 5분 경험(튜토리얼, 첫 구매까지 시간)부터 고칩니다. 문서가 권하는 순서도 같습니다.
    4. 기준을 채우면 광고는 자동으로 멈추지 않으니 바로 끕니다.
  • 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. 수익 구조

  • 주 수익: 게임패스(영구)와 개발자 상품(소모성).
  • 가격은 아이들이 사기 쉬운 낮은 구간부터 시작합니다(개발자 상품 25199 로벅스, 게임패스 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에 있습니다.