diff --git a/DECISIONS.md b/DECISIONS.md index 75d97ac..3f5348e 100644 --- a/DECISIONS.md +++ b/DECISIONS.md @@ -33,14 +33,14 @@ 에셋 확보 방식(2026-10-12 확인): - 검색: Creator Store 검색 API(`apis.roblox.com/toolbox-service/v2/assets:search`). 인증 없이도 결과가 나오는 것을 서버에서 확인했습니다. -- 가져오기: Luau Execution 작업 안에서 `AssetService:LoadAssetAsync`로 무료 공개 에셋을 불러오고(`AllowInsertFreeAssets` 필요), `.rbxm`으로 직렬화해 받아서 리포 `assets/`에 넣습니다. 리포가 계속 원본으로 남습니다. +- 가져오기: 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의 기본 아바타 몸, 기본 걷기·앉기 애니메이션 + - 로블록스 기본 제공만 그대로 씀: 손님 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 diff --git a/README.md b/README.md index abfd983..e9628fc 100644 --- a/README.md +++ b/README.md @@ -15,13 +15,15 @@ 사용자 준비(계정·2단계 인증·나이 확인·Studio 설치): [SETUP.md](SETUP.md) -현재 단계: 분식집 MVP 완성, 비공개 게임에 올려 사용자 플레이 테스트 중([bunsik-tycoon/PLAYTEST.md](bunsik-tycoon/PLAYTEST.md)). 다음은 테스트 의견 반영, 아이콘·썸네일, 출시 준비 +현재 단계: 분식집 2026-10-14 개편(갈래 업그레이드, 꾸미기 배치, 2층, 알바생 역할·시급, 홍보·쫓아내기·손님 러시, 가게 이름·디자인, 다양한 손님)을 비공개 게임에 올려 사용자 플레이 테스트 중([bunsik-tycoon/PLAYTEST.md](bunsik-tycoon/PLAYTEST.md)). 서버↔화면 약속은 [bunsik-tycoon/NETWORK.md](bunsik-tycoon/NETWORK.md) 개발 도구 설치와 검사: ``` rokit install # rojo, selene, stylua, lune, luau-lsp (버전은 rokit.toml) bunsik-tycoon/tools/check.sh # 스타일·린트·타입 검사·단위 테스트·빌드 python3 bunsik-tycoon/tools/cloud.py publish bunsik-tycoon/build/BunsikTycoon.rbxl # 저장 버전 업로드 -python3 bunsik-tycoon/tools/cloud.py run bunsik-tycoon/tests/cloud/integration.luau --version N # 로블록스 서버 통합 테스트 +python3 bunsik-tycoon/tools/cloud.py run bunsik-tycoon/tests/cloud/server.luau --version N # 로블록스 서버 통합 테스트(서버) +python3 bunsik-tycoon/tools/cloud.py run bunsik-tycoon/tests/cloud/integration.luau --version N # 로블록스 서버 통합 테스트(화면 UI) +bunsik-tycoon/tools/preview.sh .cache/preview # 화면 UI 미리보기 그림 python3 bunsik-tycoon/tools/cloud.py publish bunsik-tycoon/build/BunsikTycoon.rbxl --published # 실제 서버에 반영 ``` diff --git a/bunsik-tycoon/PLAYTEST.md b/bunsik-tycoon/PLAYTEST.md index e41edec..ede2852 100644 --- a/bunsik-tycoon/PLAYTEST.md +++ b/bunsik-tycoon/PLAYTEST.md @@ -4,59 +4,45 @@ 1. `tkrmagid` 계정으로 로그인한 PC나 휴대폰에서 https://www.roblox.com/games/98118751156219/Bunsik-Tycoon 을 엽니다. 2. 초록색 플레이 버튼을 누릅니다. 게임은 비공개라서 주인 계정만 들어갈 수 있습니다. -3. 들어가면 바로 내 가게 자리(부지)로 옮겨집니다. +3. 들어가면 바로 내 가게 조리대 앞으로 옮겨집니다. 예전 저장(한 줄 업그레이드)은 새 구조로 자동으로 옮겨집니다(산 만큼 갈래 레벨·테이블·의자·요리 알바로). -## 해 볼 것 (15~20분) +## 해 볼 것 (20~30분) -1. 튜토리얼: 노란 줄과 화살표를 따라 조리대로 가서 [요리하기] 버튼(PC는 E 키)을 누릅니다. 요리 창이 열립니다. - - 손님이 주문한 메뉴 카드(손님 얼굴과 x1 표시, 통통 튀는 카드)를 누릅니다. - - 위쪽 글과 손가락 그림대로 합니다: 톡톡 누르기, 꾹 누르고 있기, 좌우로 문지르기. 창 안 어디를 눌러도 됩니다. PC는 마우스를 움직이기만 해도 문질러지고, E·스페이스 키로 톡톡·꾹도 됩니다. - - "완성!"이 뜨면 접시를 손님 자리로 가져갑니다. 손님 근처에 가면 접시가 자동으로 놓이고, 손님 말풍선이 하트로 바뀝니다. -2. 돈이 생기면 아래 가운데 막대의 [사기] 버튼으로 삽니다. 살 수 있을 때는 버튼이 초록색으로 바뀌어 둥실거리고, 분홍 [상점] 버튼에 빨간 `!`가 붙습니다. [상점]을 누르면 지금 단계 업그레이드 10개가 카드로 한 화면에 다 보입니다(다음 것은 노란 테두리, 그 카드에서도 바로 살 수 있음). -3. 메뉴마다 조리 과정이 다릅니다. 김밥(구매 2번)·순대(6번)를 사면 각각 해 봅니다. 화구 Lv1(4번)을 사면 누르는 횟수가 줄어듭니다. -4. 8번째 구매(알바생)부터는 알바생이 카운터(조리대 오른쪽)에 접시를 만들어 둡니다. 카운터 근처에 가면 접시를 자동으로 집습니다. 직접 요리해도 됩니다. -5. 10번째 구매(실내 분식집 확장)를 하면 건물이 생기고 2단계 업그레이드 10개가 열립니다. -6. 오른쪽 위 파란 톱니바퀴 [설정] 버튼을 눌러 봅니다. - - 언어: 자동(계정 언어)·한국어·English·日本語·中文 중에서 고릅니다. 이름판·메뉴판·버튼 글자가 모두 바뀝니다. - - 마우스로 화면 돌리기(PC, 기본 켜짐): 우클릭 없이 마우스만 움직여도 화면이 돕니다. 버튼을 누를 땐 Ctrl을 누르고 있거나, 상점·설정·요리 창을 열면 커서가 나옵니다. - - 효과음 켜기/끄기. -7. 김밥 해금을 사면: 포장마차 왼쪽에 김밥 진열대(김발·김밥 접시)가 반짝이며 생기고, 1초쯤 뒤 오는 손님이 김밥을 주문합니다. 메뉴판에도 김밥이 추가됩니다. -8. 옆 가게: 다른 부지에는 이웃 가게(NPC 사장님이 운영, 크기가 제각각)가 열려 있습니다. 다른 플레이어가 들어오면 그 자리는 그 사람 가게로 바뀝니다. - - 다른 가게 입구(이름판 아래)에서 E(휴대폰은 버튼)를 누르면 손님으로 빈자리에 앉습니다. 음식이 나오면 처음 한 번은 시식 보너스(접시 값)를 내 가게 돈으로 받습니다(1분에 한 번). 점프하면 일어납니다. - - 내 가게에 다른 플레이어가 손님으로 오면 알림이 뜨고, 그 손님 접시는 2배 값을 받습니다. -9. 나갔다가 다시 들어와서 돈·업그레이드·설정이 그대로인지 봅니다. - -## 휴대폰에서 해 볼 것 - -휴대폰·태블릿은 화면을 가로로 두고 합니다. 화면을 터치하면 휴대폰 배치로 바뀝니다. -- 왼쪽 위: 분홍 [상점], 보라 [2배 돈], 주황 [부스트]가 한 줄로. 왼쪽 아래 조이스틱 자리와 겹치지 않게 위로 올렸습니다. -- 가운데 위: 돈. 오른쪽 위: 파랑 톱니바퀴(설정). 오른쪽 아래 점프 버튼 자리는 비워 두었습니다. -- 아래: 다음 업그레이드 막대. [사기] 버튼은 조이스틱과 점프 버튼 사이에 옵니다. 막대 바로 위에 손에 든 음식 그림이 보입니다. -- 요리 창은 화면을 거의 다 채웁니다. 문지르기를 할 때 캐릭터가 움직이지 않는지 봐 주세요. -- 설정 창에는 마우스 회전 줄이 없습니다(휴대폰에는 필요 없음). -- 조이스틱으로 걸을 때 버튼이 눌리지 않는지, 글자가 너무 작지 않은지 봐 주세요. - -## 새 화면 UI에서 봐 줄 것(2026-10-13 처음부터 다시 디자인) - -- 늘 보이는 것은 돈, 버튼 묶음(상점·2배 돈·부스트), 설정, 다음 업그레이드 막대, 손에 든 음식뿐입니다. 덜 어지러운지 -- 색(분홍·노랑·민트·하늘·보라 사탕색)과 둥근 모양이 아이들 취향에 맞는지 -- 요리 창 그림(팬·도마·찜기·냄비·튀김기, 마스코트 떡이)과 재료가 쌓이는 모습이 자연스러운지 -- 아이콘·그림이 깨지거나 빈 네모로 나오지 않는지 -- 글자가 버튼 밖으로 넘치거나 너무 작은 곳이 없는지(영어·일본어·중국어도) +1. 튜토리얼: 노란 줄과 화살표를 따라 조리대로 가서 [요리하기](PC는 E)를 누르고, 손님이 주문한 메뉴를 만들어 손님 자리로 가져갑니다. 접시가 손에서도 테이블 위에서도 **눕혀서** 보이는지 봐 주세요(예전에 세로로 서던 문제). +2. 돈이 생기면 아래 막대의 [사기]로 의자를 삽니다. 막대에는 지금 살 수 있는 것 중 가장 싼 것이 나옵니다. +3. 분홍 [상점] 버튼: 탭 4개 + - 업그레이드: 건물(포장마차 → 실내 분식집 → 2층), 새 메뉴, 판매 금액, 손님 속도, 화구, 쟁반, 알바생 기능을 따로따로 삽니다. 실내 분식집이 필요한 것은 자물쇠와 "실내 분식집부터"가 붙습니다. + - 꾸미기: 테이블(의자 1개 포함), 의자, 소품 6가지(화분·카펫·풍선·전등·곰인형·냉장고). [배치하기]를 누르면 꾸미기 화면이 열립니다. + - 알바생: 알바생 기능을 사면 열립니다. 요리·서빙·홍보 알바를 고용하고 뺄 수 있고, 시급은 1분마다 나갑니다. 돈이 모자라면 알바생 머리 위에 💤가 뜨고 쉽니다. + - 내 가게: 가게 이름 쓰고 [저장], 무지개 이름(💎 게임패스), 건물 디자인 5개(실내 분식집부터, 사탕 궁전·한옥은 💎 게임패스). +4. 꾸미기 화면(위에서 내려다보는 화면, 캐릭터는 멈춤) + - 테이블·의자·조리대·소품을 눌러 고르고, 바닥을 누르거나 끌어서 옮긴 뒤 [놓기]. 놓을 수 있으면 초록, 안 되면 빨강과 이유(문 앞, 겹침, 길이 막힘 등)가 나옵니다. + - 의자는 앞·오른쪽·뒤·왼쪽 버튼으로 붙는 쪽을 바꾸고, 다른 테이블을 누르면 그 테이블로 옮겨 갑니다. + - 조리대와 소품은 [돌리기]로 돌립니다. 2층 건물이면 1층·2층 버튼이 나옵니다. [나가기]로 끝냅니다. +5. 실내 분식집을 사면 천장·지붕이 있는 건물이 생기고, 2층을 사면 계단과 2층이 생깁니다. 2층에 놓은 자리에도 손님이 계단을 올라가 앉는지 봐 주세요. +6. 오른쪽 위(휴대폰)·오른쪽(PC) 손님 버튼 + - 📣 홍보: 옆 가게에서 기다리던 손님이 최대 3명(빈자리만큼) 걸어서 우리 가게로 옵니다. 광고를 볼 수 있는 계정이면 [광고 보기]가 나오고, 아니면 바로 홍보됩니다(3분마다). 비공개 게임이라 지금은 광고가 나오지 않는 것이 정상입니다. + - 손님 러시(💎 15로벅스): 10분 동안 손님이 2배 빨리 옵니다. 진짜 결제 창이 뜹니다. +7. 옆 가게 입구에 가면 버튼이 두 개 있습니다: [손님으로 들어가기](E), [손님 쫓아내기](F, 💎 15로벅스). 쫓아내기를 사면 그 가게에서 기다리던 손님이 일어나 우리 가게로 옵니다. 당한 가게는 3분 동안 보호됩니다. 진짜 결제 창이 뜹니다. +8. 손님 모습: 머리·모자·옷이 다른 사람 손님이 대부분이고, 가끔 펭귄·곰·북극곰·고양이·강아지·판다·여우·쥐 같은 동물 손님이 옵니다. 서버가 켜지고 10초쯤은 기본 모습 손님이 올 수 있습니다. +9. 손님은 예전보다 느리게 옵니다(처음 10초에 한 명). 업그레이드의 손님 속도, 홍보 알바, 손님 러시로 빨라집니다. +10. 다른 플레이어가 같은 서버에 있으면, 가게 이름·무지개 이름·건물 디자인이 그 사람 화면에도 보이는지 봐 주세요. +11. 나갔다가 다시 들어와서 돈·업그레이드·배치·알바생·이름·디자인이 그대로인지 봅니다. ## 개발자 테스트 버튼(주인 계정에만 보임) -[설정] 창 맨 아래의 렌치 아이콘 `개발자 테스트` 줄: -- `+1,000원`: 돈을 바로 넣습니다. 뒤쪽 업그레이드를 빨리 확인할 때 씁니다. +[설정] 창 맨 아래 `개발자 테스트` 줄: +- `+1,000원`: 돈을 바로 넣습니다. 뒤쪽 업그레이드를 빨리 확인할 때 씁니다(여러 번 누르면 2층까지 빨리 갈 수 있음). - `2배 켜기/끄기`: 2배 수익 게임패스를 산 것처럼 켭니다(이번 접속에만 적용). -- `처음부터`: 돈·업그레이드·튜토리얼을 처음으로 되돌립니다. +- `처음부터`: 돈·업그레이드·배치·알바생·튜토리얼을 처음으로 되돌립니다. 이름과 산 게임패스는 남습니다. -[2배 수익], [돈 부스트] 버튼은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요. +[2배 돈], [부스트], 손님 러시, 쫓아내기, 무지개 이름, 유료 디자인은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요. ## 알려 주시면 좋은 것 -- 처음 1분 안에 무엇을 해야 하는지 바로 알 수 있었는지 -- 손님 걷기·앉기 모습, 접시가 손에 들리는 모습이 어색하지 않은지(서버에서는 화면을 볼 수 없어서 이 부분은 직접 봐 주셔야 합니다) -- 너무 빠르거나 느리다고 느낀 구간(몇 번째 업그레이드 근처인지) -- 휴대폰에서 버튼이 가려지거나 누르기 어려운 곳 +- 꾸미기 화면: 위에서 보는 화면이 잘 보이는지, 고르고 옮기기가 손가락·마우스로 쉬운지, 지붕·2층이 잘 숨겨지는지 +- 손님·알바생이 걷고 앉는 모습, 동물 손님 모습이 어색하지 않은지 +- 서빙 알바가 접시를 들고 손님에게 가는 모습 +- 너무 빠르거나 느리다고 느낀 구간(어떤 업그레이드 근처인지). 손님이 너무 느리게 오는지 +- 휴대폰에서 버튼이 가려지거나 누르기 어려운 곳, 글자가 넘치거나 그림이 빈 네모로 나오는 곳 - 오류나 멈춤이 있었다면 그때 한 행동과 화면 캡처