Open #acf-ultimate-news on Discord and note the branch name for that release.
Open Content/FullSample/ in your git client (e.g. Fork).
Checkout that branch.
Pull.
Open the project in Unreal.
Run step 3 below (IV buttons).
The FullSample folder stays in place. Git only replaces the files inside it.
ACFJ: use the Easy way above. The ACFJ sample has no PRO git workflow.
Run this after every sample update (Git or zip):
In the editor toolbar, click IV.
Click Update To IV.
Click Update Project Settings.
This restores ACF Project Settings (GAS, UI, input, etc.) from the plugin defaults.
If you edited Config/ by hand, copy that folder somewhere safe first — Update Project Settings can overwrite your changes.
Sometimes a Blueprint shows a missing parent class after an update. ACF fixes most renames automatically via CoreRedirects — a list of old name → new name entries inside the plugin:
Plugins/ascentcombatframeworkUltimate/Config/DefaultAscentCombatFramework.ini
Unreal reads this file at startup and resolves old references for you.
If one Blueprint is still broken, fix it in three steps:
Step A — Find the names
Open the compile error. It shows the old class name (example: ACFNPCCharacterBP_C).
Search that name inside DefaultAscentCombatFramework.ini. You will find the matching new name (example: ACF_NPC_BP_C). The release notes on Discord list recent renames too.
Step B — Add a redirect to your project
Open Config/DefaultEngine.ini in your project. Add or extend the [CoreRedirects] section:
[CoreRedirects]
+ClassRedirects=(OldName="ACFNPCCharacterBP_C", NewName="ACF_NPC_BP_C")
+PackageRedirects=(OldName="/AscentCombatFramework/Blueprints/ACFNPCCharacterBP", NewName="/AscentCombatFramework/Integrations/Actors/ACF_NPC_BP")Use both lines when a Blueprint was renamed or moved.
Use only +ClassRedirects when a C++ class moved to another module (example: /Script/AscentCombatFramework.ACFProjectile → /Script/InventorySystem.ACFProjectile).
Use only +PackageRedirects when only the asset path changed.
Step C — Restart and compile
Save DefaultEngine.ini.
Restart the Unreal Editor.
Open the Blueprint and compile.
If it still fails: reparent the Blueprint to the new base class, or duplicate the updated sample preset into Content/YourGame/ and point your references to that copy.
Find a sample preset in the Content Browser.
Duplicate it (Ctrl+D) into Content/YourGame/.
Customize the copy.
Assign the copy in GameState, Project Settings, and levels.
For characters and interactables, prefer Create Child Blueprint Class from a sample base (ACF_NPC_BP, ACFMeleeEnemyBP, …) so you inherit fixes when the sample updates.
Remember to click on IV → Update to IV → Update Project Settings if also project settings needs to be restored
NOTE: If you are not using version control for your project ALWAYS make a backup before upgrading!
NOTE: If you are modifying directly the sample you can lose your modification while upgrading. Is always a good practice to make child blueprints and edit them instead of the sample itself. When this is not possible, you can try inheriting from the cpp/plugin parent of the same blueprint and reconfiguring it at your will / adding your logic there.
#acf-ultimate-newsThe plugin update does not touch your levels, Blueprints, or Content/YourGame/.
The sample is not part of the plugin. It lives on Git — zip download and git pull are the same repo, just different ways to update it.
Use the section that matches your project.
Back up your project (copy the folder).
Delete the old sample folders in Content/:
ACF / ACF Ultimate: FullSample
ACFJ: FullSample and TurnSample
Download the new version of the sample as a .zip from Git.
Extract it into Content/.
Rename folders if needed (FullSample-main → FullSample).
Open the project in Unreal.
Run step 3 below (IV buttons).
Assets you kept only inside the deleted sample folders are gone. Anything under Content/YourGame/ is safe.
Content/FullSample/ is a git repo in your projectACF / ACF Ultimate only. Your Content/FullSample/ folder is a git repo you pull from.