SuperAPI AI 工具集

roblox-ui

编程与开发

查看项目

更新于 11-05 16:19

技能介绍

这是用于无界面构建 Roblox 游戏 UI 的技能,目标是从一份 JSON 规格生成完整的界面树,并同时产出界面预览与可交付的游戏内资源。

用途 主要面向 Roblox 游戏界面开发:HUD 叠加层、商店、背包、任务列表、设置面板等。技能以“一份规格对应一棵已解析的界面树”为核心,界面不会先在设计工具里画成图再迁移,因此 PNG 预览与 .model.json 在尺寸、颜色和布局上不会互相矛盾。

主要能力

  • 从 JSON 规格构建页面:元素类型包括 panel、button、frame、label、icon;容器支持 list/grid 布局、内边距与宽高比;尺寸和位置使用 Roblox 的 UDim2 [sx, ox, sy, oy] 加 anchor。
  • 一次生成三种输出:Page.png(本地快速预览)、Page.model.json(可放入 Rojo 项目)、Page.lua(可粘贴到 execute_luau,无需 Rojo 会话)。
  • 自动深度层叠:每个 panel 和 button 自动展开为阴影、带顶部光照渐变的正面以及统一厚度的深色外描边。
  • 主题支持:默认使用 references/theme.json,可复制并修改后以 "theme": "mytheme.json" 应用。
  • 图标生成与处理:gen_icons_cf.py 通过 Cloudflare Workers AI 生成图标,icon_cutout.py 进行边框泛洪抠图,glyphs.py 绘制符号类图标(关闭、对勾、心形、星形、锁、加、减、箭头),upload_icons.py 上传图标。
  • 校验脚本 verify_ui.py:检查布局重叠、兄弟元素间距、居中偏差、包裹框、文字适配以及多种视口下的触控尺寸;文字缩放过小会被判失败。

使用方式 示例规格 examples/coin_hud.json 可直接复制修改后构建:

python scripts/ui_build.py examples/coin_hud.json --out build # PNG + .model.json + Luau python scripts/verify_ui.py examples/coin_hud.json # layout, text fit, touch sizes

图标流程(需 CF_ACCOUNT_ID 与 CF_API_TOKEN):

python scripts/gen_icons_cf.py --manifest <your icons manifest>.json --out <project>/_cf_raw python scripts/icon_cutout.py --in <project>/_cf_raw --out <project>/icons --size 256 --sheet <project>/icons_sheet.png python scripts/glyphs.py --out <project>/icons --size 256 python scripts/upload_icons.py --icons <project>/icons --map <project>/icons.json

进入 Studio 时,把 Page.lua 粘贴到 execute_luau,再执行 capture_screenshot 截图检查;之后清理注入实例,避免已保存的场景留下偏差。图标需要真实资源 ID:to_instances 会输出 rbxassetid://ICON_<NAME> 占位符,需以 assetType Image 上传后替换,不能使用 Decal。响应式布局以参考分辨率用 offset 编排,再通过 CanvasFrame 上的 UIScale 按玩家视口缩放;触控目标按 44pt 在 640x360 手机上对应 1280x720 参考下的 88px 设计,ui_kit.TOUCH_H 为 88。

适用场景 适合需要批量维护多页面 UI(HUD、商店、背包、任务、设置)并希望在本地快速预览、校验后再进 Studio 截图的 Roblox 项目;也适合需要自绘图标集与符号集、避免依赖第三方图标包的场景。

限制与注意事项

  • 资料明确说明 Kaggle 通道已关闭,不得用于任何阶段;其条款只允许个人非商业的机器学习/数据科学用途,且作者账号因此被封禁。图标生成应使用 Cloudflare 路线;实测约每张 1024px 4 步图像消耗约 141 neurons,每日 10000 neurons 预算约合 70 张图,且该端点只接受 prompt 和 steps,不支持指定 width、height、seed。安全过滤器存在误报,需要改写提示词而非重试。
  • 符号图标为绘制而非生成,因为图像模型在几何符号上不稳定。
  • 同一棵树不能保证排列一致:阴影与 Face 作为兄弟节点会被 UIListLayout 单独分配单元格、装饰性 Frame 会抢占布局槽位、缺少 LayoutOrder 会导致网格顺序混乱、TextScaled 会不断缩小直到不可读。这些只能通过 Studio 实际渲染发现,建议至少渲染一页验证。
  • ClipsDescendants 不会裁剪旋转后的子节点,斜向装饰应改用 UIGradient 硬透明台阶实现。
  • 动态标签占位符必须使用实时代码不可能产生的哨兵值(如 <unbound>),并对其做门禁检查;--、0、... 或空字符串都会被误认为合理空值。
  • 云同步目录内不要整体替换目录,应逐文件复制,避免产生冲突副本。
  • 触控缩放不设下限,因为下限会导致页面在小屏上反而不适配;改为在源头保护触控尺寸。
  • 资料未提供价格、收费模式或其他平台支持信息。