Skip to content
unreal · gameplay

Server-authoritative combatKBVECombat

The shared combat domain — server-authoritative damage, teams/factions, and death — built on KBVEGameplay primitives (stats + effects). It depends on KBVEGameplay, never the reverse: combat consumes the primitives, it doesn't define them. Backend-agnostic — Mover pawns, CMC characters, and Mass NPC proxies all fight through one interface. It ships as the KBVECombat module inside the KBVEGameplay plugin.

Authority-only damage

UKBVECombatStatics::ApplyDamage resolves a combatant on any actor and applies an FKBVEDamageEvent against the owner's Health stat via IKBVEStatTarget, composing with KBVEGameplay effects and replicating through the owner's transport.

  • Backend-agnostic — Mover, CMC, and Mass NPC proxies fight through IKBVECombatant.
  • Depends on — KBVEGameplay (stats + effects), never the reverse.
0.1.0Version
UE 5.7+Engine
Win64 · Linux · MacPlatforms
KBVELicense

Pieces

Pieces

UKBVECombatComponent

Resolves damage against the owner's Health stat via IKBVEStatTarget, tracks team + replicated dead state, fires OnDamaged / OnDeath. Implements IKBVECombatant.

IKBVECombatant

GetTeamId / IsAlive / ApplyDamage — uniform participation regardless of movement backend.

FKBVEDamageEvent

Amount, EKBVEDamageElement, instigator, and hit info.

UKBVECombatStatics

ApplyDamage / IsAlive / GetTeamId / AreHostile, resolving a combatant on any actor; ApplyDamageToEntity / ApplyDotToEntity reach Mass entities through the same surface.

Abilities, threat and loot

UKBVEAbilityComponent runs windup/cooldown abilities with line-trace or AoE hits; UKBVEThreatComponent ranks attackers by damage; UKBVELootComponent rolls a drop table on death.

Status effects and resists

UKBVEStatusEffectComponent applies timed stat modifiers with optional DoT; per-element Resistances scale incoming damage.

Mass batch path

FKBVECombatFragment on Mass entities; UKBVECombatBatchSubsystem drains a thread-safe damage queue on the game thread, and UKBVECombatDotProcessor ticks DoTs in parallel.

UKBVECombatFeedSubsystem

Per-world ring buffer of damage, death and ability events, broadcast via OnCombatEvent for damage numbers and combat logs.

Integration

Usage

FKBVEDamageEvent Dmg;
Dmg.Amount = 25.f;
Dmg.Element = EKBVEDamageElement::Fire;
Dmg.Instigator = Attacker;
UKBVECombatStatics::ApplyDamage(Target, Dmg); // authority-only

Add UKBVECombatComponent to any actor implementing IKBVEStatTarget with a Health stat (e.g. AKBVEMoverPawn). Damage flows through the stat, composing with KBVEGameplay effects and replicating via the owner’s transport (Iris / KBVENet).

Planned

Roadmap

  • Status replication and stacking rules (stack count, diminishing returns).
  • A Mass status (stat-modifier) fragment for non-DoT effects on the swarm.

Questions

Frequently asked

What is the KBVECombat plugin?

KBVECombat is the shared combat domain for KBVE Unreal Engine games — server-authoritative damage, teams and factions, and death — built on KBVEGameplay stat and effect primitives. It depends on KBVEGameplay and never the reverse.

Which movement backends does KBVECombat support?

It is backend-agnostic. Mover pawns, CMC characters, and Mass NPC proxies all fight through the same IKBVECombatant interface, so combat participation is uniform regardless of the movement backend.

How is damage applied in KBVECombat?

Damage is authority-only. UKBVECombatStatics::ApplyDamage resolves a combatant on any actor and applies an FKBVEDamageEvent against the owner's Health stat via IKBVEStatTarget, composing with KBVEGameplay effects and replicating through the owner's transport.

Discuss on the forum

Questions, fixes and notes on this page live in the KBVE forum.