> For the complete documentation index, see [llms.txt](https://visualonecompany.gitbook.io/storyframeworkdocs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://visualonecompany.gitbook.io/storyframeworkdocs/other-information/update-changelogs.md).

# Update Changelogs

List of changes made in each version update.

{% hint style="success" icon="signal-stream" %}
**Update 6**   <sup><sub><mark style="background-color:green;">Latest Public Version<mark style="background-color:green;"><sub></sup>&#x20;

* Complete Framework Rework.
* Added a large collection of new configurable options to the Framework Settings data asset.
* Overhauled Interaction System.
* Introduction of Quick Actions to execute completely bespoke behaviour without needing to manually create said logic within a blueprint graph.
* New Dialogue System and Editor to help making dialogue easier and faster.
* New Quest System and Editor to speed up the creation of large-scale quests that include objectives and objective groups.
* Added Quest Waypoints that ping the location of the next quest objective in the world.
* Reworked and added 2 new Skill Checks / QTE's (3 Unique QTE's Total)
* Reworked Interaction System that executes interactions completely independent to one another.
* Interactables can now optionally require "Hold Key to Interact" and can be assigned completely unique interaction distances.
* Added new Focus Points which can be added to an actor to act as a second layer of interaction for any form of inspection interaction.
* Modularized interaction prompt widgets and dialogue reply widgets.
* Modularized the settings menu with a workflow to create custom settings menu options.
* Restructured all inventories to be more grid-based, supporting things like storage containers.
* Reworked the Quick-Inventory into the Quick-Access inventory (A more intuitive and organized "Quick-Inventory").
* Completely Overhauled Save System, including custom workflows to integrate custom saved variables at different periods throughout a runtime instance (determining whether data is saved / accessed during gameplay only, or persists / can be accessed throughout the entire play session).
* Configurable amount of Save Slots.
* Added a new Subtitle Creator editor tool within the dialogue graph to streamline adding subtitles to existing sound assets.&#x20;
* Refactored Journal System that supports custom widget interactions on pages
* Added a new "Codex" system to track story progression.
* Most systems tie together using the new Story Tags.
* Expanded SF's collection of trigger volumes.
* Added "Story World Effectors" that enable specific actor attributes to be managed through specific conditions without needing to manually set up within a blueprint graph.
* Added new custom sequencer tracks for sequencer to quickly create things like subtitled sounds or QTE's during a sequence.
* Added a new lightweight camera preset system to easily create custom camera angles that can be changed to and from during gameplay.
* Added new Scripted Actor & Asset Actions.
  {% endhint %}

{% hint style="info" %}
**Update 5.2**

