Files
roblox-project/DECISIONS.md
2026-10-10 00:07:41 +09:00

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에서 만든 맵·모델은 리포로 다시 옮기는 단계가 있음

정한 작업 흐름:

  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으로 리포에 다시 넣습니다.

리포 구조(분식집 기준, 아이돌도 같은 모양):

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 필수):
    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단계 인증, 그리고 게임당 환불형 수수료 또는 가입한 지 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. 수익 구조

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