Godot 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 output directory instead of requiring source files in the build directory, enabling fast script-only iteration without re-copying images and audio
• Added StoryFlowDialogueUIPortrait scene — alternative dialogue UI with the character portrait rendered as a large image anchored to bottom center of the screen, separate from the dialogue panel. Portrait scales responsively with viewport height. Assign to dialogue_ui_scene on StoryFlowComponent to use it
• Portrait height ratio and bottom offset are exposed as @export properties for easy customization

Bug Fixes

• Fixed image import failing for files with mismatched extensions (e.g. PNG data saved as .jpg) — importer now detects actual format from file header magic bytes
• Fixed media assets (images, audio) not loading correctly during WebSocket sync when file paths contained subdirectories
• Fixed background image not persisting across dialogue nodes as expected
• Fixed PlayAudio not resolving audio assets from resolved asset sources
• Fixed RunScript output nodes not evaluating return values back to the calling script
• Fixed array Push, Pop, RemoveAt, and Insert operations not correctly modifying the source array
• Fixed script parameter passing not propagating values through RunScript node connections
• Fixed variable access (get_variable, set_variable) failing when called outside of active dialogue — global variables now fall back to the manager’s runtime state
• Fixed character variable lookup failing due to variables being keyed by internal ID instead of display name

What's New

Bug Fixes

• Fixed inline values on comparison and arithmetic nodes being ignored — nodes like >=, >, +, etc. silently read their inline values as 0 instead of the configured number, causing incorrect evaluation results (e.g. 0 >= 15 becoming 0 >= 0)
• Fixed character variable nodes (getCharacterVar) always returning empty values — the importer was keying variables by their internal ID instead of their human-readable name, causing lookup mismatches at runtime
• Fixed getCharacterVar nodes not working as array sources for forEach loops
• Fixed forEach loop context not persisting across iterations, causing variable state to reset each loop
• Fixed boolean evaluation caches not clearing between forEach iterations, leading to stale condition results
• Fixed character string keys not resolving through the global strings table
• Fixed editor dock settings (port, output directory, build directory) resetting to defaults on Godot editor reload — settings are now persisted via ConfigFile
• Fixed sync output directory not updating from the current field value on each sync

What's New

New Features

• Script Path Dropdown: The script_path property in the StoryFlowComponent inspector now shows a dropdown listing all imported scripts, replacing the plain text field — script paths are cached during import and WebSocket sync

Bug Fixes

• Fixed text blocks in dialogue nodes not appearing — visibility conditions were not being evaluated, and the built-in dialogue UI was not rendering text blocks at all

What's New

Bug Fixes

• Fixed string variables displaying raw localization keys instead of actual text in dialogue
• Fixed connected node inputs (e.g. SET receiving value from RANDOM) not being found due to handle suffix mismatch
• Fixed audio and image assets not loading at runtime when reimporting from the same directory

What's New

New Features

• Full Runtime Engine: Complete GDScript execution engine with 160+ node types
• StoryFlow Component: Node for running dialogues with typed signals
• StoryFlow Runtime: Autoload singleton for shared state management
• 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
• Script Execution: RunScript (call/return with parameters) and RunFlow (jump with exit flows)
• Character System: GetCharacterVar/SetCharacterVar with built-in Name and Image fields
• Audio Playback: Loop, reset, advance-on-end, and allow-skip support
• Background Images: Dynamic background image support with persistence and reset
• Save & Load: Slot-based persistence for global variables, characters, and once-only options
• Built-in Dialogue UI: Default dialogue UI scene with auto-fallback
• Editor Dock: StoryFlow dock panel with Live Sync and Import sections
• JSON Importer: Import StoryFlow Editor projects preserving build directory structure
• Live Sync: WebSocket client for real-time sync with StoryFlow Editor
• Toolbar Button: StoryFlow logo button with Connect/Sync toggle