NEW V 4.3 - Difficulty Settings
ACF difficulty scales GAS base attributes (Health, Damage, Defense, etc.) based on an active difficulty tag. The rules live in a DataTable, the active level lives on the GameState, and each character opts in individually.
Flow: Duplicate DifficultyConfig → assign in Project Settings → configure rows → enable on enemy Character Data Assets → set active difficulty at runtime
Never edit the sample DataTable directly. Duplicate
/AscentCombatFramework/Configuration/DifficultyConfiginto yourContent/YourGame/folder — sample assets are overwritten on every update.
Before you start
Three separate pieces — don't confuse them:
DifficultyConfig(DataTable) — the rules: for each difficulty tag, which attributes get multiplied and by how much. Edited in your duplicated copy.UACFDifficultyManagerComponent(GameState) — the active difficulty right now (CurrentDifficultyLevel). Already onAACFGameState. Replicated + SaveGame.PreferredDifficultyLevel(Game User Settings) — what the player picked in the options menu. Not wired automatically — you callSetDifficultyLevelfrom Blueprint when applying settings.
Difficulty only affects actors with bAffectedByDifficultyLevel = true on their Character Data Asset. Typically enemies and NPCs — not the player unless you explicitly enable it.
Built-in difficulty tags (registered at startup):
ACF.Difficulty.VeryEasy
ACF.Difficulty.Easy
ACF.Difficulty.Normal
ACF.Difficulty.Hard
ACF.Difficulty.VeryHardEach row in your DataTable uses one of these tags (or a custom tag under ACF.Difficulty).
Step 1 — Duplicate the DifficultyConfig DataTable
Content Browser →
/AscentCombatFramework/Configuration/DifficultyConfigDuplicate (Ctrl+D) → save as e.g.
Content/YourGame/Configuration/DifficultyConfigOpen your copy — the sample rows show how Easy/Hard/Normal scale attributes
Leave the original untouched.
Step 2 — Assign your copy in Project Settings
Edit → Project Settings → Plugins → Ascent GAS Settings → ACF|Difficulty
Set Difficulty Scaling Table → your duplicated DataTable (not the sample under /AscentCombatFramework/).
This is the global link — every difficulty lookup reads from here.
Step 3 — Configure difficulty rows
Open your DataTable. Each row is a FACFDifficultyScaling entry:
ACF|Difficulty
Difficulty Level — the tag, e.g.
ACF.Difficulty.HardAttribute Multipliers — list of
{ Attribute, Multiplier }pairsPick a GAS attribute (Health, MeleeDamage, Defense…)
Set the multiplier (e.g.
0.75on Easy,1.5on Hard)Attributes not listed keep multiplier 1.0
ACF|Difficulty|UI (for the settings menu)
UI Name — display name ("Normal", "Hard")
UI Description — subtitle text
UI Icon — optional texture
Example mental model for a Hard row:
ACF.Difficulty.Hard
Health → 1.3
MeleeDamage → 1.5
Defense → 1.2You can add custom difficulty tags under ACF.Difficulty in Project Settings → Gameplay Tags and create matching rows.
Step 4 — Enable difficulty on characters
Difficulty scaling is opt-in per character. On the Character Data Asset for each enemy (or NPC) you want scaled:
Set
bAffectedByDifficultyLevel = true(categoryACF|Attributes)
At spawn, this flag is copied to the pawn's UACFGASAttributesComponent. When difficulty is active, base attribute values from the character's DataTable / level curves are multiplied before being applied to the Ability System Component.
The player character usually stays false so difficulty only buffs/nerfs enemies.
Step 5 — Set the active difficulty at runtime
The Difficulty Manager on AACFGameState holds the current tag. Use AACFGameState as your GameState (it already has the component).
When to set it
New game start — set to Normal (or player's saved preference)
Options menu apply — read preference, call SetDifficultyLevel
Save game load — restored automatically (
SaveGameon the component); callBroadcastCurrentDifficulty()so existing pawns re-apply scaling
Blueprint API
Set Difficulty Level (WorldContext, NewDifficultyLevel) ← server only
Get Current Difficulty Level (WorldContext)
Get Difficulty Manager (WorldContext)Category: ACF|Difficulty on ACFRPGFunctionLibrary.
When difficulty changes, OnDifficultyChanged fires on the manager. All UACFGASAttributesComponent instances with bAffectedByDifficultyLevel automatically call RefreshDifficulty() and re-apply multipliers.
Default in editor
On the GameState Blueprint, you can set a default Current Difficulty Level on the Difficulty Manager component (e.g. ACF.Difficulty.Normal) for PIE testing.
Step 6 — Wire the options menu (optional)
The settings UI uses a separate preference stored in UAUTGameUserSettings:
Sample settings BP:
/Game/Integrations/UIIntegrations/ACF_GameSettings_BPGetPreferredDifficultyLevel/SetPreferredDifficultyLevelEvent:
OnDifficultyPreferenceChanged
C++ does not connect preference → active difficulty automatically. In your settings apply Blueprint:
Read
GetPreferredDifficultyLevelCall
Set Difficulty Levelon the serverSave Settingson user settings
UI helpers on ACFRPGFunctionLibrary (category ACF|Difficulty):
GetAllDifficultyTags/GetAllDifficultyDisplayNames— populate a difficulty selector from your DataTable rowsGetDifficultyDisplayName/GetDifficultyDescription— per-tag UI textDifficultyTagToIndex/DifficultyTagAtIndex— index ↔ tag conversion for widgets