[**5.1 to 5.2 Upgrade Guide**](https://youtu.be/r2PtnI4wajY)

* New "Animation Inspection" mode has been added to the list of possible inspection modes that interactables can use. Found out more [**here**](https://youtu.be/cCyeP-NeUt8).
* The inspection & subtitle widgets have received UI layout improvements for better legibility.
* A few more QoL configurable values for dialogue and camera control have been added to the `StoryFrameworkValues` data asset (SF's configuration section), and a value to control input strength when using `CustomViewInteractArea` actors.
* New interaction demonstrations have been added to SF's Example Map.
* Fixed an issue with `CustomViewInteractArea` blueprints that soft-locked the player inside of said custom view when spam entering/exiting these custom view actors.
* Added the `CameraShakeModifier` to SF's camera manager, allowing for the use of Legacy Camera Shakes.
* Added a "Data Tables" section to SF's quick-nav editor drop-down.
* Added more functions for controlling player `ConsequentialTags` more easily.

<sub>February 3rd 2026</sub>
{% endhint %}

{% hint style="info" %}
**Update 5.1**

[**5.0 to 5.1 Upgrade Guide**](https://youtu.be/jw0J19qCARU?si=8nwplkw129PQvGzA)

* Using the "Edit Target Task" function will now correctly update the tasks "tracked" state if it is the one currently tracked.
* SF's "Menu" system has been moderately modified to be easier to work with.
* New "Play Sound Attached With Subtitles" event added to the Sequence Manager, useful for adding dialogue to moving characters specifically (SF dialogue now uses this by default).
* Subtitles and subtitled sounds now correctly pause when the game is paused.
* Playing NPC grunts are now more dynamic. Multiple grunts from the same NPC can be used when needed.
* NPC camera components can now be specific to certain replies chosen by the player, which means more customizability over which shots to use when using the "Actor Camera" camera mode for NPC's.
* The 3D Inspect scene capture component has been tweaked to drastically improve it's performance. This has always been SF's biggest hurdle in terms of performance of a flagship system. I feel these new settings yield close to the best performance we can get out of a render target for this specific use-case.
* Story Choice options can no longer be selected multiple times. This was more a visual bug than anything else.
* Using dialogue nodes in the "Dialogue Graph Actor" is no longer limited to the level you're inside of. Changes to the "Get NPC" and "Apply Dialogue" nodes allow for continuation of dialogue even if an NPC is not found/valid.
* NPC reply actions applied through the use of dialogue nodes in the "Dialogue Graph Actor" have been slightly tweaked to automatically re-order these actions at runtime, and applying actions that should only be called at the end of an NPC's setup automatically at the end of an NPC's list of dialogue actions. This removes the need to manually re-order nodes in the "Dialogue Graph Actor".
* A "Settings" menu has been integrated into the pause menu (at long last).
* Added a new "Edit Journal Entry" overlap/trigger actor for parity in regards to trigger actors for all other larger flagship systems.
* SFV (Story Framework Values/SF's settings) has been moved to the "SFGameInstance\_BP" class for more reliable accessibility of data. This means data inside of that settings data asset is not dependent on the player controller existing/being valid.
* Added a new "InventoryIndicator\_W" to visually communicate information about the players inventory during gameplay.
* Fixed a bug that would occasionally allow the "AutoSave" feature to attempt to save data when the player returns back to the Main Menu.
* UE 5.7 support.

<sub>November 20th 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 5**

* Reworked Tasks into "Main" & "Optional" tasks.
* Menu's have been reworked to be added into a singular navigable menu (Unified Menu Container)
* Added a new Data Asset that contains a large collection of SF customization (SFV).
* New "Play Sound" framework (Play Sound From SFV).
* Complete NPC Overhaul
* More Trigger Volumes
* Fixed an issue with Custom View Interact Area rotations
* Expanded item customization through the "MoreItemOptions" data table.
* Improved memory usage when initially inspecting objects.
* Improved memory usage when handling inventory items.
* "Object Name" in interaction data has been converted to a "Text" variable for localization support.
* Major save variables now support saving/loading between multiple levels respectively.
* Added a few new functions to SF's function libraries.
* Subtitles now automatically adjust their vertical position relative to the current view targets aspect ratio.
* Added a new "SaveActorTags" function to save any actors tags and re-apply them on load.
* Large number of assets in the "Story Framework" folder have been assigned specific icons to further distinguish them from one-another.

<sub>September 11th 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 4.1**

* Added a new ["Story Choice"](https://visualonecompany.gitbook.io/storyframeworkdocs/core-components/cinematic-tooling/subtitled-sounds.md) system.
* Fixed in issue that occasionally caused QTE's to execute dispatched events from previously created QTE's
* The "SoftLocked" & "IgnoreOutline" tags no also support the hit component from the interaction trace, meaning components inside of a blueprint can avoid interaction.
* Fixed up a few timers that continued to execute after the function that they're updating is not used. Now they will be correctly stopped when not in use.
* Dropping items have been slightly changed to now spawn the dropped item at the location of the players crosshair if the player is looking at a location within the interaction range. If not, then items will be spawned on the floor as before.
* Fixed "InspectActorDistanceFromCamera" value not updating interactables correctly from within the SF editor utility tool.
* Resolved a small bug that was allowing players to "page" while inspecting an item instead of reading through a page.
* Subtitle text now supports multi-line text, allowing for a singular subtitle longer in length to wrap correctly.
* Fixed a bug allowing players to reset their dialogue reply timers by spamming the "skip dialogue" key.
* Added a new "Cinema Crop" widget and function to quickly crop your players screen with the use of black bars.
* Fixed an issue allowing players to use inventory features when the inventory is not open, or when they are not marked with the corresponding condition inside the inventory settings of the selected item.
* Added new "Tutorial Popup" and "Create Subtitles" area blueprints.
* Items that have "CanPickupFromInspect" set to true, will now correctly assign this value to the item when it is dropped. Before, this value would get removed if an item gets picked up.
* Added options to adjust Z-Order when calling the "WidgetFadeCamera" function to allow the overlaying of subtitles or other widgets on-top of this fade.
* Fixed a small timing issue with the "Custom View" fixed camera areas.

<sub>July 3rd 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 4**

* New "Drag" Interaction Method (with options to define movement/rotation distance values and clamps, and camera focus mode).
* New "Memoir" menu (a method for the player to track and view their previous decisions, or game events that happened throughout their story).
* A boolean variable inside the "Inspect Method Settings" can now be ticked to allow the player to pick up an item while they're inspecting it.
* New "FormatStringToVector" function
* New "FormatStringToRotator" function
* Added a new "SaveAfterCompleted" boolean to the sequence manager to save any sequence that has been played.  \
  If a sequence has been saved, then it will not play again when trying to trigger that same sequence. Useful for Intro/Outro sequences.
* Added a camera head bob "Camera Shake" example to the player controller. Demonstrating how a simple head bob can ground your  \
  player further.
* Refined interaction prompts for better visibility, and customizablity.
* Improvements to player inventory. Items can now be "used", and "combined" with other items.
* Improvements to NPC dialogue (A custom amount of replies can now be set instead of a default of 2, and the "leave" option. Replies can be given a "Reply Timer" with a custom reply set when that timer finishes)
* New "Perform Action" system to further pace gameplay.
* Widget Popups no longer overlap previous popup instances if they are displayed immediately after one another. Instead, any previous popups that are created will be removed when creating a new one.
* Interactables that use the "Readable" inspect method, now have the option to use an image on a page, and define text color.
* Interactables now include an editor billboard component to represent where their interaction prompts will be positioned in-game.
* Readable text pages now have the option to change its text color.
* Reworked SF's camera system to use a more traditional camera comonent workflow, instead of camera transform driven through a custom player camera manager class.
* Added a new "CustomViewInteractableArea" interactable base class, which can be used to setup an area with a custom camera view and interactables.
* Giving any interactable the tag "SoftLocked", will stop the player from being able to interact with it (used in the "CustomViewInteractableArea" example to only allow the player to interact with certain items only if they are in this "area").
* Giving any interactable the tag "IgnoreOutlines" will stop that interactable from displaying an outline around itself when the player is able to interact with it.
* The "InputKey\_W" widget blueprint now utilizes a separate "Input Mapping" data table to get its data from for displaying specific icons, text, or backgrounds depending on the target key. Removing the need to set the data for every instance of the widget that's used, and opens up the possibilty for player mappable keys in the future (This is the widget that gets used wherever you see an input prompt on screen).

<sub>April 21st 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 3.1**

* &#x20;**Has Item** interaction method overhaul
* Fixed a menu layering issue
* Added a new **DoItemsArrayExistInInventory** function, and an **OnTaskInitialize**d event dispatcher inside the inventory manager
* Fixed inconsistencies presented by subtitles, and subtitle names
* Fixed the **Inspect Actor Offset** value to correctly offset the mesh from its pivot.
* Improved Inspect actor lighting

<sub>February 23rd 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 3**

* Added a new Objective/Task Framework to the Interaction Manager with functions to Add, Edit, Remove, & Hide tasks.
* Added Skeletal Mesh support for "Interactables" and actors that can be inspected/picked up.
* Added subtitle headers/names above the original subtitle text.
* Outline shader no longer renders through meshes, and now supports occlusion.
* Slightly tweaked the interaction trace to remedy a few interaction issues, as well as the interaction prompt.
* Changed gamepad detection to not be dependent on the player camera manager class.
* Added support for saving/loading the last level that the player was in out-of-the-box, removing the need to set this up manually.
* Widget prompt animation examples.
* Slight tweaks to the "Skip Subtitle Segment" functionality.
* Adding the tag "IgnorePromptTrace" to any actor will now force the interaction occlusion to ignore geometry/line of sight.
* Added a "Return Value" output pin to the **ConvertInteractableActorIntoStaticMesh** function.
* The **SaveSpawnedActor(Save Game)** function now also saves/loads actor tags.
* Added a new "Door" demonstration prop.

<sub>February 1st 2025</sub>
{% endhint %}

{% hint style="info" %}
**Update 2**

* Added customizable Quick Time Events utilizing a "CreateQuickTimeEvent" function.
* Added support for true first person using the SFCameraManager.
* Added a new section to Example Map demonstrating the use of Quick Time Events inside sequences.
* Added per-instance custom collision radius to interactable actors and items.
* Added a collection of new Event Dispatchers for easier communication between SF Actor Components.
* Fixed issues being produced when inside "simulate" play mode
* Added the ability to skip dialogue subtitle and voice line segments.
* Removed unused blueprint sections.
* Relocated some functionality to better and more respective blueprints.

<sub>November 3rd 2024</sub>
{% endhint %}

{% hint style="info" %}
**Update 1.2**

* Added a new area to the demo level that further demonstrates using some of the story-related features inside Story Framework in conjunction with one another.
* Added support for playing sequences and inspecting actors at the same time. For instance, if you're using a sequence object actor, if a sequence is selected, and an inspect method is chosen, the player will inspect the actor after the sequence is completed or stopped.
* Added a new section to the "SFTools" editor utility widget for editing actors inside the level.
* Added a new Story Framework specific function to the Interaction Manager,\
  Spawn Interactable Saved.\
  Spawns an interactable actor class, updates its interaction data, and saves it immediately to the "SpawnedActors" list. (This eliminates the need to go through the process of first spawning an interactable actor, then setting its interaction data, and finally saving it the the Save Game)
* Added a new custom popup widget that can be configured with your own information.
* Fixed a minor inspect actor value that wasn't updating correctly.
* Added a small page indicator on the readable UI overlay indicating what page the player is on, and how many pages there are to read.

<sub>September 13th 2024</sub>
{% endhint %}

{% hint style="info" %}
**Update 1.1**

* Added a new "EditItemInInventoryByName" function to the Inventory Manager for more customizablity at runtime.
* Added a new "ResetSFCameraStates" function inside the gameplay function library.
* Removed excess blueprints that are not used
* Fixed an issue with the camera when saving and loading while talking to an NPC.
* Added the option to opt out of using custom the "fixed" camera preset for NPC dialog.
* Reworked NPC Interaction to allow for further branching in dialog.

\--- NPC's now use Dialog Sets (array of dialog options instead of a singular option)

\--- Introduction of "ConsequentialTags" that can be accessed by any NPC to alter their dialog with the player. These tags are used to select Dialog Sets when initiating conversation.

\--- Added the ability to use the players camera while talking to an NPC instead of forced camera "cutscenes."

\--- Added the option to "AllowPlayerMovement" when initiating conversation with an NPC.

* Polished and Refined the Auto Depth of Field on the Camera Manager
* Added functionality to occlude interaction prompt widgets when they are not in the players line of sight. (behind a wall, etc.)
* Adjusted lighting on objects when they are being inspected.
* Added a new trace condition for interaction (If using WidgetMenu\_IMC)
* Added a new "LoadSFComponents (IntoMemory)" function to help optimize initial playthrough hitches when interacting with items for the first time.

<sub>August 9th 2024</sub>
{% endhint %}

{% hint style="info" %}
**Release Version**

* Fixed a warning message being produced by an invalid array index inside the Camera Manager actor component.
* Fixed an oversight during development that spawns an actor at world origin on begin play.

<sub>July 2024</sub>
{% endhint %}
