One Core, Two Layers

Documentation Unreal Engine Combat Architecture

What every character shares in Universal Combat Framework, enemy or player: health, hits, defense, telegraphs, steering, animation windows and teams. And what the enemy layer and the player layer each add on top.


Every character, enemy or player, swings, lands a hit, defends and takes damage through the same systems. The enemy layer adds the AI that decides what an enemy does; the player layer adds the moves, items and camera a player controls.
A sword the player swings and a baton an enemy swings sweep the same way, are worth what their damage config says, and land through the struck character's defense and health. Set a system up once and it reads the same on both sides of a fight.

What every character shares

SystemWhat it gives a characterWhat you addPage
VitalsHealth, stamina, stance and any pool you name: spent, healed, refilled over time, drained, and read by a HUD.UCF Vitals componentVitals
Melee traceHit volumes swept across a window of the attack montage, so a fast swing misses nothing between frames.UCF Melee Trace Window on the montageMelee Trace and Damage
DamageWhat a hit is worth, what it is (its damage tags), and the effects it sets off, by surface.A Damage Config asset, an Impact Surface Set assetMelee Trace and Damage
DefenseParries, blocks, invulnerability and armor, each a rule that answers an incoming hit.UCF Defense component, a Defense Rule Set assetDefense
TelegraphsA warning over an attack's wind-up, before the blow lands.UCF Telegraph Window on the montageTelegraphs
Animation windowsGameplay tags held for a stretch of a montage, and footsteps, foley and other effects played from animation.UCF State Tag Window, UCF Anim Effect WindowAnimation Integration
Approach and warpAn attack that turns to its target, closes the gap and stops short of it.UCF Approach Window, UCF Skew Warp on the montageAnimation Integration
Physical reactionsBones that move under physics when a blow lands, and a ragdoll on death.UCF Physical Reaction componentPhysical Reactions
TeamsWho fights whom.UCF Team componentTargeting
Speed by tagA character slowed while a gameplay tag is on it.UCF Speed Modifier componentSprint and Speed

One fight, both sides

What the two layers share is what lets an enemy and a player fight each other with nothing to translate between them.
SharedWhat it means in a fight
One hit path both waysA parry rule on the player stops an enemy's swing, and an enemy's block stops the player's. Either way the damage comes off the struck character's UCF.Vital.Health.
One team checkEach character's UCF Team decides who is a foe. The player's targeting reads it through Target Teams, an enemy's target filter through the enemy's own team, so both sides agree.
One warning, two audiencesA UCF Telegraph Window on an attack's wind-up warns the enemies in front of it, whose reaction sets can parry or dodge, and puts a marker over the attacker for every player whose character carries a UCF Telegraph Viewer with a style set.
One set of tagsTags both layers use for one thing are one tag (UCF.State.Blocking, UCF.AnimEffect.Footstep), so a rule that checks for a blocking character, or an effect bank row for a footstep, works on every character.
Enemies the player can lock on toEvery enemy built on UCF Enemy Character Base is a target the player's lock-on can pick, and it drops out of targeting when it dies.
The seam goes one step further: an enemy's action set plays combos from the player's action graphs. See Action Graphs in Action Sets.

What the enemy layer adds

The AI that decides what an enemy does next.
SystemWhat it does
Action SystemScores every action an enemy could take and runs the best, with cooldowns, combos and a way to run each one (an ability, a Behavior Tree, or a combo from an action graph).
Reaction SystemAnswers a hit or a warning with a parry, a dodge or a counter.
Movement SystemCircles, holds its distance, strafes and keeps out of other enemies' way.
Combat Roles and Combat TokensSplits a group into attackers, flankers and waiters, and lets a crowd take turns.
Awareness System and Threat DetectionWhat an enemy has seen and heard, and whether the player's camera is on it.
Territory and PatrolsPatrol posts, wander areas and the leash that walks an enemy home.
StateTreeThe brain the decisions run in.

What the player layer adds

The moves, items and camera a player controls.
SystemWhat it does
Action GraphEvery move as a node, and every input that leads on from it as a transition.
InputKeys to input tags, chords, and abilities that answer a key.
Items, Equipment, Inventory and Quick BarItems that bring their own moves, drawn to a body place and put away, owned and slotted on a belt. Enemies hold the same items: see Enemy Weapons.
Combat StylesOne asset for a character's combat feel: rotation, targeting, reach, movement and camera.
Targeting and Attack SteeringThe enemy in front, lock-on, and attacks that steer at the target.
CameraA third-person camera framed by the style or the weapon in hand.
Interaction and Paired ActionsDoors, chests and racks, and two characters in one synced move, such as a finisher.
Hit ReactionsA flinch that cuts a character's attack, and hyper armor that carries a heavy swing on.
HUD and Input PromptsA HUD that follows the ability system, and prompts that show the bound key.
A character is not tied to its layer. An enemy carries the player layer's components: every demo enemy holds the player's items, flinches, falls limp and wears down poise the way the player does, the combo enemies play combos from their item's action graph, and the dual-sword boss carries the player layer's finisher stun. Getting Started shows each enemy's parts.