Agent Skills
返回列表
🎨

Godot UI 主题与样式

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-ui-theming。

技能介绍

你要解决什么问题

Godot 游戏里 HUD、菜单和对话框往往共用一套 Theme,但一上运行时换肤、危险按钮变体或自定义 _draw() 读色,就容易掉进几类坑:StyleBox 在 _draw() 里当局部变量被 GC、add_theme_override 和根节点 Theme 互相打架、焦点样式用 StyleBoxEmpty 却没人看得见——手柄导航直接废掉。资料里没有「主题包一键美化」这种说法,核心是资源继承、变体、运行时安全改写三条线要对齐。

技能如何组织能力

技能把工程拆成可对照的 GDScript 范例与决策表:

  • 全局与运行时:global_theme_manager.gd、ui_scale_manager.gd、theme_swapper.gd 负责根节点换 Theme、DPI/分辨率缩放与明暗模式级联。
  • 局部样式不 duplication 场景:用 theme_type_variation(见 danger_button_assignment.gd)做 Danger/Ghost 等语义样式,而不是复制 Button 场景。
  • 可变 tint:dynamic_stylebox_color.gd 强调先 duplicate() 再改色,共享 Theme 里的 StyleBox 保持不可变。
  • 生成 UI / 自绘:procedural_theme_safe.gd、custom_chart_drawing.gd、memory_safe_custom_drawing.gd 处理 NOTIFICATION_THEME_CHANGED 与类级缓存,避免 RenderingServer 还没画完样式就没了。
  • 无障碍与方向:focus_prompt_icon_swapper.gd(手柄/键盘提示图标与焦点高亮)、rtl_theme_mirroring.gd(RTL/LTR 变体切换)。

文档里的 Decision Tree — Theme Ownership 也帮你定边界:全项目外观走 Project Settings → GUI → Theme;单控件差异用 add_theme_*_override;子类型用 variation;运行时不污染共享资源则 duplicate StyleBox。

适用边界与注意点

技能面向已在用 Godot Control/Theme 的 UI 工程,不是从零教 Theme Editor 点按。NEVER 清单很硬:别在 _ready() 里给大量节点 StyleBoxFlat.new()、别在 _process()/_draw() 里改 Theme 资源、别用 expand_margin_* 当点击区域、主题属性必须用 add_theme_color_override 等专用 API。想搭季节性图标库或高对比度根主题,应对照 Expert Theming Patterns 里的 Shared Palette、RTL 镜像与 Atlas 压缩策略,并串上列出的 prerequisite/complement 技能(容器布局、Autoload 归属等)。

使用场景

  • 准备上线手柄版前,需要按焦点节点切换键盘/手柄提示图标并保留可见焦点高亮
  • 夜间模式要在不遍历每个 Control 的前提下,从根节点切换整套 Theme 并同步自定义 _draw 图表配色
  • 危险操作用红色语义按钮,希望在同一 Theme 里用 theme_type_variation 而不是复制 Button 场景
  • 阿语或希伯来语界面需要随布局方向在 RTL/LTR 间切换 StyleBox 与变体资源库

适合人员

  • 负责 Godot 项目默认 GUI Theme 与多分辨率 HUD,要在导出前统一 DPI 与 content_scale_factor 的客户端工程师
  • 做无障碍合规时,要修手柄焦点不可见、焦点样式为空导致导航失效的 Godot UI 程序员
  • 视觉小说/菜单密集型项目里,用 RichText 与自定义 Control 自绘,且颜色必须跟 Theme 调色板一致的玩法/UI 开发者
  • 节日活动 UI 需在 halloween/christmas 等 Theme 资源间切换图标纹理、而不手写逐按钮换图的关卡或品牌策划兼工程