# Universal Combat Framework: Player Combat and Enemy AI for Unreal Engine 5

> Enemy AI and player combat for Unreal Engine 5.6 to 5.8 in one plugin: enemies that score their moves, hold their distance and take turns, players with combos, items, lock-on and finishers, one hit and defense system for both, and enemies that fight with the player's action graphs.

Markdown version of https://rigbak.com/docs/UniversalCombatFrameworkDocs, a page of the Universal Combat Framework documentation. Link that page when citing it.

Enemy AI and player combat for Unreal Engine 5.6 to 5.8 in one plugin. Enemies pick their moves by score, circle and hold their distance, react to what the player does and take turns as a group. Players fight with combos built as action graphs, draw items that bring their own moves, lock on, parry and finish an enemy with a paired move. Both sides swing, land hits and defend through the same systems, and an enemy can fight with a combo from an action graph, the way a player's presses walk it. You set everything up in Blueprints and data assets, and it runs in single player, on a listen server and on a dedicated server.

Already own Soulslike Enemy Combat or Universal Player Combat? Buy the other at any time, verify both purchases on the Rigbak Discord, and claim Universal Combat Framework there. [Upgrade and Access](https://rigbak.com/docs/universal-combat-framework/upgrade-and-access) says how. A project built on either moves across with its assets and settings: see [Switching to Universal Combat Framework](https://rigbak.com/docs/universal-combat-framework/switching-to-ucf).

New here? [Getting Started](https://rigbak.com/docs/universal-combat-framework/getting-started) opens the demo, where the player fights enemies on the enemy AI, some of them playing combos from an action graph, and executes a boss, then points you at the first page of each layer.

Building with an AI agent such as Claude Code, Codex or Cursor? The [AI Agent Guide](https://rigbak.com/docs/universal-combat-framework/agents) hands it the plugin's guide, so it builds a player and enemies from your own meshes and animations in your open editor.

## How it fits together

The **enemy layer** decides what an enemy does, the **player layer** gives a player the moves, items and camera they control, and the **core** under both is how every character swings, hits, defends and takes a hit. **The seam** joins the two layers: an enemy's action set can play a combo from an action graph.

Enemy layer

The AI that decides what an enemy does next.

- [Action Sets](https://rigbak.com/docs/universal-combat-framework/enemy/action-system)
- [Reaction Sets](https://rigbak.com/docs/universal-combat-framework/enemy/reaction-system)
- [Movement](https://rigbak.com/docs/universal-combat-framework/enemy/movement-system)
- [Combat Roles](https://rigbak.com/docs/universal-combat-framework/enemy/combat-roles)
- [Combat Tokens](https://rigbak.com/docs/universal-combat-framework/enemy/combat-tokens)
- [Awareness](https://rigbak.com/docs/universal-combat-framework/enemy/awareness-system)
- [Threat Detection](https://rigbak.com/docs/universal-combat-framework/enemy/threat-detection)
- [Targeting](https://rigbak.com/docs/universal-combat-framework/enemy/targeting-system)
- [Territory and Patrols](https://rigbak.com/docs/universal-combat-framework/enemy/territory)
- [StateTree](https://rigbak.com/docs/universal-combat-framework/enemy/statetree)
- [Weapons](https://rigbak.com/docs/universal-combat-framework/enemy-weapons)

The seam

Enemies that fight with the player's moves.

- [Action Graphs in Action Sets](https://rigbak.com/docs/universal-combat-framework/action-graphs-in-action-sets)
- [Sequences and Random Options](https://rigbak.com/docs/universal-combat-framework/sequences-and-random-options)
- [Seam Patterns](https://rigbak.com/docs/universal-combat-framework/seam-patterns)

Player layer

The moves, items and camera a player controls.

- [Action Graph](https://rigbak.com/docs/universal-combat-framework/player/action-graph)
- [Input](https://rigbak.com/docs/universal-combat-framework/player/input)
- [Items](https://rigbak.com/docs/universal-combat-framework/player/items)
- [Equipment](https://rigbak.com/docs/universal-combat-framework/player/equipment)
- [Quick Bar](https://rigbak.com/docs/universal-combat-framework/player/quick-bar)
- [Combat Styles](https://rigbak.com/docs/universal-combat-framework/player/combat-styles)
- [Targeting](https://rigbak.com/docs/universal-combat-framework/player/targeting)
- [Attack Steering](https://rigbak.com/docs/universal-combat-framework/player/attack-steering)
- [Camera](https://rigbak.com/docs/universal-combat-framework/player/camera)
- [Interaction](https://rigbak.com/docs/universal-combat-framework/player/interaction)
- [Paired Actions](https://rigbak.com/docs/universal-combat-framework/player/paired-actions)
- [HUD and Input Prompts](https://rigbak.com/docs/universal-combat-framework/player/hud-and-input-prompts)

Core

One way to swing, hit, defend and take a hit, for every character.

- [Vitals](https://rigbak.com/docs/universal-combat-framework/vitals)
- [Melee Trace and Damage](https://rigbak.com/docs/universal-combat-framework/melee-trace-and-damage)
- [Defense](https://rigbak.com/docs/universal-combat-framework/defense)
- [Telegraphs](https://rigbak.com/docs/universal-combat-framework/telegraphs)
- [Animation Integration](https://rigbak.com/docs/universal-combat-framework/animation-integration)
- [Physical Reactions](https://rigbak.com/docs/universal-combat-framework/physical-reactions)

Each name opens its page.

---

## Start here

- [Getting Started](https://rigbak.com/docs/universal-combat-framework/getting-started): Turn the plugin on, fight the demo's enemies and its boss, and pick the layer to read first.
- [Switching to UCF](https://rigbak.com/docs/universal-combat-framework/switching-to-ucf): Move a project built on the standalones across, with its assets, settings and names.
- [One Core, Two Layers](https://rigbak.com/docs/universal-combat-framework/one-core): What every character shares, enemy or player, and what each layer adds on top.

---

## The seam

- [Enemy Weapons](https://rigbak.com/docs/universal-combat-framework/enemy-weapons): An enemy holding the player's items: what it starts with, its moves for each item and role, and what it drops.
- [Action Graphs in Action Sets](https://rigbak.com/docs/universal-combat-framework/action-graphs-in-action-sets): An enemy action that plays a combo from an action graph, with weighted variants for the enemy to pick from.
- [Sequences and Random Options](https://rigbak.com/docs/universal-combat-framework/sequences-and-random-options): Abilities, Behavior Trees and graph combos run in order as one action, or one of them picked at random.
- [Seam Patterns](https://rigbak.com/docs/universal-combat-framework/seam-patterns): An enemy using the player's moves, one hit path both ways, and a reaction cutting a combo.

---

## Core

- [Vitals](https://rigbak.com/docs/universal-combat-framework/vitals): Health, stamina and any pool you name: spent by moves, drained over time and read by a HUD.
- [Defense](https://rigbak.com/docs/universal-combat-framework/defense): Parries, blocks, invulnerability and armor, for an enemy and a player alike.
- [Melee Trace and Damage](https://rigbak.com/docs/universal-combat-framework/melee-trace-and-damage): Hit volumes swept across an attack window, what a hit is worth, and what it sets off.
- [Telegraphs](https://rigbak.com/docs/universal-combat-framework/telegraphs): One window on a wind-up warns the enemies in front of it and the players watching it.
- [Animation Integration](https://rigbak.com/docs/universal-combat-framework/animation-integration): Tags held for a montage window, approach and warp windows, footsteps and other effects from animation.
- [Physical Reactions](https://rigbak.com/docs/universal-combat-framework/physical-reactions): Bones that move under physics when a blow lands, a ragdoll on death, and a limit for the whole level.

---

## Enemy layer

- [Step-by-Step Enemy](https://rigbak.com/docs/universal-combat-framework/enemy/step-by-step-enemy): A complete enemy from scratch, one asset at a time.
- [Minimal Enemy](https://rigbak.com/docs/universal-combat-framework/enemy/minimal-enemy): The components that make an enemy fight, on a pawn and controller of your own.
- [Movement System](https://rigbak.com/docs/universal-combat-framework/enemy/movement-system): Tactical positioning, strafing, distance keeping and avoidance.
- [Action System](https://rigbak.com/docs/universal-combat-framework/enemy/action-system): Actions picked by score, with cooldowns, combos and the way each one runs.
- [Action Set Editor](https://rigbak.com/docs/universal-combat-framework/enemy/action-set-editor): Lay a moveset out as cards, wire combos, and watch the AI decide while the game runs.
- [Reaction System](https://rigbak.com/docs/universal-combat-framework/enemy/reaction-system): Parries, dodges and counters an enemy answers a hit or a warning with.
- [Reaction Set Editor](https://rigbak.com/docs/universal-combat-framework/enemy/reaction-set-editor): Lay an enemy's answers out as cards, draw an arrow from each rule to the reactions it may pick, and watch a live enemy answer.
- [Combat Roles](https://rigbak.com/docs/universal-combat-framework/enemy/combat-roles): A group of enemies split into attackers, flankers and waiters.
- [Combat Tokens](https://rigbak.com/docs/universal-combat-framework/enemy/combat-tokens): Cap how many enemies may attack one target at once, so a crowd takes turns.
- [Targeting System](https://rigbak.com/docs/universal-combat-framework/enemy/targeting-system): Which target an enemy picks, and who takes over when one dies in co-op.
- [Awareness System](https://rigbak.com/docs/universal-combat-framework/enemy/awareness-system): What an enemy has seen and heard, and when it starts to fight.
- [Threat Detection](https://rigbak.com/docs/universal-combat-framework/enemy/threat-detection): An enemy that notices the player's camera on it and reacts.
- [Territory and Patrols](https://rigbak.com/docs/universal-combat-framework/enemy/territory): Patrol posts, wander areas and the leash that walks an enemy home.
- [StateTree](https://rigbak.com/docs/universal-combat-framework/enemy/statetree): The tasks and conditions the enemy brain runs on.
- [Determinism](https://rigbak.com/docs/universal-combat-framework/enemy/determinism): Seed every roll an enemy makes, so the same fight plays out the same way twice.
- [Configuration Reference](https://rigbak.com/docs/universal-combat-framework/enemy/configuration): Every enemy data asset and project setting in one place.

---

## Player layer

- [Build Your First Combo](https://rigbak.com/docs/universal-combat-framework/player/first-combo): A sword that swings three hits and lands them: a graph, an item, a key and a hit volume.
- [Character Setup](https://rigbak.com/docs/universal-combat-framework/player/character-setup): The components that make a character of your own fight, with its parent class left as it is.
- [Action Graph](https://rigbak.com/docs/universal-combat-framework/player/action-graph): The state machine behind every move: nodes, transitions, and the window that says when an input counts.
- [Action Graph Editor](https://rigbak.com/docs/universal-combat-framework/player/action-graph-editor): Read the cards, wire moves together, and watch a character run the graph during play.
- [Gates, Costs and Cooldowns](https://rigbak.com/docs/universal-combat-framework/player/gates-costs-cooldowns): When a move may start, what it spends, and how long it waits.
- [Input](https://rigbak.com/docs/universal-combat-framework/player/input): Turn a key into an input tag: the character's own inputs, an item's, chords, and abilities that answer a key.
- [Items](https://rigbak.com/docs/universal-combat-framework/player/items): A definition plus fragments, each adding one capability, and presets a family of items shares.
- [Equipment](https://rigbak.com/docs/universal-combat-framework/player/equipment): Drawing and putting away: body places, whose moves the character uses, and reaches that swap on a notify.
- [Inventory](https://rigbak.com/docs/universal-combat-framework/player/inventory): What a character owns: stacks, spending them, and state that belongs to one item.
- [Quick Bar](https://rigbak.com/docs/universal-combat-framework/player/quick-bar): The belt of slots on the player controller, one key per slot.
- [Pickups, Drops and Holders](https://rigbak.com/docs/universal-combat-framework/player/pickups-drops-holders): Items lying in the world, dropping what is held, and racks with Take and Put Back.
- [Combat Styles](https://rigbak.com/docs/universal-combat-framework/player/combat-styles): One asset gives a character its combat feel: rotation, targeting, reach, movement, camera, tags and keys.
- [Targeting](https://rigbak.com/docs/universal-combat-framework/player/targeting): Make anything targetable, pick the enemy in front, lock on and switch with a flick.
- [Attack Steering](https://rigbak.com/docs/universal-combat-framework/player/attack-steering): An attack turns to its target, closes the gap and stops short instead of running into it.
- [Camera](https://rigbak.com/docs/universal-combat-framework/player/camera): A third-person camera framed by the combat style or the weapon in hand.
- [Sprint and Speed](https://rigbak.com/docs/universal-combat-framework/player/sprint-and-speed): Walk, sprint on a held button with a stamina cost, and slow the character by tag.
- [Hit Reactions](https://rigbak.com/docs/universal-combat-framework/player/hit-reactions): A struck character answers the blow: a flinch that cuts its attack, and hyper armor that carries a heavy swing on.
- [Interaction](https://rigbak.com/docs/universal-combat-framework/player/interaction): Make any actor usable: its options, how a character finds it, and a prompt for the key to press.
- [Interaction Payloads](https://rigbak.com/docs/universal-combat-framework/player/interaction-payloads): What an option does: a montage, a wait, an ability or a payload asset, after a walk onto a spot.
- [Paired Actions](https://rigbak.com/docs/universal-combat-framework/player/paired-actions): Two or more characters in one synced move, such as a finisher, a counter or a grab.
- [Pairing Editor](https://rigbak.com/docs/universal-combat-framework/player/pairing-editor): Line roles up, time montages and events on the timeline, and key a camera shot.
- [HUD and Input Prompts](https://rigbak.com/docs/universal-combat-framework/player/hud-and-input-prompts): A HUD that follows the character's ability system, and prompts that show the bound key.

---

## Reference

- [Names in Universal Combat Framework](https://rigbak.com/docs/universal-combat-framework/names-in-ucf): How the standalones' names read here, and every old name beside its new one.
- [Enemy Multiplayer](https://rigbak.com/docs/universal-combat-framework/enemy/multiplayer): What the server decides for an enemy, and what reaches each player.
- [Player Multiplayer](https://rigbak.com/docs/universal-combat-framework/player/multiplayer): What each player's machine does at once, what the server checks, and how to test with lag.
- [Enemy Patterns](https://rigbak.com/docs/universal-combat-framework/enemy/patterns): Seven enemy archetypes as recipes: the numbers to type, and the field each one goes in.
- [Player Patterns](https://rigbak.com/docs/universal-combat-framework/player/patterns): Recipes built on the player demo: combat styles, a parry, a counter, a dodge, an execution, a door and a chest.
- [Troubleshooting](https://rigbak.com/docs/universal-combat-framework/enemy/troubleshooting): The symptom you are looking at, its cause, and the fix, plus every debug switch.
- [Enemy Architecture](https://rigbak.com/docs/universal-combat-framework/enemy/architecture): Which piece of the enemy layer lives where, what decides, what replicates, and the switch that shows each part running.
- [Performance](https://rigbak.com/docs/universal-combat-framework/enemy/performance): What each enemy system costs per enemy, and which settings bring it down.
- [API Reference](https://rigbak.com/docs/universal-combat-framework/enemy/api-reference): Classes, components and Blueprint nodes the enemy layer exposes.

---

## Credits

The demo's locomotion includes animations and Blueprints adapted from Epic Games' Lyra Starter Game and Game Animation Sample. Its footstep, scenery hit, swing, dodge, gear, guard and interface sounds come from Lyra Starter Game, and its landing, jump and body fall sounds from the Game Animation Sample, all used under the Unreal Engine EULA. The demo UI uses the Inter and Cinzel typefaces under the SIL Open Font License 1.1.

---

## Support

- [Get on Fab](https://www.fab.com/listings/ecc5de6d-b0d1-49ea-8a79-17dd634de60f)
- [Try the Demo](https://rigbak.com/demos/ucf)
- [Roadmap](https://rigbak.com/roadmap/ucf)
- [Discord Support](https://discord.com/invite/CbRcTsYQcz)

---

## The two standalones

Universal Combat Framework includes everything in Soulslike Enemy Combat and Universal Player Combat, working together as one system, and lets an enemy fight with the player's action graphs. Own both standalones? Verify both purchases on the Rigbak Discord and claim Universal Combat Framework there.

- [Soulslike Enemy Combat on Fab](https://www.fab.com/listings/7087cec0-6975-4de5-82e0-0de0b9b3e9a7)
- [Universal Player Combat on Fab](https://www.fab.com/listings/b4a9c6df-5b08-49be-8c44-d742b66f6d9b)
- [Open a ticket on Discord](https://discord.com/invite/CbRcTsYQcz)
