Godot UI 主题与样式
将以下提示词粘贴到你的 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 资源间切换图标纹理、而不手写逐按钮换图的关卡或品牌策划兼工程