BlueprintGraphThemeSelector DOC

Blueprint Graph Theme Selector Documentation
Version: 3.0.0
Unreal Engine: 5.7 and 5.8
Platform: Windows / Win64 Editor
Publisher: CelestiaDominance

OVERVIEW

Blueprint Graph Theme Selector changes the graph appearance through Project Settings. Choose a preset, customize node title and pin/wire colors, adjust wire thickness, or use a local image behind the graph.

The plugin contains one Editor module, two production C++ classes, and no Blueprint assets. It has no runtime gameplay module.

CONFIGURATION

Open Project Settings > Plugins > Blueprint Graph Theme Selector.

Keep Enable Theme checked to preview your chosen appearance. Select a preset and adjust the relevant controls. Changes apply to the editor immediately. Settings are saved per user and project.

THEME CONTROLS

Enable Theme
Turns the theme on or restores the underlying editor appearance. Turning it off retains the selected preset, colors, and image settings for later use.

Theme Preset
- Default (UE Style): restores the underlying node title colors, pin/wire colors, and wire thicknesses. Background controls remain independent.
- Dark: dark node titles with blue pin/wire colors.
- Low Opacity: muted title and pin/wire colors using Low Opacity Amount.
- Light: light node titles with blue pin/wire colors.
- Neon: dark purple node titles with bright green/cyan pin/wire colors.
- Custom: exposes your own color and thickness controls.

Low Opacity Amount
Visible for the Low Opacity preset. Range: 0.02 to 1.0. This sets alpha on the configured title and pin/wire colors; it does not make every part of a node uniformly transparent.

Custom Node Title Color
Visible in Custom mode. Changes the title colors exposed by Unreal's graph settings, including common event, function, flow-control, comment, and preview title colors. Individual node widgets may retain their own body, text, or specialized styling.

Custom Wire Color
Visible in Custom mode. Changes the pin-type colors used by standard graph connections, including real/double and soft object/class references, plus execution trace colors. Graph schemas that provide their own styling may behave differently.

Custom Wire Thickness
Visible in Custom mode. Range: 0.5 to 4.0. Execution wires use the selected thickness; data wires use 90 percent of that value.

GRAPH BACKGROUND CONTROLS

Use Custom Background Image
Uses the selected image when Enable Theme is on and the file loads successfully. Turning this off restores the underlying editor background and grid preference.

Background Image Path
Select a local PNG, JPG, JPEG, BMP, or TGA file using the ... button, or enter a path manually. The picker saves images inside the project relative to the project directory; images outside the project use an absolute path. Manual absolute and project-relative paths are supported. Previously saved picker paths containing ../ segments also load when the referenced file is available.

Example relative path: EditorImages/GraphBackground.png

For portability, keep the file at the same relative location when moving the project. The plugin references the external file; it does not import it as an asset or bundle it into packaged games.

Image limits:
- Maximum file size: 64 MiB (67,108,864 bytes).
- Maximum width or height: 8192 pixels.
- Maximum total pixels: 16,777,216. For example, 4096 x 4096 or 8192 x 2048.

Invalid, inaccessible, empty, unsupported, or oversized files fall back to the underlying editor background. Check Background Image Status for the reason.

Background Image Opacity
Range: 0.0 to 1.0. Changes the image tint alpha without importing the file again. Zero makes the image transparent; grid hiding still follows its checkbox while a valid custom image is active.

Background Image Movement Mode
- Static (Screen Space): stretches the image across the graph viewport. Different viewport proportions can stretch its aspect ratio.
- Tiled (Screen Space): repeats the image using its native size in Slate layout units.

Both modes remain fixed to the viewport during graph panning and zooming. Tiled mode was previously labeled Follow Graph (Tiled). Existing saved selections remain compatible; the new name describes the existing behavior accurately.

Hide Grid When Using Custom Background
Hides grid lines while a valid custom image is active. When unchecked, the underlying editor grid preference applies. A missing or rejected image restores the original background and grid preference together.

Background Image Status
Displays the result of the latest background update, including a reason when the file cannot be used.

IMAGE RELOADING

The loaded texture is reused when you change colors, opacity, movement mode, or grid visibility. File size and modification time are checked when settings are applied.

After editing an image outside Unreal, change a theme/background setting to check the file again. To force a fresh load, turn Use Custom Background Image off and on. There is no automatic file watcher.

RESTORING YOUR EDITOR APPEARANCE

Choose Default to restore node and wire styling. Turn off Enable Theme to restore the background and grid as well. The plugin also restores its captured appearance during orderly engine shutdown or module unloading.

The baseline comes from the editor preferences present when the theme is first applied. Changes made through other editor settings while the plugin is active are retained when they differ from the plugin's last applied values.

Applying a theme does not save the temporary background texture or preview colors into Unreal's editor preference sections. The plugin saves its own theme choices separately in the per-project user settings.

Default is not a factory reset. If an older release already saved unwanted preferences, turn off Enable Theme and correct those preferences in the editor before turning the theme on again.

TROUBLESHOOTING

The appearance does not change:
Check Enable Theme, then select a preset other than Default. Custom controls apply in Custom mode. Some specialized graph nodes or graph schemas draw their own colors rather than using Unreal's shared graph settings.

The background is missing:
Read Background Image Status. Confirm the path, supported format, file access, and image limits. Use the ... button to select the file again if it has moved. Manual relative paths start at the project directory. Try exporting the image as a standard PNG if its encoding is rejected.

The background looks stretched:
Static mode fills the viewport. Select Tiled (Screen Space) for repetition at native layout size.

The image does not move with the graph:
Both modes are intentionally fixed in screen space. Tiled mode repeats the image; it does not follow graph coordinates.

Grid lines are still visible:
Check Hide Grid When Using Custom Background and confirm that a valid image is loaded. If loading fails, the underlying editor grid preference is restored.

My replacement image has not appeared:
Turn Use Custom Background Image off and on to clear the cached texture, particularly if a file-copy operation preserved the previous file size and timestamp.

SUPPORT AND LINKS

Video: https://youtu.be/UTNzbhLN-78
Support: https://discord.gg/9Zc4wbwqG9