Godot Ui Theming

• establishing a shared UI look
• supporting theme variants
• replacing ad hoc per-node overrides
• working with fonts, styleboxes, and reusable color choices

Never Do

• Never create duplicate StyleBox instances per node when the style belongs in a shared theme.
• Never break inheritance accidentally by assigning themes at the wrong level.
• Never hardcode colors everywhere when the theme should own them.
• Never use per-node theme overrides for a style that is meant to be global.
• Never churn theme changes every frame.

Basic Workflow

1. Open Project Settings -> GUI -> Theme.
2. Create a Theme resource.
3. Assign it at the appropriate root Control.
4. Let child controls inherit unless a local override is intentional.

StyleBox Pattern

var style := StyleBoxFlat.new()
style.bg_color = Color.DARK_BLUE
style.corner_radius_all = 5

$Button.add_theme_stylebox_override("normal", style)

Prefer storing shared versions of this in a Theme resource instead of rebuilding them repeatedly.

Font Loading

var font := load("res://fonts/my_font.ttf")
$Label.add_theme_font_override("font", font)
$Label.add_theme_font_size_override("font_size", 24)

Theme Ownership Guidance

• Put global style rules in the shared Theme.
• Use local overrides only for one-off exceptions.
• Keep semantic colors and font choices centralized.

Reference

• Godot Docs: GUI Theming

Related

• godot-task
• godot-master