Roblox Gui

This is your reference when you're wiring up Roblox UI, whether it's a HUD overlay, a progress bar, or floating name tags above player heads. It covers the three container types (ScreenGui for 2D overlays, SurfaceGui for in-world screens, BillboardGui for 3D floating elements), walks through UDim2 sizing with scale versus offset, and shows TweenService patterns for animating menus and health bars. The common mistakes table is genuinely helpful: it catches the usual traps like ResetOnSpawn killing your GUI on respawn, forgetting TextScaled on mobile, and clicks passing through transparent frames. Good for both initial setup and debugging layout issues.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 38
skills.sh installs: 1.3K
GitHub stars: 31
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sentinelcore/roblox-skills --skill roblox-gui --agent claude-code

Installs into .claude/skills of the current project.

Files

Roblox GUI Reference

GUI Container Types

Container	Parent	Use Case
`ScreenGui`	`PlayerGui`	HUDs, menus, overlays — always faces screen
`SurfaceGui`	`BasePart`	World-space UI on a part surface (signs, screens)
`BillboardGui`	`BasePart` or `Model`	Floats above a part in 3D space (name tags, health bars)

ScreenGui

-- LocalScript in StarterGui or StarterPlayerScripts
local player = game:GetService("Players").LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")

local screenGui = Instance.new("ScreenGui")
screenGui.Name = "HUD"
screenGui.ResetOnSpawn = false   -- keep GUI across respawns
screenGui.ZIndexBehavior = Enum.ZIndexBehavior.Sibling
screenGui.Parent = playerGui

SurfaceGui

local surfaceGui = Instance.new("SurfaceGui")
surfaceGui.Face = Enum.NormalId.Front
surfaceGui.SizingMode = Enum.SurfaceGuiSizingMode.PixelsPerStud
surfaceGui.PixelsPerStud = 50
surfaceGui.Parent = workspace.ScreenPart

local label = Instance.new("TextLabel")
label.Size = UDim2.fromScale(1, 1)
label.Text = "Hello World"
label.Parent = surfaceGui