docs(bunsik): 개편 반영 — 직접 해 보기 안내, 에셋 가져오기 결정 갱신(남의 무료 모델은 막힘, 아바타 아이템은 됨), README 현재 단계

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-14 02:08:01 +09:00
parent d0ae06e198
commit e57e908b85
3 changed files with 37 additions and 49 deletions

View File

@@ -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

View File

@@ -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 # 실제 서버에 반영
```

View File

@@ -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층이 잘 숨겨지는지
- 손님·알바생이 걷고 앉는 모습, 동물 손님 모습이 어색하지 않은지
- 서빙 알바가 접시를 들고 손님에게 가는 모습
- 너무 빠르거나 느리다고 느낀 구간(어떤 업그레이드 근처인지). 손님이 너무 느리게 오는지
- 휴대폰에서 버튼이 가려지거나 누르기 어려운 곳, 글자가 넘치거나 그림이 빈 네모로 나오는 곳
- 오류나 멈춤이 있었다면 그때 한 행동과 화면 캡처