From 998b2467d6f28c97a981b66f7e957990aa117ce7 Mon Sep 17 00:00:00 2001 From: EJClaw Date: Mon, 12 Oct 2026 13:57:32 +0900 Subject: [PATCH] =?UTF-8?q?feat(bunsik):=20=ED=9C=B4=EB=8C=80=ED=8F=B0?= =?UTF-8?q?=C2=B7=ED=83=9C=EB=B8=94=EB=A6=BF=20=ED=99=94=EB=A9=B4=20?= =?UTF-8?q?=EB=B0=B0=EC=B9=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Layout 모듈: 안전 영역(상단 바·노치 제외) 크기와 터치 여부로 배율·위치 계산 - 휴대폰: 기준 화면 900x400으로 글자·버튼 크게, 결제 버튼은 왼쪽 위, 사기 버튼은 조이스틱(왼쪽 40%×아래 2/3)과 점프 버튼 자리 사이, 마우스 회전 줄 숨김 - 루트가 화면을 꽉 채우고, 배율을 상단 바 뺀 영역 기준으로 계산(아래 카드 잘림 수정) - 개발자 테스트 버튼을 설정 창 안으로 이동 - 기기 12종 배치 단위 테스트, 배치 미리보기 도구(tools/hud_preview.py) Co-Authored-By: Claude Opus 5.5 --- bunsik-tycoon/PLAYTEST.md | 13 +- bunsik-tycoon/src/client/Hud.luau | 135 ++++++++++++------ bunsik-tycoon/src/client/Layout.luau | 158 +++++++++++++++++++++ bunsik-tycoon/src/client/Main.client.luau | 31 +++- bunsik-tycoon/tests/Layout.spec.luau | 108 ++++++++++++++ bunsik-tycoon/tests/cloud/integration.luau | 32 ++++- bunsik-tycoon/tools/hud_layout.luau | 11 ++ bunsik-tycoon/tools/hud_preview.py | 88 ++++++++++++ 8 files changed, 524 insertions(+), 52 deletions(-) create mode 100644 bunsik-tycoon/src/client/Layout.luau create mode 100644 bunsik-tycoon/tests/Layout.spec.luau create mode 100644 bunsik-tycoon/tools/hud_layout.luau create mode 100644 bunsik-tycoon/tools/hud_preview.py diff --git a/bunsik-tycoon/PLAYTEST.md b/bunsik-tycoon/PLAYTEST.md index 9ea3372..01ac153 100644 --- a/bunsik-tycoon/PLAYTEST.md +++ b/bunsik-tycoon/PLAYTEST.md @@ -22,14 +22,23 @@ - 내 가게에 다른 플레이어가 손님으로 오면 알림이 뜨고, 그 손님 접시는 2배 값을 받습니다. 8. 나갔다가 다시 들어와서 돈·업그레이드·설정이 그대로인지 봅니다. +## 휴대폰에서 해 볼 것 + +휴대폰·태블릿은 화면을 가로로 두고 합니다. 화면을 터치하면 휴대폰 배치로 바뀝니다. +- 왼쪽 위: `💰x2 2배 수익`, `⚡ 돈 부스트`. 왼쪽 아래 조이스틱 자리와 겹치지 않게 위로 올렸습니다. +- 오른쪽 위: `⚙️ 설정`, `📋 업그레이드`. 오른쪽 아래 점프 버튼 자리는 비워 두었습니다. +- 아래: 다음 업그레이드 카드. [사기] 버튼은 조이스틱과 점프 버튼 사이에 옵니다. +- 설정 창에는 마우스 회전 줄이 없습니다(휴대폰에는 필요 없음). +- 조이스틱으로 걸을 때 버튼이 눌리지 않는지, 글자가 너무 작지 않은지 봐 주세요. + ## 개발자 테스트 버튼(주인 계정에만 보임) -화면 왼쪽, `⚡ 돈 부스트` 버튼 아래의 `🛠 개발자 테스트` 상자: +`⚙️ 설정` 창 맨 아래의 `🛠 개발자 테스트` 줄: - `+1,000원`: 돈을 바로 넣습니다. 뒤쪽 업그레이드를 빨리 확인할 때 씁니다. - `2배 켜기/끄기`: 2배 수익 게임패스를 산 것처럼 켭니다(이번 접속에만 적용). - `처음부터`: 돈·업그레이드·튜토리얼을 처음으로 되돌립니다. -왼쪽의 `💰x2 2배 수익`, `⚡ 돈 부스트` 버튼은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요. +`💰x2 2배 수익`, `⚡ 돈 부스트` 버튼은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요. ## 알려 주시면 좋은 것 diff --git a/bunsik-tycoon/src/client/Hud.luau b/bunsik-tycoon/src/client/Hud.luau index ead219e..b59a79f 100644 --- a/bunsik-tycoon/src/client/Hud.luau +++ b/bunsik-tycoon/src/client/Hud.luau @@ -1,5 +1,6 @@ --!strict --- 화면 UI: 돈, 다음 업그레이드, 업그레이드 목록, 2배 수익·돈 부스트 버튼, 설정(언어·마우스 회전·효과음), 안내 문구, 알림. +-- 화면 UI: 돈, 다음 업그레이드, 업그레이드 목록, 2배 수익·돈 부스트 버튼, 설정(언어·마우스 회전·효과음·개발자 테스트), 안내 문구, 알림. +-- 배치는 Layout 모듈이 화면 크기와 터치 여부로 정합니다(휴대폰은 조이스틱·점프 버튼 자리를 피함). -- 상태는 `state` 인스턴스(실제 게임에서는 Player)의 속성에서 읽습니다. 서버에서도 만들 수 있어서 원격 테스트로 검사합니다. local ReplicatedStorage = game:GetService("ReplicatedStorage") @@ -9,6 +10,7 @@ local Shared = ReplicatedStorage:WaitForChild("Shared") local Economy = require(Shared:WaitForChild("Economy")) local Locale = require(Shared:WaitForChild("Locale")) local Products = require(Shared:WaitForChild("Products")) +local Layout = require(script.Parent:WaitForChild("Layout")) local Hud = {} @@ -16,7 +18,9 @@ export type HudHandle = { gui: ScreenGui, refresh: () -> (), notify: (key: string, args: { [string]: any }?) -> (), - setScale: (number) -> (), + -- UI가 쓸 수 있는 화면 크기(픽셀, 상단 바 제외)와 터치 화면 여부로 배치를 다시 잡습니다. + setLayout: (size: Vector2, touch: boolean) -> (), + layout: () -> Layout.Result, menuOpen: () -> boolean, -- 업그레이드·설정 창이 열려 있으면 true(마우스 커서를 풀어 줌) destroy: () -> (), } @@ -117,13 +121,10 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () gui.ZIndexBehavior = Enum.ZIndexBehavior.Sibling gui.Parent = parent - local root = frame(gui, "Root", UDim2.fromScale(1, 1), UDim2.fromScale(0, 0), Vector2.zero) + -- 루트는 기준 단위(화면 픽셀 / 배율) 크기로 만들고 UIScale로 키워 화면을 꽉 채웁니다. + local root = frame(gui, "Root", UDim2.fromOffset(1100, 620), UDim2.fromScale(0, 0), Vector2.zero) local scale = Instance.new("UIScale") scale.Parent = root - -- UIScale은 자식 크기를 키우므로, 기준 화면(1100x620) 크기의 루트에 붙이고 가운데에 둡니다. - root.Size = UDim2.fromOffset(1100, 620) - root.AnchorPoint = Vector2.new(0.5, 0.5) - root.Position = UDim2.fromScale(0.5, 0.5) -- 돈 local money = frame(root, "Money", UDim2.fromOffset(300, 62), UDim2.new(0.5, 0, 0, 6), Vector2.new(0.5, 0), ORANGE) @@ -226,32 +227,7 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () Color3.fromRGB(240, 170, 30) ) - -- 개발자(게임 주인)만 보는 테스트 버튼 - local dev = frame( - root, - "Dev", - UDim2.fromOffset(170, 150), - UDim2.new(0, 10, 0.5, 80), - Vector2.new(0, 0), - Color3.fromRGB(40, 40, 50) - ) - dev.BackgroundTransparency = 0.3 - corner(dev, 12) - local devTitle = text(dev, "Title", UDim2.new(1, -10, 0, 22), UDim2.fromOffset(5, 4), Color3.new(1, 1, 1)) - local devButtons: { [string]: TextButton } = {} - for i, key in { "devMoney", "devDouble", "devReset" } do - local b = button( - dev, - key, - UDim2.new(1, -16, 0, 34), - UDim2.fromOffset(8, 30 + (i - 1) * 39), - Vector2.zero, - Color3.fromRGB(90, 90, 110) - ) - devButtons[key] = b - end - - -- 오른쪽 위: 설정 버튼과 설정 창(언어, 마우스로 화면 돌리기, 효과음) + -- 오른쪽 위: 설정 버튼과 설정 창(언어, 마우스로 화면 돌리기, 효과음, 개발자 테스트) local settingsBtn = button( root, "Settings", @@ -315,6 +291,79 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () sfxLabel.Size = UDim2.new(1, -150, 0, 30) local sfxBtn = button(settings, "Sfx", UDim2.fromOffset(110, 40), UDim2.new(1, -16, 0, 242), Vector2.new(1, 0), GRAY) + -- 개발자(게임 주인)만 보는 테스트 버튼 줄 + local devTitle = rowLabel("DevLabel", 0) + local devButtons: { [string]: TextButton } = {} + for i, key in { "devMoney", "devDouble", "devReset" } do + devButtons[key] = button( + settings, + key, + UDim2.fromOffset(157, 40), + UDim2.fromOffset(16 + (i - 1) * 165, 0), + Vector2.zero, + Color3.fromRGB(90, 90, 110) + ) + end + + -- 화면 크기에 맞춰 배치합니다(Layout 모듈). 개발자 줄이 생기거나 없어질 때도 다시 잡습니다. + local function place(o: GuiObject, r: Layout.Rect) + o.AnchorPoint = Vector2.zero + o.Position = UDim2.fromOffset(r.x, r.y) + o.Size = UDim2.fromOffset(r.w, r.h) + end + local screen = Vector2.new(1100, 620) + local touch = false + local layoutNow: Layout.Result + local function relayout() + local dev = attr(state, "Dev", false) == true + local lay = Layout.compute(screen.X, screen.Y, touch, dev) + layoutNow = lay + scale.Scale = lay.scale + -- Offset은 정수라서 올림해 화면을 다 덮습니다(1 기준 단위 미만 차이). + root.Size = UDim2.fromOffset(math.ceil(lay.width), math.ceil(lay.height)) + place(money, lay.money) + place(carry, lay.carry) + place(hint, lay.hint) + place(toasts, lay.toasts) + place(card, lay.card) + place(listBtn, lay.list) + place(settingsBtn, lay.settings) + place(passBtn, lay.double) + place(boostBtn, lay.boost) + place(panel, lay.panel) + place(settings, lay.settingsPanel) + local r = lay.rows + closeBtn.Size = UDim2.fromOffset(90, r.closeH) + settingsClose.Size = UDim2.fromOffset(90, r.closeH) + for _, b in langButtons do + b.Size = UDim2.fromOffset(92, r.langButtonH) + end + local mouseY = r.mouseY + mouseLabel.Visible = mouseY ~= nil + mouseBtn.Visible = mouseY ~= nil + mouseHint.Visible = mouseY ~= nil + if mouseY then + mouseLabel.Position = UDim2.fromOffset(16, mouseY + 4) + mouseBtn.Position = UDim2.new(1, -16, 0, mouseY) + mouseHint.Position = UDim2.fromOffset(16, mouseY + 44) + end + sfxLabel.Position = UDim2.fromOffset(16, r.sfxY + (r.toggleH - 30) / 2) + sfxBtn.Position = UDim2.new(1, -16, 0, r.sfxY) + sfxBtn.Size = UDim2.fromOffset(110, r.toggleH) + local devY = r.devY + devTitle.Visible = devY ~= nil + if devY then + devTitle.Position = UDim2.fromOffset(16, devY) + end + for _, b in devButtons do + b.Visible = devY ~= nil + if devY then + b.Position = UDim2.fromOffset(b.Position.X.Offset, devY + 30) + b.Size = UDim2.fromOffset(157, r.devButtonH) + end + end + end + relayout() local function lang(): string return attr(state, "Lang", "ko") @@ -381,7 +430,9 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () buyStroke.Color = Color3.new(1, 1, 1) end - dev.Visible = attr(state, "Dev", false) == true + if (layoutNow.rows.devY ~= nil) ~= (attr(state, "Dev", false) == true) then + relayout() + end devTitle.Text = "🛠 " .. L("devTitle") for key, b in devButtons do b.Text = L(key) @@ -463,7 +514,7 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () end end local toast = - frame(toasts, "Toast", UDim2.fromOffset(540, 46), UDim2.new(), Vector2.zero, Color3.fromRGB(45, 45, 60)) + frame(toasts, "Toast", UDim2.new(1, -20, 0, 46), UDim2.new(), Vector2.zero, Color3.fromRGB(45, 45, 60)) corner(toast, 12) local t = text(toast, "Text", UDim2.new(1, -20, 1, -10), UDim2.fromOffset(10, 5), Color3.new(1, 1, 1)) t.Text = L(key, args) @@ -558,8 +609,13 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () gui = gui, refresh = refresh, notify = notify, - setScale = function(s: number) - scale.Scale = s + setLayout = function(size: Vector2, isTouch: boolean) + screen = size + touch = isTouch + relayout() + end, + layout = function(): Layout.Result + return layoutNow end, menuOpen = function(): boolean return panel.Visible or settings.Visible @@ -573,9 +629,4 @@ function Hud.build(parent: Instance, state: Instance, send: (string, any?) -> () } end --- 화면 크기에 맞춘 UI 배율(기준 1100x620) -function Hud.scaleFor(viewport: Vector2): number - return math.clamp(math.min(viewport.X / 1100, viewport.Y / 620), 0.5, 1.4) -end - return Hud diff --git a/bunsik-tycoon/src/client/Layout.luau b/bunsik-tycoon/src/client/Layout.luau new file mode 100644 index 0000000..a2fb0f9 --- /dev/null +++ b/bunsik-tycoon/src/client/Layout.luau @@ -0,0 +1,158 @@ +--!strict +-- 화면 UI 배치 계산(로블록스 서비스 없이 숫자만 다룸, lune 단위 테스트로 검사). +-- 입력은 UI가 쓸 수 있는 화면 크기(상단 바·노치를 뺀 안전 영역, 픽셀)와 터치 화면 여부입니다. +-- 결과 좌표는 기준 단위이고, 화면 픽셀 = 기준 단위 × scale 입니다. +-- 터치 화면에서는 로블록스 기본 조이스틱 자리(왼쪽 40% × 아래 2/3)와 점프 버튼 자리(오른쪽 아래)에 +-- 누르는 버튼을 두지 않습니다. 두 자리의 크기는 로블록스 PlayerModule(TouchJump, DynamicThumbstick)에서 가져왔습니다. + +local Layout = {} + +export type Rect = { x: number, y: number, w: number, h: number } + +export type Result = { + scale: number, + width: number, -- 기준 단위 화면 너비 + height: number, + touch: boolean, + money: Rect, + carry: Rect, + hint: Rect, + toasts: Rect, + card: Rect, + buy: Rect, -- 카드 안의 [사기] 버튼(화면 기준 위치) + settings: Rect, + list: Rect, + double: Rect, + boost: Rect, + panel: Rect, + settingsPanel: Rect, + -- 설정 창 안쪽 줄(설정 창 기준 y) + rows: { + langButtonH: number, + mouseY: number?, -- 터치 화면에서는 마우스 줄을 숨김(nil) + sfxY: number, + toggleH: number, + devY: number?, -- 개발자 줄(게임 주인에게만) + devButtonH: number, + closeH: number, + }, +} + +local CARD_W, CARD_H = 500, 96 +local BUY_W, BUY_H = 140, 72 +local PANEL_W = 520 + +local function rect(x: number, y: number, w: number, h: number): Rect + return { x = x, y = y, w = w, h = h } +end + +-- 로블록스 터치 조작이 차지하는 자리(픽셀). 점프 버튼은 두 가지 배치(기본, 아바타 능력 UI)를 모두 덮는 상자입니다. +function Layout.touchZones(w: number, h: number): { stick: Rect, jump: Rect } + local small = math.min(w, h) <= 500 + local jx = if small then 136 else 220 + local jy = if small then 136 else 232 + return { + stick = rect(0, h / 3, w * 0.4, h * 2 / 3), + jump = rect(w - jx, h - jy, jx, jy), + } +end + +function Layout.scaleFor(w: number, h: number, touch: boolean): number + if touch then + -- 휴대폰은 화면이 작아서 기준 화면을 900x400으로 줄여 글자·버튼을 크게 보여 줍니다. + return math.clamp(math.min(w / 900, h / 400), 0.5, 1.4) + end + return math.clamp(math.min(w / 1100, h / 620), 0.5, 1.4) +end + +function Layout.compute(w: number, h: number, touch: boolean, dev: boolean): Result + local s = Layout.scaleFor(w, h, touch) + local W, H = w / s, h / s + local cx = W / 2 + + local money = rect(cx - 150, 6, 300, 62) + local carry = rect(cx - 80, 72, 160, 28) + + local settings, list, double, boost + local hintW + if touch then + -- 오른쪽 위: 설정, 업그레이드 목록. 왼쪽 위: 2배 수익, 돈 부스트(조이스틱 자리 H/3 위쪽). + settings = rect(W - 160, 6, 150, 52) + list = rect(W - 160, 66, 150, 56) + double = rect(10, 6, 170, 58) + boost = rect(10, 70, 170, 58) + hintW = math.min(640, W - 2 * 190) + else + settings = rect(W - 140, 6, 130, 44) + list = rect(W - 160, H / 2 - 68, 150, 56) + double = rect(10, H / 2 - 72, 170, 64) + boost = rect(10, H / 2 + 2, 170, 64) + hintW = 640 + end + local hint = rect(cx - hintW / 2, 104, hintW, 54) + + -- 아래 카드: 터치 화면에서는 점프 버튼 왼쪽까지 밀어 둡니다. + local cardX = cx - CARD_W / 2 + if touch then + local zones = Layout.touchZones(w, h) + cardX = math.min(cardX, zones.jump.x / s - 8 - CARD_W) + end + cardX = math.max(cardX, 10) + local card = rect(cardX, H - 8 - CARD_H, CARD_W, CARD_H) + local buy = rect(card.x + CARD_W - 12 - BUY_W, card.y + (CARD_H - BUY_H) / 2, BUY_W, BUY_H) + + local toastsW = math.min(560, hintW) + local toasts = rect(cx - toastsW / 2, 166, toastsW, math.max(0, card.y - 6 - 166)) + + local panelH = math.min(430, H - 20) + local panel = rect(cx - PANEL_W / 2, math.max(6, H * 0.48 - panelH / 2), PANEL_W, panelH) + + -- 설정 창 줄: 제목(10~54), 언어 이름(64), 언어 버튼(100~), 마우스(PC만), 효과음, 개발자(주인만) + local langButtonH = if touch then 52 else 44 + local toggleH = if touch then 48 else 40 + local y = 100 + langButtonH + 12 + local mouseY: number? = nil + if not touch then + mouseY = y + y += 90 + end + local sfxY = y + y += toggleH + 12 + local devY: number? = nil + if dev then + devY = y + y += 30 + toggleH + 12 + end + local setH = y + 4 + local settingsPanel = rect(cx - PANEL_W / 2, math.max(6, H * 0.48 - setH / 2), PANEL_W, setH) + + return { + scale = s, + width = W, + height = H, + touch = touch, + money = money, + carry = carry, + hint = hint, + toasts = toasts, + card = card, + buy = buy, + settings = settings, + list = list, + double = double, + boost = boost, + panel = panel, + settingsPanel = settingsPanel, + rows = { + langButtonH = langButtonH, + mouseY = mouseY, + sfxY = sfxY, + toggleH = toggleH, + devY = devY, + devButtonH = toggleH, + closeH = if touch then 48 else 42, + }, + } +end + +return Layout diff --git a/bunsik-tycoon/src/client/Main.client.luau b/bunsik-tycoon/src/client/Main.client.luau index 74709a3..593b6b5 100644 --- a/bunsik-tycoon/src/client/Main.client.luau +++ b/bunsik-tycoon/src/client/Main.client.luau @@ -25,12 +25,34 @@ while not player:GetAttribute("Ready") do end local hud = Hud.build(player:WaitForChild("PlayerGui"), player, send) +local UserInputService = game:GetService("UserInputService") +local GuiService = game:GetService("GuiService") local camera = workspace.CurrentCamera -local function rescale() - hud.setScale(Hud.scaleFor(camera.ViewportSize)) +-- 휴대폰·태블릿 배치: 마지막 입력이 터치면 켜고, 마우스·게임패드면 끕니다(키보드 입력은 채팅일 수 있어 무시). +local touch = UserInputService.TouchEnabled and not UserInputService.MouseEnabled +local function relayout() + -- ScreenGui 크기는 상단 바·노치를 뺀 영역입니다. 첫 프레임 전이라 0이면 화면 크기에서 상단 바만 뺍니다. + local size = hud.gui.AbsoluteSize + if size.X < 2 or size.Y < 2 then + size = camera.ViewportSize - Vector2.new(0, GuiService:GetGuiInset().Y) + end + hud.setLayout(size, touch) end -camera:GetPropertyChangedSignal("ViewportSize"):Connect(rescale) -rescale() +UserInputService.LastInputTypeChanged:Connect(function(t) + local isTouch: boolean? = nil + if t == Enum.UserInputType.Touch then + isTouch = true + elseif t.Name:sub(1, 5) == "Mouse" or t.Name:sub(1, 7) == "Gamepad" then + isTouch = false + end + if isTouch ~= nil and isTouch ~= touch then + touch = isTouch + relayout() + end +end) +hud.gui:GetPropertyChangedSignal("AbsoluteSize"):Connect(relayout) +camera:GetPropertyChangedSignal("ViewportSize"):Connect(relayout) +relayout() -- 구매·확장 효과음은 내 화면에서만 크게(위치 없이) 들립니다. local Sounds = require(ReplicatedStorage:WaitForChild("Shared"):WaitForChild("Sounds")) local sfxGroup = SoundService:WaitForChild("Sfx") :: SoundGroup @@ -76,7 +98,6 @@ Plots.start(world:WaitForChild("Plots"), player, player.UserId, send) Guide.start(player) MouseLook.start(player, hud.menuOpen) -local UserInputService = game:GetService("UserInputService") if player:GetAttribute("MouseLook") == true and UserInputService.MouseEnabled and UserInputService.KeyboardEnabled then hud.notify("mouseHint") end diff --git a/bunsik-tycoon/tests/Layout.spec.luau b/bunsik-tycoon/tests/Layout.spec.luau new file mode 100644 index 0000000..d1381ac --- /dev/null +++ b/bunsik-tycoon/tests/Layout.spec.luau @@ -0,0 +1,108 @@ +-- 화면 UI 배치 검사: 기기별 화면에서 UI가 화면 안에 있고, 서로 겹치지 않고, +-- 휴대폰에서는 누르는 버튼이 조이스틱·점프 버튼 자리를 피하고 손가락으로 누를 만큼 큰지. lune run tests/Layout.spec.luau +local Layout = require("../src/client/Layout") +local T = require("./check") + +type Rect = Layout.Rect + +-- 가로 화면 크기(포인트)에서 로블록스 상단 바(58)와 노치(좌우)를 뺀 UI 영역 +local DEVICES: { { name: string, w: number, h: number, touch: boolean } } = { + { name = "iPhone SE", w = 667, h = 375 - 58, touch = true }, + { name = "iPhone 15", w = 844 - 94, h = 390 - 58, touch = true }, + { name = "iPhone 15 Pro Max", w = 932 - 118, h = 430 - 58, touch = true }, + { name = "Android 640x360", w = 640, h = 360 - 58, touch = true }, + { name = "Android 800x360", w = 800, h = 360 - 58, touch = true }, + { name = "Galaxy S 915x412", w = 915, h = 412 - 58, touch = true }, + { name = "iPad 1024x768", w = 1024, h = 768 - 58, touch = true }, + { name = "iPad Pro 11", w = 1194, h = 834 - 58, touch = true }, + { name = "PC 1280x720", w = 1280, h = 720 - 58, touch = false }, + { name = "PC 1366x768", w = 1366, h = 768 - 58, touch = false }, + { name = "PC 1920x1080", w = 1920, h = 1080 - 58, touch = false }, + { name = "PC 작은 창 800x600", w = 800, h = 600 - 58, touch = false }, +} + +local function inside(r: Rect, W: number, H: number): boolean + return r.x >= 0 and r.y >= 0 and r.x + r.w <= W + 1e-6 and r.y + r.h <= H + 1e-6 +end + +local function overlap(a: Rect, b: Rect): boolean + return a.x < b.x + b.w and b.x < a.x + a.w and a.y < b.y + b.h and b.y < a.y + a.h +end + +local function px(r: Rect, s: number): Rect + return { x = r.x * s, y = r.y * s, w = r.w * s, h = r.h * s } +end + +for _, d in DEVICES do + for _, dev in { false, true } do + local L = Layout.compute(d.w, d.h, d.touch, dev) + local tag = `{d.name}{if dev then "(개발자)" else ""}` + T.check( + math.abs(L.width * L.scale - d.w) < 1e-6 and math.abs(L.height * L.scale - d.h) < 1e-6, + `{tag}: 화면 꽉 채움` + ) + + -- 늘 보이는 요소: 화면 안, 서로 안 겹침 + local hud: { [string]: Rect } = { + money = L.money, + carry = L.carry, + hint = L.hint, + toasts = L.toasts, + card = L.card, + settings = L.settings, + list = L.list, + double = L.double, + boost = L.boost, + } + for name, r in hud do + T.check(inside(r, L.width, L.height), `{tag}: {name} 화면 안`) + end + T.check(inside(L.buy, L.width, L.height), `{tag}: 사기 버튼 화면 안`) + local names = {} + for name in hud do + table.insert(names, name) + end + table.sort(names) + for i, a in names do + for j = i + 1, #names do + local b = names[j] + T.check(not overlap(hud[a], hud[b]), `{tag}: {a}와 {b} 안 겹침`) + end + end + T.check(L.toasts.h >= 46, `{tag}: 알림 한 줄 이상 자리`) + + -- 창(업그레이드 목록, 설정)은 화면 안에 다 들어감 + T.check(inside(L.panel, L.width, L.height), `{tag}: 업그레이드 창 화면 안`) + T.check(inside(L.settingsPanel, L.width, L.height), `{tag}: 설정 창 화면 안`) + T.eq(L.rows.devY ~= nil, dev, `{tag}: 개발자 줄은 주인에게만`) + T.eq(L.rows.mouseY == nil, d.touch, `{tag}: 마우스 회전 줄은 PC만`) + + if d.touch then + local zones = Layout.touchZones(d.w, d.h) + local buttons: { [string]: Rect } = { + buy = L.buy, + settings = L.settings, + list = L.list, + double = L.double, + boost = L.boost, + } + for name, r in buttons do + local p = px(r, L.scale) + T.check(not overlap(p, zones.stick), `{tag}: {name} 버튼이 조이스틱 자리 피함`) + T.check(not overlap(p, zones.jump), `{tag}: {name} 버튼이 점프 버튼 자리 피함`) + T.check(p.h >= 36, `{tag}: {name} 버튼 높이 {math.floor(p.h)}px ≥ 36`) + end + T.check(L.rows.langButtonH * L.scale >= 36, `{tag}: 언어 버튼 누르기 쉬움`) + T.check(L.rows.toggleH * L.scale >= 34, `{tag}: 켜기/끄기 버튼 누르기 쉬움`) + end + end +end + +-- PC는 예전과 같은 기준 화면(1100x620), 휴대폰은 더 크게 +T.eq(Layout.scaleFor(1100, 620, false), 1, "PC 기준 배율") +T.check( + Layout.scaleFor(750, 332, true) > Layout.scaleFor(750, 332, false), + "휴대폰은 같은 화면에서 더 크게" +) + +T.done("Layout") diff --git a/bunsik-tycoon/tests/cloud/integration.luau b/bunsik-tycoon/tests/cloud/integration.luau index f238a74..9329708 100644 --- a/bunsik-tycoon/tests/cloud/integration.luau +++ b/bunsik-tycoon/tests/cloud/integration.luau @@ -436,14 +436,40 @@ eq((settingsPanel:FindFirstChild("Sfx") :: TextButton).Text, "Off", "효과음 check(not hud.menuOpen(), "창 닫힘") state:SetAttribute("Bought", #Economy.PURCHASES) check(not (root:FindFirstChild("Next"):FindFirstChild("Buy") :: TextButton).Visible, "다 사면 사기 버튼 숨김") -check(not (root:FindFirstChild("Dev") :: Frame).Visible, "개발자 버튼은 기본으로 숨김") +check(root:FindFirstChild("Dev") == nil, "개발자 버튼은 설정 창 안으로") +local devMoneyBtn = settingsPanel:FindFirstChild("devMoney") :: TextButton +check(not devMoneyBtn.Visible, "개발자 버튼은 기본으로 숨김") +local setH = settingsPanel.Size.Y.Offset state:SetAttribute("Dev", true) -check((root:FindFirstChild("Dev") :: Frame).Visible, "게임 주인에게 개발자 버튼") +check(devMoneyBtn.Visible, "게임 주인에게 개발자 버튼(설정 창)") +check(settingsPanel.Size.Y.Offset > setH, "개발자 줄만큼 설정 창이 길어짐") check((root:FindFirstChild("Double") :: TextButton).Visible, "2배 수익 버튼(상품 ID 설정됨)") hud.notify("purchased", { item = "Table2" }) local toastText = root.Toasts:FindFirstChild("Toast"):FindFirstChild("Text") :: TextLabel eq(toastText.Text, "Table 2 bought!", "구매 알림에 업그레이드 이름(내 언어)") -hud.setScale(Hud.scaleFor(Vector2.new(844, 390))) +-- 휴대폰 배치(아이폰 15 가로, 상단 바·노치 뺀 영역): 루트가 화면을 채우고, 결제 버튼은 왼쪽 위, 마우스 줄 숨김 +hud.setLayout(Vector2.new(750, 332), true) +local lay = hud.layout() +local scaleObj = root:FindFirstChildOfClass("UIScale") :: UIScale +check( + root.Size.X.Offset * scaleObj.Scale - 750 >= -1e-3 and root.Size.X.Offset * scaleObj.Scale - 750 < scaleObj.Scale, + "휴대폰: 루트 너비 = 화면" +) +check( + root.Size.Y.Offset * scaleObj.Scale - 332 >= -1e-3 and root.Size.Y.Offset * scaleObj.Scale - 332 < scaleObj.Scale, + "휴대폰: 루트 높이 = 화면" +) +eq( + (root:FindFirstChild("Double") :: TextButton).Position.Y.Offset, + lay.double.y, + "휴대폰: 2배 수익 버튼 위치" +) +check(lay.double.y + lay.double.h < lay.height / 3, "휴대폰: 결제 버튼은 조이스틱 자리 위") +check(not (settingsPanel:FindFirstChild("MouseLook") :: TextButton).Visible, "휴대폰: 마우스 회전 줄 숨김") +check(scaleObj.Scale > 0.8, `휴대폰: 글자 배율 {scaleObj.Scale}`) +hud.setLayout(Vector2.new(1366, 710), false) +check((settingsPanel:FindFirstChild("MouseLook") :: TextButton).Visible, "PC: 마우스 회전 줄 보임") +check(math.abs(scaleObj.Scale - math.min(1366 / 1100, 710 / 620)) < 1e-6, "PC: 배율(상단 바 뺀 높이 기준)") hud.destroy() section("조리 버튼(클라이언트 모듈)") diff --git a/bunsik-tycoon/tools/hud_layout.luau b/bunsik-tycoon/tools/hud_layout.luau new file mode 100644 index 0000000..c3b8449 --- /dev/null +++ b/bunsik-tycoon/tools/hud_layout.luau @@ -0,0 +1,11 @@ +-- 화면 UI 배치를 JSON으로 출력합니다(tools/hud_preview.py가 그림으로 그림). lune run tools/hud_layout.luau 너비 높이 touch|pc +local process = require("@lune/process") +local serde = require("@lune/serde") +local Layout = require("../src/client/Layout") + +local w = tonumber(process.args[1]) or 750 +local h = tonumber(process.args[2]) or 332 +local touch = process.args[3] == "touch" +local out = Layout.compute(w, h, touch, true) :: any +out.zones = Layout.touchZones(w, h) +print(serde.encode("json", out)) diff --git a/bunsik-tycoon/tools/hud_preview.py b/bunsik-tycoon/tools/hud_preview.py new file mode 100644 index 0000000..039a490 --- /dev/null +++ b/bunsik-tycoon/tools/hud_preview.py @@ -0,0 +1,88 @@ +#!/usr/bin/env python3 +"""화면 UI 배치 미리보기: 기기 화면 크기별로 UI 상자와 로블록스 조이스틱·점프 버튼 자리를 그립니다. +실제 글자·색은 아니고 위치·크기만 맞습니다. + + python3 tools/hud_preview.py out.png +""" +import json +import os +import subprocess +import sys + +from PIL import Image, ImageDraw, ImageFont + +ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +DEVICES = [ + ("iPhone SE", 667, 375 - 58, True), + ("iPhone 15", 844 - 94, 390 - 58, True), + ("Android 800x360", 800, 360 - 58, True), + ("iPad 1024x768", 1024, 768 - 58, True), + ("PC 1366x768", 1366, 768 - 58, False), +] +BOXES = [ + ("money", "돈", (255, 130, 50)), + ("carry", "들고 있는 접시", (200, 160, 120)), + ("hint", "튜토리얼 안내", (255, 235, 120)), + ("toasts", "알림 자리", (120, 120, 150)), + ("card", "다음 업그레이드", (255, 248, 235)), + ("buy", "사기", (70, 190, 90)), + ("settings", "설정", (80, 140, 230)), + ("list", "업그레이드 목록", (255, 130, 50)), + ("double", "2배 수익", (150, 80, 220)), + ("boost", "돈 부스트", (240, 170, 30)), +] + + +def font(size): + for path in ("/usr/share/fonts/truetype/nanum/NanumGothicBold.ttf", + "/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc", + "/usr/share/fonts/truetype/noto/NotoSansCJK-Bold.ttc"): + if os.path.exists(path): + return ImageFont.truetype(path, size) + return ImageFont.load_default() + + +def layout(w, h, touch): + out = subprocess.run(["lune", "run", "tools/hud_layout.luau", str(w), str(h), "touch" if touch else "pc"], + cwd=ROOT, capture_output=True, text=True, check=True).stdout + return json.loads(out) + + +def draw_device(name, w, h, touch): + L = layout(w, h, touch) + s = L["scale"] + img = Image.new("RGB", (w, h + 30), (40, 40, 40)) + d = ImageDraw.Draw(img, "RGBA") + d.rectangle([0, 30, w - 1, h + 29], fill=(110, 160, 110)) + d.text((6, 4), f"{name} UI 영역 {w}x{h} 배율 {s:.2f}", fill=(255, 255, 255), font=font(18)) + if touch: + for key, label in (("stick", "조이스틱 자리"), ("jump", "점프 버튼 자리")): + z = L["zones"][key] + d.rectangle([z["x"], z["y"] + 30, z["x"] + z["w"], z["y"] + z["h"] + 30], fill=(255, 0, 0, 60), + outline=(255, 60, 60), width=2) + d.text((z["x"] + 6, z["y"] + z["h"] + 30 - 22), label, fill=(255, 220, 220), font=font(14)) + for key, label, color in BOXES: + r = L[key] + x0, y0 = r["x"] * s, r["y"] * s + 30 + x1, y1 = x0 + r["w"] * s, y0 + r["h"] * s + alpha = 90 if key == "toasts" else 230 + d.rounded_rectangle([x0, y0, x1, y1], radius=6, fill=color + (alpha,), outline=(255, 255, 255), width=2) + d.text((x0 + 4, y0 + 2), label, fill=(20, 20, 20), font=font(max(10, int(15 * s)))) + return img + + +def main(argv): + out = argv[1] if len(argv) > 1 else "hud_preview.png" + imgs = [draw_device(*dev) for dev in DEVICES] + width = max(i.width for i in imgs) + sheet = Image.new("RGB", (width, sum(i.height + 10 for i in imgs)), (25, 25, 25)) + y = 0 + for i in imgs: + sheet.paste(i, (0, y)) + y += i.height + 10 + sheet.save(out) + print(out) + + +if __name__ == "__main__": + main(sys.argv)