- 아래 추천 [사기] 막대를 없애고 튜토리얼 말풍선을 아래 가운데로. 튜토리얼 3단계는 [가게 꾸미기]에서 의자 놓기
- 상점에서 꾸미기 탭을 빼고 따로 [가게 꾸미기] 버튼·창. 카드를 고르면 캐릭터 앞에 투명 미리보기가 붙어 다니고
[돌리기](R)·[놓기](F)로 그 자리에 놓음(놓을 때 돈). [옮기기]로 놓은 물건·조리대를 들어서 옮김
- 의자를 테이블에서 떼어 {x,z,f,r}로 저장(등받이로 방향 보임). 의자는 보는 쪽 앞에 테이블이 있어야 하고,
테이블을 옮기거나 돌리면 그 테이블을 보는 의자도 같이. 예전 {t,s} 저장은 자동 변환. 새 요청 buyAt
- 테이블은 의자 없이 따로 판매(20 + 15×테이블 수²)
- 손님 간격 10초 → 20초(손님 속도 갈래도 2배), 대신 음식값 2배로 1분 매출 유지. 실내 11분·2층 50분(봇)
- 2배 돈: 게임 주인은 게임패스를 자동 보유하는데 [처음부터]·2배 끄기 뒤 버튼이 결제 창을 띄워 "이미 보유"가 나옴.
누르면 먼저 보유를 확인해 바로 켜고, [처음부터]도 2배를 유지
- 검사 위치 0.5칸 자리 길 검사 오류 수정(touches가 막힌 칸 안쪽을 보던 문제)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
93 lines
6.8 KiB
Markdown
93 lines
6.8 KiB
Markdown
# 서버 ↔ 클라이언트 약속 (2026-10-14 개편)
|
|
|
|
서버는 상태를 **속성(Attribute)** 으로 내보내고, 클라이언트는 `Remotes.Action:FireServer(kind, arg)` 로 요청합니다.
|
|
알림은 `Remotes.Notify:FireClient(player, key, args)` 이고, 글자는 클라이언트가 `Locale.t(lang, key, args)` 로 씁니다.
|
|
경제·배치 규칙은 공용 모듈(`src/shared/Economy.luau`, `Shop.luau`, `Floor.luau`)이 원본입니다. 클라이언트는 같은 모듈로 값·미리보기를 계산하고, 서버가 다시 검사합니다.
|
|
|
|
## 플레이어 속성 (Player)
|
|
|
|
| 속성 | 형 | 뜻 |
|
|
|---|---|---|
|
|
| Ready | bool | 세이브 로드 끝 |
|
|
| Plot | number | 내 부지 번호 |
|
|
| Money, Earned | number | 돈, 지금까지 번 돈 |
|
|
| Levels | string | 갈래 레벨 `"Stage=1,Menu=2,Price=0,Speed=1,Stove=0,Tray=0,Staff=1"` (Economy.TRACK_ORDER 순서). `Shared.Codec.decodeMap` 로 읽음 |
|
|
| Stage | number | 건물 단계 1 포장마차, 2 실내, 3 2층 |
|
|
| Seats, Tables | number | 놓은 의자 수(= 손님 자리 수), 테이블 수 |
|
|
| Layout | string | 배치 JSON(`Floor.Layout` 모양). `HttpService:JSONDecode` 후 `Floor.clean`. 의자는 `{x, z, f, r}`(r = 보는 쪽 0 +Z, 1 +X, 2 -Z, 3 -X)이고, 보는 쪽 바로 앞에 테이블이 있어야 함. 예전 `{t, s}` 모양은 `Floor.clean`이 바꿈 |
|
|
| Staff | string | 고용한 알바 수 `"Cook=1,Server=0,Promoter=0"` |
|
|
| Strike | bool | 시급이 모자라 알바생이 쉬는 중 |
|
|
| Wage | number | 1분마다 주는 시급 합계 |
|
|
| RushUntil | number | 손님 러시가 끝나는 서버 시각(`workspace:GetServerTimeNow()` 기준, 0이면 없음) |
|
|
| PromoteAt | number | 다음 홍보를 할 수 있는 서버 시각(광고 없이) |
|
|
| PromoteAdAt | number | 광고를 보고 홍보할 수 있는 서버 시각 |
|
|
| KickCredits | number | 남은 "손님 쫓아내기" 횟수(유료로 산 것) |
|
|
| ShopName | string | 내가 정한 가게 이름 원문("" = 기본 이름). 다른 사람에게 보이는 이름은 부지 속성 ShopName(필터 거친 글) |
|
|
| Rainbow | bool | 무지개 이름 켜기 설정 |
|
|
| RainbowOwned | bool | 무지개 이름 게임패스 보유 |
|
|
| Design | string | 건물 디자인 id(Economy.DESIGNS) |
|
|
| DesignsOwned | string | 유료 디자인 보유 목록 `"Candy,Hanok"` |
|
|
| Double | bool | 2배 수익 |
|
|
| Boost | number | 돈 부스트 팩 지급액 |
|
|
| Tut | number | 튜토리얼 단계(0 끝, 1 조리대로, 2 서빙, 3 가게 꾸미기에서 의자 놓기) |
|
|
| Carry, Hand | number, string | 든 접시 수, 든 메뉴 `"Gimbap,Sundae"` |
|
|
| Orders | string | 메뉴별 열린 주문 `"Tteokbokki=2,Gimbap=1"` |
|
|
| Lang, LangSetting, MouseLook, Sfx, Dev | | 설정(예전과 같음) |
|
|
|
|
## 부지 모델 속성 (workspace.BunsikWorld.Plots.PlotN, 모두에게 보임)
|
|
|
|
| 속성 | 뜻 |
|
|
|---|---|
|
|
| OwnerId, OwnerName | 플레이어 가게 주인 |
|
|
| Npc | 이웃 가게(NPC) 번호 |
|
|
| Level | 가게 레벨(Economy.shopLevel) |
|
|
| Stage | 건물 단계 |
|
|
| Menus | 파는 메뉴 `"Tteokbokki,Gimbap"` (메뉴판) |
|
|
| PriceMult | 판매 금액 배율(메뉴판 값) |
|
|
| ShopName | 필터를 거친 가게 이름("" = 기본 이름 "{name}의 분식집") |
|
|
| Rainbow | 무지개 이름(게임패스 + 켜짐) |
|
|
| Design | 건물 디자인 |
|
|
| ShieldUntil | 손님 쫓아내기 보호가 끝나는 서버 시각 |
|
|
| Origin | 부지 기준 CFrame. 배치 좌표 (x, z, 층 f) → 월드: `Origin * CFrame.new(x, Floor.BASE_Y + (f == 2 and Floor.FLOOR2_Y or 0), z)` |
|
|
|
|
## 배치 물건 모델
|
|
|
|
부지 안 `Upgrades/Furniture` 폴더에 서버가 짓습니다. 꾸미기 화면이 눌러서 고를 수 있게 모델마다 속성을 붙입니다.
|
|
- `ItemKind` = "table" | "chair" | "decor" | "stove", `ItemIndex` = Layout 목록 번호(조리대는 1)
|
|
- 모델 기준점(WorldPivot) = 놓는 자리 `Origin * CFrame.new(x, 바닥 높이, z) * CFrame.Angles(0, r·90°, 0)`
|
|
- 조리대(포장마차 수레)는 `Plot.Base.Stall` 모델 그대로 옮깁니다(인스턴스가 바뀌지 않아서 조리대 버튼이 계속 붙어 있음).
|
|
- 새 물건 미리보기 모형: `ReplicatedStorage.BunsikTemplates`의 `Table`, `Chair`, `Decor_<소품>`(기준점 = 원점). 서버 시작 때 만듭니다.
|
|
|
|
## 요청 (Action kind, arg)
|
|
|
|
| kind | arg | 서버가 하는 일 |
|
|
|---|---|---|
|
|
| `cookStart`, `cook` | 메뉴 | 요리 창(예전과 같음) |
|
|
| `upgrade` | 갈래 id | 다음 단계 구매 |
|
|
| `buyAt` | `{kind="table"/"chair"/"decor", k=소품 id, x, z, f, r}` | 꾸미기 화면 [놓기]: 그 자리에 새 물건을 사서 놓기(Floor.add로 검사, 실패면 `placeFail`, 돈은 성공할 때만) |
|
|
| `buySeat` | 테이블 번호 또는 nil | 의자 1개(테이블 빈 쪽에 자동 배치, 테스트·예전 경로) |
|
|
| `buyTable` | nil | 테이블만(빈 곳 자동 배치, 의자는 따로) |
|
|
| `buyDecor` | 소품 id | 소품 1개(빈 곳 자동 배치) |
|
|
| `buyOffer` | `"Seat"`/`"Table"`/갈래 id | 추천 구매(화면 막대는 없어졌고 테스트용으로 남김) |
|
|
| `move` | `{kind="stove"/"table"/"chair"/"decor", i, x, z, f, r}` | 옮기기(Floor.move로 검사). 테이블의 r은 그 테이블을 보는 의자들을 테이블 둘레로 돌리는 횟수(의자도 같이 옮겨짐) |
|
|
| `hire`, `fire` | 역할 id | 알바 고용·해고 |
|
|
| `rename` | 문자열(최대 20자) | 이름 바꾸기(TextService 필터) |
|
|
| `rainbow` | bool | 무지개 이름 켜기/끄기. 없으면 게임패스 결제 창 |
|
|
| `design` | 디자인 id | 디자인 바꾸기(실내 분식집부터). 유료인데 없으면 결제 창 |
|
|
| `promote` | `{ad=bool}` | 홍보. ad=true면 보상형 광고(서버가 AdService로 띄움), 아니면 대기 시간 확인 후 바로 |
|
|
| `kick` | 부지 번호 | 손님 쫓아내기. 횟수가 있으면 바로 쓰고, 없으면 결제 창(결제되면 그 부지에 씀) |
|
|
| `rush` | nil | 손님 러시 결제 창 |
|
|
| `visit`, `lang`, `mouseLook`, `sfx`, `pass`, `boost`, `dev_*` | | 예전과 같음 |
|
|
|
|
## 알림 키 (Notify)
|
|
|
|
예전 키(`purchased` 등)에 더해:
|
|
- `upgraded {track, level}` 갈래 업그레이드, `newMenu {menu}`, `expanded`(실내), `floor2`(2층)
|
|
- `seatAdded`, `tableAdded`, `decorAdded {kind}`, `noSpace`(놓을 곳 없음), `seatMax`, `tableMax`, `needStage`
|
|
- `placeFail {why}`: why = bounds | overlap | reserved | floor | blocked | chair
|
|
- `hired {role}`, `fired {role}`, `staffLocked`, `staffMax`, `strike`(시급 부족), `strikeOver`
|
|
- `renamed`, `nameRejected`(필터 실패·빈 이름), `designSet {design}`, `designLocked`(실내 분식집부터)
|
|
- `promoted {n}`, `promoteNone`(데려올 손님 없음), `promoteFull`(빈자리 없음), `promoteWait {sec}`, `adUnavailable`
|
|
- `kicked {n, shop}`(내가 쫓아냄), `kickedBy {name}`(내 가게 손님이 쫓겨남), `shielded`(보호 중), `kickOwn`(내 가게는 안 됨)
|
|
- `rushOn {min}`, `notEnough {need}`, `doubleOwned`(2배 수익 게임패스를 이미 가지고 있어 결제 창 대신 바로 켬)
|