屏幕界面：制作自己的探险 HUD

StarterGui
└─ AdventureGui (ScreenGui)
   └─ HudController (LocalScript)

运行 F5 后，代码会在 PlayerGui 的副本中加入：
AdventureGui
├─ HudController
└─ Panel (Frame)
   ├─ Title (TextLabel)
   ├─ Objective (TextLabel)
   ├─ ProgressTrack (Frame)
   │  └─ ProgressFill (Frame)
   ├─ Count (TextLabel)
   └─ Status (TextLabel)

local gui = script.Parent

-- 方便重复测试：如果旧面板还在，先删除再重建。
local oldPanel = gui:FindFirstChild("Panel")
if oldPanel then
    oldPanel:Destroy()
end

local function create(className, properties, parent)
    local object = Instance.new(className)
    for property, value in pairs(properties) do
        object[property] = value
    end
    object.Parent = parent
    return object
end

local panel = create("Frame", {
    Name = "Panel",
    AnchorPoint = Vector2.new(0, 0),
    Position = UDim2.fromOffset(18, 18),
    Size = UDim2.new(0.36, 0, 0, 176),
    BackgroundColor3 = Color3.fromRGB(16, 24, 40),
    BackgroundTransparency = 0.08,
    BorderSizePixel = 0,
}, gui)

create("UICorner", {
    CornerRadius = UDim.new(0, 14),
}, panel)

create("UIStroke", {
    Color = Color3.fromRGB(93, 126, 180),
    Transparency = 0.35,
    Thickness = 1,
}, panel)

-- 0.36 让宽度跟屏幕变化；约束保证它不会小得难读或大得挡住画面。
local sizeConstraint = create("UISizeConstraint", {
    MinSize = Vector2.new(280, 176),
    MaxSize = Vector2.new(420, 176),
}, panel)

-- 把 false 改成 true，可以故意制造一次“小屏溢出”并观察原因。
local RUN_OVERFLOW_TEST = false
if RUN_OVERFLOW_TEST then
    sizeConstraint.MinSize = Vector2.new(0, 176)
    sizeConstraint.MaxSize = Vector2.new(2000, 176)
    panel.Size = UDim2.fromOffset(700, 176)
end

create("TextLabel", {
    Name = "Title",
    Position = UDim2.fromOffset(18, 12),
    Size = UDim2.new(1, -36, 0, 28),
    BackgroundTransparency = 1,
    Font = Enum.Font.GothamBold,
    Text = "能量岛探险",
    TextColor3 = Color3.fromRGB(255, 255, 255),
    TextSize = 22,
    TextXAlignment = Enum.TextXAlignment.Left,
}, panel)

local objective = create("TextLabel", {
    Name = "Objective",
    Position = UDim2.fromOffset(18, 44),
    Size = UDim2.new(1, -36, 0, 42),
    BackgroundTransparency = 1,
    Font = Enum.Font.Gotham,
    Text = "",
    TextColor3 = Color3.fromRGB(211, 220, 235),
    TextSize = 17,
    TextWrapped = true,
    TextXAlignment = Enum.TextXAlignment.Left,
    TextYAlignment = Enum.TextYAlignment.Top,
}, panel)

local track = create("Frame", {
    Name = "ProgressTrack",
    Position = UDim2.fromOffset(18, 100),
    Size = UDim2.new(1, -92, 0, 14),
    BackgroundColor3 = Color3.fromRGB(48, 61, 82),
    BorderSizePixel = 0,
    ClipsDescendants = true,
}, panel)
create("UICorner", {CornerRadius = UDim.new(1, 0)}, track)

local fill = create("Frame", {
    Name = "ProgressFill",
    Size = UDim2.fromScale(0, 1),
    BackgroundColor3 = Color3.fromRGB(72, 167, 255),
    BorderSizePixel = 0,
}, track)
create("UICorner", {CornerRadius = UDim.new(1, 0)}, fill)

local countLabel = create("TextLabel", {
    Name = "Count",
    AnchorPoint = Vector2.new(1, 0),
    Position = UDim2.new(1, -18, 0, 93),
    Size = UDim2.fromOffset(56, 28),
    BackgroundTransparency = 1,
    Font = Enum.Font.GothamBold,
    Text = "",
    TextColor3 = Color3.fromRGB(255, 255, 255),
    TextSize = 17,
    TextXAlignment = Enum.TextXAlignment.Right,
}, panel)

local statusLabel = create("TextLabel", {
    Name = "Status",
    Position = UDim2.fromOffset(18, 132),
    Size = UDim2.new(1, -36, 0, 26),
    BackgroundTransparency = 1,
    Font = Enum.Font.GothamMedium,
    Text = "",
    TextColor3 = Color3.fromRGB(150, 190, 230),
    TextSize = 15,
    TextXAlignment = Enum.TextXAlignment.Left,
}, panel)

local function renderQuest(current, total)
    total = math.max(total, 1)
    current = math.clamp(current, 0, total)
    local ratio = current / total

    objective.Text = string.format("目标：找到 %d 颗晶石", total)
    countLabel.Text = string.format("%d / %d", current, total)
    fill.Size = UDim2.fromScale(ratio, 1)

    if current == total then
        statusLabel.Text = "任务完成，可以前往出口"
        statusLabel.TextColor3 = Color3.fromRGB(109, 232, 160)
        fill.BackgroundColor3 = Color3.fromRGB(75, 220, 130)
    else
        statusLabel.Text = "继续探索，留意发光的平台"
        statusLabel.TextColor3 = Color3.fromRGB(150, 190, 230)
        fill.BackgroundColor3 = Color3.fromRGB(72, 167, 255)
    end

    print(string.format("[HUD] %d/%d", current, total))
end

renderQuest(1, 3)

-- 只改这一行，然后每次按 F5 检查：
renderQuest(0, 3) -- 空进度
renderQuest(2, 3) -- 三分之二
renderQuest(3, 3) -- 完成状态
renderQuest(9, 3) -- 越界输入会被 math.clamp 修正

-- 完整程序中已有这个实验开关：
local RUN_OVERFLOW_TEST = true
if RUN_OVERFLOW_TEST then
    sizeConstraint.MinSize = Vector2.new(0, 176)
    sizeConstraint.MaxSize = Vector2.new(2000, 176)
    panel.Size = UDim2.fromOffset(700, 176)
end

-- 测完改回 false，再测试正常的响应式方案。