- [가게 꾸미기]를 누르면 창 없이 바로 꾸미기 모드: 아래 물건 줄(테이블·의자·소품 6가지, 값·개수)에서 고르면 투명 미리보기를 들고 걸어가 [배치]. [이동]은 고른 가구를 들고 옮기기, [삭제]는 고른 가구를 빨갛게 표시한 뒤 한 번 더 눌러 지우고 산 값 돌려받기(조리대·마지막 테이블/의자·의자가 보는 테이블·손님 앉은 의자는 막음) - 새 요청 remove, Floor.remove, Shop.removeSeat(뒤 자리 손님·걷는 시간 번호 당김) - 내 가게 탭: 이름 색 무료 10색 + 무지개(게임패스) 칸. 부지 속성 NameColor로 모두에게 보임 - 개발자 테스트 [결제 테스트 켜기/끄기]: 켜면 2배·부스트·러시·쫓아내기·광고 홍보·무지개·유료 디자인이 결제 창 없이 바로 지급(이번 접속만), 게임패스는 안 가진 상태로 바꿔 사는 흐름을 볼 수 있고 끄면 실제 보유로 복구 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.6 KiB
7.6 KiB
서버 ↔ 클라이언트 약속 (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 | 무지개 이름 켜기 설정 |
| NameColor | number | 가게 이름 글자색(Economy.NAME_COLORS 번호 1~10, 0 = 디자인 기본색) |
| DevFree | 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 | 무지개 이름(게임패스 + 켜짐). 켜져 있으면 NameColor보다 먼저 |
| NameColor | 가게 이름 글자색 번호(0 = 기본) |
| 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은 그 테이블을 보는 의자들을 테이블 둘레로 돌리는 횟수(의자도 같이 옮겨짐) |
remove |
{kind="table"/"chair"/"decor", i} |
꾸미기 [삭제]: 지우고 산 값 돌려받기(Floor.remove + Shop.removeSeat 검사, 실패면 removeFail) |
nameColor |
0~10 | 가게 이름 색(고르면 무지개는 꺼짐) |
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_* |
예전과 같음. dev_free는 결제 테스트 모드 켜기/끄기(게임 주인만) |
알림 키 (Notify)
예전 키(purchased 등)에 더해:
upgraded {track, level}갈래 업그레이드,newMenu {menu},expanded(실내),floor2(2층)seatAdded,tableAdded,decorAdded {kind},noSpace(놓을 곳 없음),seatMax,tableMax,needStageplaceFail {why}: why = bounds | overlap | reserved | floor | blocked | chairhired {role},fired {role},staffLocked,staffMax,strike(시급 부족),strikeOverrenamed,nameRejected(필터 실패·빈 이름),designSet {design},designLocked(실내 분식집부터)promoted {n},promoteNone(데려올 손님 없음),promoteFull(빈자리 없음),promoteWait {sec},adUnavailablekicked {n, shop}(내가 쫓아냄),kickedBy {name}(내 가게 손님이 쫓겨남),shielded(보호 중),kickOwn(내 가게는 안 됨)removed {thing, money},removeFail {why}(why = stove | last | hasChairs | busy | 배치 검사 이유),devFreeOn,devFreeOffrushOn {min},notEnough {need},doubleOwned(2배 수익 게임패스를 이미 가지고 있어 결제 창 대신 바로 켬)