Roblox GUI Reference 是一份面向 Roblox 平台 GUI 开发的参考资料,覆盖 HUD、菜单、世界空间 UI 与玩家标签等场景。其内容按主题分为若干部分。
GUI 容器类型:资料列出 ScreenGui(挂载于 PlayerGui,用于 HUD、菜单、覆盖层,始终面向屏幕)、SurfaceGui(挂载于 BasePart,用于部件表面的世界空间 UI,如标牌、屏幕)和 BillboardGui(挂载于 BasePart 或 Model,浮于 3D 空间部件上方,用于名牌、血条),并给出 Luau 创建示例,包括 ResetOnSpawn、ZIndexBehavior、SizingMode、PixelsPerStud、StudsOffset、AlwaysOnTop 等属性的设置。
尺寸与定位:介绍 UDim2.new(xScale, xOffset, yScale, yOffset) 的缩放与偏移组合、fromScale 与 fromOffset 快捷构造、AnchorPoint 调整轴心以实现居中等用法。
响应式设计:建议优先使用缩放而非固定偏移,并可借助 UIAspectRatioConstraint 防止形变。
动画:示例使用 TweenService 与 TweenInfo 对菜单位置和进度条尺寸做补间动画,并提供打开/关闭菜单与设置进度的函数写法。
脚本放置:资料对比 StarterGui(加入时克隆到 PlayerGui,可设 ResetOnSpawn = false 以持久化)、StarterPlayerScripts(只运行一次,不随重生重置)与 StarterCharacterScripts(每次生成重新运行),并给出等待角色与监听 HealthChanged 的安全写法。
常用模式速查:包含全屏覆盖层、底部居中 HUD 条、带内边距列表(UIPadding + UIListLayout)、可滚动列表(ScrollingFrame + UIListLayout,按 AbsoluteContentSize 设置 CanvasSize)、圆角(UICorner)、文字缩放(TextScaled)、动态高度(AutomaticSize)、血条(嵌套 Frame + 补间 Size.X.Scale)、名牌(BillboardGui + StudsOffset)等。
常见错误与修复:列出生重后 GUI 消失、移动端显示异常、找不到 PlayerGui、补间不生效(Text 不可补间,Position/Size 可以)、BillboardGui 穿墙可见、首帧 AbsoluteSize 为零、重叠 Frame 点击穿透、SurfaceGui 闪烁、移动端文字过小、移动端布局测试(Studio 设备模拟器)等问题及对应处理方式。另提到在文本标签与按钮中使用 Roblox 原生 Robux 字符 utf8.char(0xE002) 而非图片图标。
使用方式:该资料为参考文档形式,示例代码基于 Luau 与 Roblox Studio 的对象模型;具体安装或调用方式暂未提供。限制方面,未提供性能、兼容性或版本相关的说明。