UE5 Plugin Changelog

What's New

New Features

• Data-only sync support — when the StoryFlow Editor syncs with “Data Only” enabled, the plugin reuses previously imported assets from the Unreal project instead of requiring source files in the build directory, enabling fast script-only iteration without re-copying images and audio
• Added WBP_Dialogue_Portrait example widget with the character portrait displayed as a large image anchored to bottom center of the screen, separate from the dialogue panel
• Imported textures are now automatically configured for UI usage: UserInterface2D compression, no mipmaps, UI texture group, and sRGB enabled — prevents blurry images in UMG widgets

Bug Fixes

• Fixed PlayAudio not resolving audio assets from character or project resolved assets
• Fixed SetBackgroundImage not resolving image assets through evaluation chains
• Fixed SetCharacterVar with Image type not evaluating connected node chains for the value
• Fixed character images not resolving when referenced across script boundaries (e.g. via RunScript)
• Fixed media variable evaluation (GetImage, GetAudio) not checking all asset resolution sources
• Fixed RunScript output parameters not passing return values back to the calling script
• Fixed array Push, Pop, RemoveAt, and Insert operations not correctly modifying the source array
• Fixed execution tracing for cross-runtime debugging

Improvements

• Added execution trace logging ([SF-TRACE] prefix) for node processing, edge traversal, variable changes, and script calls — matches the trace format used by the Godot and Unity plugins for cross-runtime comparison

What's New

New Features

• Added typed character variable Blueprint functions (GetCharacterBoolVariable, SetCharacterBoolVariable, GetCharacterIntVariable, etc.) that accept a UStoryFlowCharacterAsset reference instead of a string path — enables native Unreal asset picker in Blueprint for selecting characters
• Character Name field now properly resolves through the string table, returning the localized display name instead of the raw string key

Bug Fixes

• Fixed all variable getter/setter Blueprint functions (GetBoolVariable, SetBoolVariable, GetIntVariable, etc.) failing with “Variable not found” warning when called outside of active dialogue (e.g., from BeginPlay) — global variables now fall back to the subsystem’s runtime state when the execution context isn’t initialized
• Fixed character variable access (GetCharacterVariable, SetCharacterVariable) also failing outside of active dialogue — same subsystem fallback applied
• Fixed GetLocalizedString not resolving string keys when called outside of active dialogue
• Fixed character variables being keyed by internal ID instead of display name in the importer, causing runtime lookups by name to fail
• Fixed GetCharacterVar nodes not working as array sources for forEach loops
• Fixed forEach loops not clearing boolean evaluation caches between iterations, causing stale results from previous iterations to carry over
• Fixed forEach loop context being pushed once at initialization instead of per-iteration, which broke nested loop tracking and the loop index
• Fixed defensive NodeId checks on loop stack pop operations to prevent popping the wrong loop context in nested forEach scenarios
• Fixed ProcessBooleanChain default case not clearing cached output before re-evaluation, causing stale boolean values when the same node was evaluated multiple times

Improvements

• Legacy character variable functions (GetCharacterVariable, SetCharacterVariable) moved to “Character (Legacy)” Blueprint category — still functional but new typed versions are recommended
• Updated example WBP_Dialogue widget to auto-advance dialogue after a short delay for narrative-only nodes

What's New

Bug Fixes

• Fixed text blocks in dialogue nodes ignoring their visibility conditions — text blocks with conditions were always shown regardless of whether their condition evaluated to true or false; they now use the same visibility evaluation as dialogue options

What's New

Bug Fixes

• Fixed connected node inputs not being found when evaluating data edges (e.g. a SET node receiving a value from a RANDOM or GET node) - the editor exports handles with numbered suffixes that the runtime now matches via prefix fallback

What's New

New Features

• 3D Audio Support: Optional bUse3DAudio toggle that switches dialogue audio from 2D to attached 3D sound on the owning actor, with DialogueAttenuation property for controlling falloff
• Overridable Audio Functions: PlayDialogueAudio and StopDialogueAudio are now BlueprintNativeEvent for custom audio system overrides
• Audio Advance-on-End: Dialogue nodes with audioAdvanceOnEnd auto-advance when audio finishes playing, with audioAllowSkip to let players skip early
• GetCharacterVar in Evaluators: GetCharacterVar nodes can now be evaluated in boolean, integer, float, and string contexts with dynamic character input resolution

What's New

Improvements

• Multi-Version Build System: New build script for compiling the plugin against UE 5.3, 5.4, 5.5, 5.6, and 5.7 in a single run
• Improved API Documentation: Updated variable API comments and type annotations to reflect the name-based lookup introduced in v1.0.2

Bug Fixes

• Fixed Build Script: Resolved issues with the automated build pipeline that could cause packaging failures on certain configurations
• Fixed Variable Lookup Edge Case: Corrected a rare issue where stale variable name indices could return incorrect values after rapid script switching

What's New

Improvements

• Name-Based Variable API: Get/Set variable functions on StoryFlowComponent, ProjectAsset, and ScriptAsset now accept variable display names instead of internal UUIDs, with O(1) name-to-ID index lookup

What's New

Improvements

• OnVariableChanged Delegate: Now passes the full FStoryFlowVariable struct instead of raw VariableId and FStoryFlowVariant, giving Blueprint users Variable.Name, Variable.Type, and Variable.Value from a single output pin

Bug Fixes

• Fixed Live Sync Crash: Assets are now updated in-place instead of deleted and recreated during sync, preventing UObjectArray refcount assertion crashes
• Fixed Concurrent Import: Added import guard to prevent overlapping imports from rapid WebSocket messages

What's New

New Features

• Full Runtime Engine: Complete execution engine with 200+ node types and O(1) edge lookups
• StoryFlow Component: Actor component for running dialogues with full Blueprint and C++ API
• Variable System: Boolean, integer, float, string, enum, image, audio, and character types
• Array Operations: Full array support with ForEach loops across all variable types
• Text Interpolation: Live variable interpolation with {varname} and {Character.Name} syntax
• RunScript Interface: Parameter passing, output extraction, and exit route routing for called scripts
• Random Branch Node: Weighted random path selection with dynamic integer weight evaluation
• Character System: Per-asset character DataAssets with GetCharacterVar/SetCharacterVar and built-in Name/Image fields
• Audio Playback: Dialogue audio with SoundClass, volume controls, loop, reset, and MP3-to-WAV auto-conversion
• Save & Load: Slot-based persistence for global variables, runtime characters, and once-only option tracking
• Click-to-Advance: AdvanceDialogue() for narrative dialogue nodes with no options
• Built-in Dialogue UI: Default widget with auto-fallback when no custom UI is assigned
• JSON Importer: Import preserving folder structure with Textures/Audio/Data asset organization
• Live Sync: WebSocket client with PIE-safe sync guard to prevent asset replacement crashes
• Toolbar Integration: StoryFlow toolbar in Blueprint, Widget, Animation BP, and Behavior Tree editors
• Localization: String variable values and inline strings resolved through string tables at runtime