feat(bunsik): 휴대폰·태블릿 화면 배치

- Layout 모듈: 안전 영역(상단 바·노치 제외) 크기와 터치 여부로 배율·위치 계산
- 휴대폰: 기준 화면 900x400으로 글자·버튼 크게, 결제 버튼은 왼쪽 위, 사기 버튼은
  조이스틱(왼쪽 40%×아래 2/3)과 점프 버튼 자리 사이, 마우스 회전 줄 숨김
- 루트가 화면을 꽉 채우고, 배율을 상단 바 뺀 영역 기준으로 계산(아래 카드 잘림 수정)
- 개발자 테스트 버튼을 설정 창 안으로 이동
- 기기 12종 배치 단위 테스트, 배치 미리보기 도구(tools/hud_preview.py)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
EJClaw
2026-10-12 13:57:32 +09:00
parent 4d861b8fd3
commit 998b2467d6
8 changed files with 524 additions and 52 deletions

View File

@@ -22,14 +22,23 @@
- 내 가게에 다른 플레이어가 손님으로 오면 알림이 뜨고, 그 손님 접시는 2배 값을 받습니다.
8. 나갔다가 다시 들어와서 돈·업그레이드·설정이 그대로인지 봅니다.
## 휴대폰에서 해 볼 것
휴대폰·태블릿은 화면을 가로로 두고 합니다. 화면을 터치하면 휴대폰 배치로 바뀝니다.
- 왼쪽 위: `💰x2 2배 수익`, `⚡ 돈 부스트`. 왼쪽 아래 조이스틱 자리와 겹치지 않게 위로 올렸습니다.
- 오른쪽 위: `⚙️ 설정`, `📋 업그레이드`. 오른쪽 아래 점프 버튼 자리는 비워 두었습니다.
- 아래: 다음 업그레이드 카드. [사기] 버튼은 조이스틱과 점프 버튼 사이에 옵니다.
- 설정 창에는 마우스 회전 줄이 없습니다(휴대폰에는 필요 없음).
- 조이스틱으로 걸을 때 버튼이 눌리지 않는지, 글자가 너무 작지 않은지 봐 주세요.
## 개발자 테스트 버튼(주인 계정에만 보임)
화면 왼쪽, `⚡ 돈 부스트` 버튼 아래의 `🛠 개발자 테스트` 상자:
`⚙️ 설정` 창 맨 아래의 `🛠 개발자 테스트` 줄:
- `+1,000원`: 돈을 바로 넣습니다. 뒤쪽 업그레이드를 빨리 확인할 때 씁니다.
- `2배 켜기/끄기`: 2배 수익 게임패스를 산 것처럼 켭니다(이번 접속에만 적용).
- `처음부터`: 돈·업그레이드·튜토리얼을 처음으로 되돌립니다.
왼쪽의 `💰x2 2배 수익`, `⚡ 돈 부스트` 버튼은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요.
`💰x2 2배 수익`, `⚡ 돈 부스트` 버튼은 진짜 결제 창이 뜹니다. 누르면 실제 로벅스가 나가니, 결제 테스트가 필요할 때만 쓰세요.
## 알려 주시면 좋은 것

View File

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

View File

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

View File

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

View File

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

View File

@@ -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("조리 버튼(클라이언트 모듈)")

View File

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

View File

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