Telegraphs

Documentation Unreal Engine Combat Framework Telegraphs Reactions

Make a montage announce an attack: one window on the windup warns the enemies in its reach in time to parry or dodge, and shows each player in its reach a marker their own style set picks.


A blade touches its target hundredths of a second before it hurts, far too late to raise a guard. One window on the windup announces the attack instead: the enemies in its reach hear it in time to parry or dodge, and each player in its reach sees a marker over it.

Set it up

5 minutes
  1. 1

    Mark the attack's windup

    Open the attack montage. On a notify track, right-click where the windup starts, Add Notify State, UCF Telegraph Window, and drag it across the windup, up to where the swing's UCF Melee Trace Window starts. Tick Find The Attack Automatically, so the window describes the swing with that swing's own tags.
    AM_MyAttack
    0.0
    0.2
    0.4
    0.6
    0.8
    1.0
    1.2
    1.4
    1.6
    Notifies
    UCF Telegraph Window
    UCF Melee Trace Window
    The telegraph window covers the windup. The trace window after it is the swing the warning describes.
    A fresh window reaches anyone up to 500 cm away who is not on the attacker's team, on an enemy's montage and on the player's alike. The demo's two-handed attacks (AM_UCF_TwoHanded_SingleAttack, AM_UCF_TwoHanded_DoubleAttack and AM_UCF_TwoHanded_TripleAttack) and its unarmed combo, AM_UCF_Unarmed_Combo, already carry windows, in an enemy's hand and the player's.
  2. 2

    Give an enemy something to answer with

    Open the enemy's Reaction Set, add a trigger rule with On Stimulus set to UCF.Stimulus.AttackTelegraphed, and point it at a parry or a dodge reaction. That is the whole receiving end; Reaction System covers rules and reactions. The demo's combo enemies run ReactionSet_UCF_TwoHanded, which carries a rule on that stimulus.
  3. 3

    Give the player a marker

    Content Browser
    ▸ Content
    Right-click in the Content Browser, UCF, Targeting, Telegraph Style Set.
    Open the new set, add a row to Styles, put UCF.Attack.Counterable in its Blocked Tags, and set Presenter Class to the demo's blue line.
    TelegraphStyle_MyPlayer
    ▾Styles, Index [ 0 ]
    Blocked Tags 
    Presenter ClassNone
    One row covers every attack that does not open a counter. An attack matching no row shows nothing.
    On the player character, click Add, pick UCF Telegraph Viewer, and set its Style Set to the new set. The demo's BP_UCF_Character carries one already, set to TelegraphStyle_UCF_Default.
  4. 4

    Press Play and trade swings

    Open LVL_UCF_Demo, press Play, and run UCF.Debug.Stimulus.Draw 1. In the Over Shoulder arena, stand close in front of a combo enemy holding the baton or its fists as it winds up a combo: a marker goes up over its swing on your screen. Attack it unarmed or with the two-handed baton: the ground your window covers is drawn in orange, and the enemy gets a colored sphere, green when it answered.
An enemy whose Reaction Set carries no trigger rule for the announcement hears it and does nothing, and a player whose viewer has no Style Set sees nothing. Neither logs an error. The debug draw marks such an enemy yellow: fill in Trigger Rules on the set the enemy is running, and assign a style set on the viewer.

Mark the attack on the montage

Two notifies announce what a character is doing, one from Add Notify State and one from Add Notify. Pick by whether the moment has an end frame.
NotifyUse it for
UCF Telegraph WindowA stretch of frames: an attack's windup, or the seconds a stunned character stays open to a finisher. A player's marker comes down when the window closes, and the window's tags sit on the character while it runs.
UCF TelegraphOne frame with no natural end: a parry landing, a stagger beginning. Its Duration Seconds bounds a player's marker, or the style row's Duration when it is 0. It puts no tags on the character.
Both carry the same settings, and the one-frame notify adds Duration Seconds. A fresh window with Find The Attack Automatically ticked reads:
Details
UCF Telegraph Window
Telegraph
Origin Space
Montage Mesh
Telegraph Type
Damage
Find The Attack Automatically
Tags
0 Gameplay Tags
Origin Socket
None
Magnitude
0
Override Time To Impact
Broadcast
Shape
Sphere
Team Filter
Enemies Only
Shape
Radius
500
Debug
Draw Debug
A fresh window reaches anyone up to 500 cm away who is not on the attacker's team. With Find The Attack Automatically ticked it reads the tags of the next UCF Melee Trace Window in its montage section, and with Override Time To Impact left off its countdown is the gap to that window.
SettingDoes
Origin Space, Origin Item TagPut a player's marker, and the point the reach is measured from, on a drawn weapon rather than on the body. See Put the marker on the weapon.
Telegraph TypeDamage describes an incoming blow and takes its tags off the attack. None describes a state the character is in, with Tags alone.
Find The Attack AutomaticallyRead the attack's tags off the next UCF Melee Trace Window in this montage section, so the warning and the blow describe the same swing. Starts off; tick it on any attack with a trace window after the telegraph.
AttackThe damage config this describes, shown while Find The Attack Automatically is off, for a grab or a blow with no trace window on the montage. Left empty, the announcement is the window's own Tags and nothing else, which is how a feint warns about a blow it never delivers.
TagsTags added in front of the attack's. With Telegraph Type on None they are the whole description.
Origin SocketThe socket the reach is measured from and a player's marker hangs on. None uses the mesh's origin; a socket at a long weapon's tip starts the reach at the tip.
ShapeThe ground the warning covers. See Aim the warning.
Team FilterWho it reaches. Enemies Only, the default, leaves the attacker's teammates out.
Draw DebugDraw the reach and the arc in the world for a moment, to check the shape against the animation.
MagnitudeHow big the attack is, in whatever units the project uses, such as a damage figure or a 0 to 1 charge level. A marker reads it from its announcement, and an enemy's Stimulus Magnitude Gate judges it. 0 says nothing about size.
Override Time To ImpactSet the countdown by hand rather than measuring the gap to the next trace window. Tick it for a grab or a projectile launch, and set Time To Impact in seconds.
Duration SecondsOne-frame UCF Telegraph only: how long a player's marker lives, in seconds. 0 leaves it to the style row.
While a window runs, its tags sit on the attacker's ability system, and they come off as it closes, whether the montage finished, blended out or was interrupted. A Defense response or a finisher check reads them there without listening for the warning.
A window announces once each time the montage plays through it. A character that shows one montage on two meshes, such as first-person arms beside the body, announces once as well: only the mesh its moves play on announces, and the copy is there to be seen. Animation Integration covers that rule for every notify.

Say what the window announces

Telegraph Type on Damage describes an incoming blow. With Find The Attack Automatically ticked, the window takes the attack's tags from the next UCF Melee Trace Window in its montage section: that window's Extra Damage Tags and its damage config's Damage Tags, or those of the Default Damage Config on the character's melee trace component when the trace window names no config. The window's own Tags come in front of those. In a combo split into montage sections, each swing's window describes that swing alone. One authored answer then feeds the warning, the enemy rule that answers it and the Defense response that prices the blow, so all three can agree.
Untick it for a montage with no trace window to find, a grab or a projectile launch, and an Attack picker appears: point it at that attack's damage config. Leave Attack empty as well, and the announcement is exactly the window's own Tags, which is a feint: warn about a heavy overhead, then play a montage that never swings.
Telegraph Type on None announces a state instead, with no attack behind it: a stunned character open to a finisher, a boss whose armor has cracked. Drag the window across those frames and fill in the tag. The demo's AM_UCF_Stun holds UCF.State.Staggered this way.
Three tags describe how an attack can be answered:
TagMarks an attack
UCF.Attack.UnblockableA raised guard cannot stop.
UCF.Attack.UnparryableA parry cannot turn aside. Pair it with Unblockable for an attack that can only be dodged.
UCF.Attack.CounterableThat opens a counter or an execution rather than a parry.
Put them on the attack, in its damage config's Damage Tags or its trace window's Extra Damage Tags. The guard reads them off the blow, a player's style row reads them off the warning, and an enemy's trigger rule reads them off the stimulus, all from that one place.
A Damage window that names its attack, through Find The Attack Automatically or Attack, warns once under LogUCFTelegraph when its own Tags carry a tag the attack lacks, since the guard would answer the blow as an ordinary one while the warning says otherwise. Put the tag on the trace window's Extra Damage Tags or the damage config's Damage Tags instead. A feint names no attack, so it announces its own Tags without a warning.

When the blow lands

The window works out how long is left by finding the next UCF Melee Trace Window after it in the same montage section and dividing the gap by the pace the montage plays at, so retiming or speeding up the animation keeps it right. A slow an ability puts on the swing for a moment is left out. A player's marker counts down from this, and an enemy's Time To Impact Gate judges it.
With no trace window after it in its section and Override Time To Impact left off, the notify reports 0 seconds left. A Damage window with Find The Attack Automatically ticked also names the montage once in the Output Log. See Melee Trace and Damage for the trace window.

Aim the warning

Shape is the ground the warning covers, for enemies and players alike. Each shape asks only for the values it uses, so a warning that reaches all round shows no angle to fill in.
ShapeFieldsReach for it
SphereRadius, 500 cm to startA shockwave, a roar, an attack wide enough that facing does not matter.
ConeRadius (500 cm), Half Angle Degrees (60) and Yaw Offset Degrees (0)A directional swing, a thrust, a breath weapon.
AM_MyAttack
▾Broadcast
ShapeSphere
Radius500
Half Angle Degrees60
Radius and Half Angle Degrees sit inside the shape and expand under it. Radius is the reach in centimeters, and Half Angle Degrees is measured to either side of where the attacker faces.
Half Angle Degrees is measured to either side of where the attacker faces: 45 is a narrow cone straight ahead, 90 covers everything in front, 180 covers all round. Yaw Offset Degrees turns the wedge off center, so 90 points it to the right, where a swing coming in from that side carries the blade.
Enemies and players are measured by the same shape and the same Team Filter. The window measures once, as it opens: a character who walks into reach halfway through the windup is not warned, and one who walks out keeps the warning.
Clear Shape and no enemy hears the window, while a player's viewer skips the reach test and the Team Filter and goes straight to its style rows and view rules. A shape that reaches 0 cm reaches nobody: it warns once under LogUCFReactions, naming the announcer and the tag, and no player sees a marker for it.

On an enemy: hearing the warning

The server passes each announcement on to the pawns standing on the ground its shape covers, and an enemy answers it through its Reaction Set. The enemy needs no wiring beyond a trigger rule.
A Damage announcement whose leading tag is not already under UCF.Stimulus reaches enemies as UCF.Stimulus.AttackTelegraphed, followed by its own tags, so a window carrying only an attack's tags answers the rules a project already has. A None announcement keeps the tags it authored, so a state fires only the rules that name one of them: a rule on UCF.State.Staggered answers the window on AM_UCF_Stun the way another rule answers a swing.
Five stages sit between the windup and the answer. The debug draw colors a pawn by the stage it dropped out at, so the diagram below doubles as the map for reading it.
1
Something announces itself
UCF Telegraph Window or UCF Telegraph notify, or Report Area Stimulus from any graph
One announcement carrying the subject, how long is left, and the tags describing what it is.
Drops out here: Nothing yet. A window announces at its first frame, a one-shot at the frame it sits on.
2
Who it reaches
Shape and Team Filter on the broadcast
The pawns standing on the ground the shape covers.
Drops out here: Anyone out of reach, behind the arc, or on the attacker's own side.
3
Did this one notice
Stimulus Filters on the receiver's Enemy AI Config
The enemies that could have seen it coming.
Drops out here: Back turned, has not spotted the attacker yet, a wall in between.
4
What kind of answer
Trigger Rules on the receiver's Reaction Set, asked in Rule Priority order, highest first
A reaction category: defensive, aggressive, whatever the rule names.
Drops out here: No rule matched the tags, the rule's Chance failed, or its Min Interval has not run out.
5
Which reaction runs
The usual reaction scoring inside that category
One reaction, which starts its ability.
Drops out here: Nothing in the category passed its gates, so the enemy takes the hit.
Stage 4 is the one place luck comes in. A rule's Chance at 0.5 leaves roughly half the enemies that noticed without an answer.

Give one attack its own answer

A trigger rule's On Stimulus matches any tag the announcement carries, and a rule on a parent tag catches its children. Two ways split one attack off from the rest:
  • Describe the attack. Put UCF.Attack.Heavy or UCF.Attack.Unblockable in its damage config's Damage Tags, then list it in a rule's Require Context Tags or Block Context Tags. A parry rule blocking UCF.Attack.Unblockable leaves an unblockable swing to the dodge rule below it.
  • Name the stimulus. Author a child tag such as UCF.Stimulus.AttackTelegraphed.Heavy and put it on the attack, in the damage config's Damage Tags or the trace window's Extra Damage Tags. A rule on UCF.Stimulus.AttackTelegraphed still catches it, so the existing rules lose nothing. Keep it off the window's own Tags, where a window that names its attack warns about it as a tag the attack lacks.

Say what an enemy is able to notice

Stimulus Filters on the enemy's Enemy AI Config are the reasons it might miss a windup. A warning has to clear all of them, and an empty list notices everything, including a swing behind the enemy's back.
Details
DA_KnightAIConfig
Awareness
Stimulus Filters
3 Array elements
Facing Cone
Half Angle Degrees
100
Bypass on Context Tags
1 Gameplay Tag
UCF.Attack.Unblockable
Awareness
Minimum State
Detected
Bypass on Context Tags
0 Gameplay Tags
Line of Sight
Trace Channel
Visibility
Eye Height
0
Bypass on Context Tags
0 Gameplay Tags
Every filter has to pass before the enemy considers answering. An empty list notices everything, including a swing behind its back.
FilterChecks
Facing ConeIs the source somewhere in front. Half Angle Degrees starts at 100, a wide human field of view; 180 turns the filter off.
AwarenessDoes the enemy already know about the source. Minimum State starts at Detected, so only an enemy watching the attacker answers its windup; Suspicious lets one that has merely heard something answer too. This is the stealth opener. Needs a UCF Awareness component on the controller; without one the filter passes and warns once under LogUCFReactions. See Awareness System.
Line of SightCan the enemy see where the warning comes from, so a warning does not travel through a wall. Only the world blocks the view: characters and anything they hold are seen through, and the source counts as seen when the middle, top or bottom of its body is in clear view. A warning whose Origin lies away from its source, such as a spell landing across the room from its caster, is checked at the Origin. Trace Channel starts at Visibility, Eye Height at 0, which uses the pawn's own eye height.
Each filter carries Bypass on Context Tags: skip this filter when the announcement carries any of these. Put UCF.Attack.Unblockable there and a roar loud enough to notice regardless gets through a facing cone that would otherwise refuse it. A parent tag matches its children.

Match the answer to the blow

Four gates read the announcement itself rather than the pawn, so each one belongs in a trigger rule's Conditions or in a reaction's own Gates, under Scoring.
GateJudgesSet it to
Incoming Angle GateWhich side the blow arrives from. Half Angle Degrees starts at 60.The arc the guard covers, so a parry cannot answer a swing from behind.
Time To Impact GateHow long is left. Min Seconds and Max Seconds, 0 for no bound.Min Seconds at the parry's own start-up, so the enemy stops trying to beat a swing already too close.
Stimulus Magnitude GateHow big it is, in whatever the announcer measured. Min Magnitude and Max Magnitude.A ceiling on the flinch rule and a floor on the stagger rule, so a light hit and a heavy one split.
Source Distance GateHow far off the attacker stands, in centimeters. Min Distance and Max Distance.Max Distance at a counter's own range, so the enemy stops swinging back at an archer across the room.
A gate in a rule's Conditions decides whether this kind of answer is considered at all, and a refusal drops the announcement to the next rule down. A gate in a reaction's Gates decides whether that reaction is the right one inside a category that already matched, and a refusal leaves the announcement to another reaction in the same category.
Reach for the rule when nothing in the category can help. A blow landing from behind is one of those: a guard raised against it stops nothing, because the Defense component measures its own arc when the damage lands and refuses the block. Gate the rule and write a second rule under it.
Rule PriorityRuleConditionsAnswers with
10GuardFrontalIncoming Angle Gate, half angle 60Your defensive category
0FlinchAnythingnoneYour stagger category
A frontal blow takes the first rule and gets the guard. A blow from behind fails its condition, falls through, and gets a flinch. Match the gate's Half Angle Degrees to the arc on the matching Defense response so the decision and the damage agree. Nothing hands an enemy's action an announcement, so one of these gates added to an action has nothing to judge and passes; they belong on the reaction side.

Announce without a montage

Report Area Stimulus is the same call a telegraph window reaches on its way to enemies, available from any event graph. Reach for it for a projectile, a grab, a spell going off, or a scripted moment.
BP_Fireball · Event BeginPlay
Make Cone Broadcast
Target is UCFStimulus Library
Radius700.0
Half Angle Degrees30.0
Yaw Offset Degrees0.0
Team FilterEnemies Only
Return Value
Make UCFTelegraph
SubjectSelf
TagsUCF.Stimulus.AttackTelegraphed
Time to Impact0.8
Broadcast
UCFTelegraph
Get Velocity
TargetSelf
Return Value
Report Area Stimulus
Target is UCFStimulus Library
SourceSelf
Stimulus
Facing
Return Value
Fill the Stimulus pin with Make UCFTelegraph. Tags, Magnitude and Time to Impact carry what they carry on a window, and Subject is who the announcement is about: the reaction that answers takes it as its target, so a counter swings at the right pawn, and the subject itself is never warned. Left empty, the Source is the subject. Three pins matter only on this path.
PinCarries
BroadcastHow far it carries and who it reaches. Build it with Make Sphere Broadcast or Make Cone Broadcast.
OriginWhere in the world it came from. Left at zero it falls back to the subject's location.
PayloadAny object to hand along, such as the weapon or the projectile. Cast it in Blueprint.
A fireball warns what is in front of it on spawn: pass the projectile as Source, its caster as Subject, its velocity as Facing, and a cone as the shape. The answering reaction then swings at the caster. Facing is an advanced pin, so expand the arrow at the bottom of the node to reach it. Left at zero it falls back to the source actor's forward vector.
The node returns how many pawns were told, which is worth printing while tuning a radius. Direction is filled in per pawn as the warning goes out, so an Incoming Angle Gate reads it without any setup. It reaches enemies only: no player sees a marker for it.

On the player: seeing the warning

How a warning reaches the player

The window announces the attack on every machine playing the montage. Each player watching on that machine then walks the same steps, and the first one that says no means no marker for that player.
One announcementEach viewer on this machine, step by step
1
An attack announces itself
a UCF Telegraph Window on the attacker's montage, or Show Marker
The window announces when the montage reaches it, on every machine playing that montage, with the tags it describes the attack by. Show Marker announces the same way on the machine that calls it.
2
A player on this machine is watching
UCF Telegraph Viewer, Style Set
Each viewer on a pawn a player on this machine controls, with a Style Set, is asked in turn. A character is never warned about its own attack, and an AI pawn is never a viewer.
3
The attack reaches the player
the window's Shape and Team Filter
A window with a shape warns only a player standing inside it whom its Team Filter lets through. With no shape, every viewer goes on to the next step.
4
A style row matches
Styles: Required Tags, Blocked Tags, Priority
The highest Priority row matching the attack's tags. No row, no marker.
5
Every view rule agrees
View Rules
Close enough, aimed the player's way, or whatever a rule of your own asks. An empty list agrees to everything.
6
The marker goes up
the row's Presenter Class, at the Origin Socket or the row's Fallback Socket
The presenter spawns on the socket and Begin Telegraph runs, then Update Telegraph each frame until the window closes or the marker's length runs out, then End Telegraph. A one-frame notify with no length anywhere, or a weapon stowed before this step, draws nothing.
A player who starts watching while a window is still open, such as one who respawned or was given a new style set, is shown that warning too.
The montage describes the attack once, the same way for every player; the style set on each player's viewer decides what that player sees. Two players can be given two different style sets, so one sees warnings another does not.

Choose which attacks get which marker

A Telegraph Style Set holds Styles, one row per kind of attack, and View Rules, which decide whether a player is warned at all.
Details
TelegraphStyle_MyPlayer
Telegraph
Styles
2 Array elements
Index [ 0 ]
Required Tags
1 Gameplay Tag
UCF.Attack.Unblockable
Blocked Tags
0 Gameplay Tags
Priority
10
Presenter Class
BP_UCF_TelegraphPresenter_RedCross
Fallback Socket
None
Duration
0
Index [ 1 ]
Required Tags
0 Gameplay Tags
Blocked Tags
1 Gameplay Tag
UCF.Attack.Counterable
Priority
0
Presenter Class
BP_UCF_TelegraphPresenter_BlueLine
Fallback Socket
None
Duration
0
View Rules
2 Array elements
Index [ 0 ]
UCF Within Distance
Max Distance
1500
Index [ 1 ]
UCF Subject Facing Viewer
Arc Half Angle Degrees
75
An unblockable attack matches both rows and takes the cross, the higher Priority. An attack that is counterable, and not also unblockable, matches neither, so it shows nothing. Every other attack gets the flare.
SettingDoes
Required TagsTags the attack must all carry for this row to be used. Empty matches anything, which is what a catch-all row wants. A parent tag is met by any of its children.
Blocked TagsTags that rule the row out when the attack carries any of them. Naming a tag here on every row is how an attack ends up showing nothing.
PriorityWhich row wins when several match. The highest wins, so give the specific rows a higher Priority than the catch-all; a tie goes to the row listed first.
Presenter ClassThe marker spawned for this row. Unset still matches the row and draws nothing, which keeps that kind of attack silent on purpose.
Fallback SocketThe bone or socket the marker sits on when the announcement names none, such as the chest a finisher prompt hangs over. None leaves it at the mesh's origin.
DurationHow long the marker lives, in seconds, for an announcement that sets no length of its own: the one-frame UCF Telegraph notify. Zero leaves it to the announcement; a one-frame notify with no length of its own then draws nothing and warns.
Flare, cross, nothing. A row requiring UCF.Attack.Unblockable at a high Priority draws the cross; a catch-all row with UCF.Attack.Counterable in its Blocked Tags draws the flare; an attack that is counterable, and not also unblockable, matches neither and shows nothing. List UCF.Attack.Unblockable in Blocked Attack Tags on the UCF Guard that blocks, and UCF.Attack.Unparryable on the UCF Guard that parries, and the warning and the guard agree. While a counterable attack winds up, its window holds UCF.Attack.Counterable on the attacker's ability system, so a counter or an execution can require the attacker to carry it.
The demo's TelegraphStyle_UCF_Default draws with the four demo markers listed under Make a marker.

Who is worth warning

View Rules sit on the style set. Every rule has to agree, and an empty list warns about any attack the player's own pawn did not make.
RuleWarns only aboutSetting
UCF Within DistanceAttacks close enough to matter, which keeps a distant fight from cluttering the screen.Max Distance, 1500 cm to start, measured between the attacker's and the player's positions.
UCF Subject Facing ViewerAttacks aimed the player's way, judged by where the attacker is facing, so it works for any enemy, with or without targeting of its own.Arc Half Angle Degrees, 75 to start: how far off the attacker's forward the player may stand. 180 turns the test off.
The window's own test runs before the rules: a window with a Shape warns only players standing inside it whom its Team Filter lets through, and a window with no Shape skips the test.
For a rule the two do not cover, such as warning only about the enemy the player has locked on to, create a Blueprint class whose parent is UCF Telegraph View Rule and override Should Show. It receives the announcement and the player's pawn and returns whether that player sees a marker. One rule object serves every player using the style set, so judge from what you are handed and store nothing on the rule.

Make a marker

A marker is an actor. Create a Blueprint class whose parent is UCF Telegraph Presenter, add the particle system or widget that draws the warning, and name the class on a style row. Three events give it its timing:
BP_MyTelegraphMarker · Event Graph
Event Begin Telegraph
Telegraph
Activate
Target is Actor Component
TargetNiagara
Reset
Event Update Telegraph
Normalized Time
Seconds to Impact
Event End Telegraph
EventRuns
Begin TelegraphOnce, as the marker goes up. Its Telegraph input carries the announcement: who is attacking (Subject), the mesh and socket it comes off, the attack's Tags, and Time to Impact. Start the effect here.
Update TelegraphEvery frame the marker is up, with Normalized Time and Seconds to Impact.
End TelegraphOnce, as the warning ends: the window closed, the montage was interrupted or stopped, the marker's length ran out, Hide Marker was called, the player's style set changed, or the attacker or the weapon carrying the marker went away. The actor is destroyed straight after, so an effect that fades out spawns a separate copy here to play the fade.
The marker spawns already attached to the socket the warning names, so it rides the swing with no work of its own. Each player who is warned gets a marker of their own.
Normalized Time runs from 0 to 1 across the windup, reaching 1 as the swing starts to sweep for hits, while Seconds to Impact counts down to that moment. Both follow the montage, so a slowed or retimed attack keeps them right. A marker with no swing to time against, but with a length of its own, runs Normalized Time across that length instead, and Seconds to Impact counts down what is left of it. With neither, both stay 0, so treat 0 as unknown rather than as the start.
Demo markerDraws
BP_UCF_TelegraphPresenter_BlueLineThe soft blue line, NS_UCF_AttackNotifier_Soft.
BP_UCF_TelegraphPresenter_RedCrossThe unblockable cross, NS_UCF_AttackNotifier_Unblockable.
BP_UCF_TelegraphPresenter_CounterThe bolder counter line, NS_UCF_AttackNotifier_Counter.
BP_UCF_TelegraphPresenter_ExecutableRings for a character open to an execution, NS_UCF_ExecutionPrompt_Rings.
All of them live in Content/Demo/FX/Telegraphs.

Put the marker on the weapon

A marker sits on the attacker's mesh, at the window's Origin Socket, or at the style row's Fallback Socket when the window names none. The marker and the reach the window measures start at that socket. A two-weapon attack carries two windows, each with its own socket, and gets two markers.
To put the marker on a drawn weapon rather than on the body, set the window's Origin Space to Drawn Item and Origin Socket to a socket on the weapon's mesh.
SettingDoes
Origin SpaceMontage Mesh, the default, looks the socket up on the character, which an unarmed attack wants. Drawn Item looks it up on a drawn item, so a blade flare rides the blade.
Origin Item TagWhich drawn item, shown for Drawn Item. Unset uses the item driving combat, which suits a one-weapon attack. For the other hand of a two-weapon attack, name that item's own equipment tag; two drawn items sharing a tag answer with whichever was drawn first.
A character carrying a UCF Equipment Manager, as UCF Character Base and UCF Enemy Character Base do, answers which item it holds on its own, so a Drawn Item window on an enemy's swing rides the item in its hand as it does on the player's. A character with a weapon system of its own answers through the UCF Telegraph Origin Provider interface, on the pawn or on one of its components: implement Get Telegraph Origin Actor, which receives the item tag and returns the actor the item is drawn as, or none. The pawn's own answer comes first.
When the item is not drawn, carries no such socket, or the character cannot say which item it holds, the marker falls back to the character's mesh without a warning. A weapon stowed during the windup takes its marker down with it.

Put a marker over a character

Add UCF Telegraph Subject to any actor with a skeletal mesh and call Show Marker to raise a marker over it: a circle on a stunned enemy, a flare on a boss's weak point.
BP_MyEnemy · when it is stunned
UCFTelegraphSubject
Show Marker
Target is UCF Telegraph Subject
Target
TagsUCF.State.Staggered
Sockethead
Seconds3.0
Return Value
InputDoes
TagsWhat the style rows match, the same way they match an attack's tags.
SocketThe bone or socket the marker sits on. None uses the style row's Fallback Socket, then the mesh's origin.
SecondsAbove 0, the marker takes itself down after that long. 0 keeps it up until Hide Marker.
Show Marker returns a handle; pass it to Hide Marker to take that marker down, or call Hide All Markers. It returns 0 only for an actor with no skeletal mesh, which also logs a warning; any other call returns a handle, even when no player ends up seeing a marker.
Each player's own style set still decides whether the marker shows and what it looks like, so a style row has to match the tags, and the view rules still apply. The actor's own player never sees its markers, and no enemy hears a Show Marker.
For a state a character's animation already plays, such as a stun montage, a UCF Telegraph Window with Telegraph Type set to None and the state's tag in its Tags does much the same from the montage. It also holds the tag on the character while it runs and reaches nearby enemies too, and its Shape and Team Filter decide who hears it. The demo's AM_UCF_Stun raises UCF.State.Staggered that way.

Draw the warning in the HUD instead

The viewer fires two events a HUD can bind:
EventFires
On Telegraph ShownA warning went up: the attacking Subject, the attack's Tags and the Presenter drawing it.
On Telegraph HiddenA warning came down, with its Subject and Presenter.
A row with no Presenter Class still fires both, with no presenter, which is how a HUD draws its own marker instead of spawning one. One attacker can raise several warnings at once, such as one per weapon of a two-weapon swing, and On Telegraph Hidden carries only the Subject and the Presenter: keep a count per Subject, adding on Shown and removing the element when the count reaches zero.
Set Style Set on the viewer changes what the player sees at runtime, taking down the markers the outgoing set raised; passing none turns warnings off. Get Style Set reads it back, and Is Viewing says whether this viewer belongs to a pawn a player on this machine controls, which is the only case a warning is drawn for.

One announcement, two listeners

A telegraph is announced once, and two listeners hear it: the player's viewer, which draws markers, and the enemy layer, which hands the warning to enemies. Neither cares who swung, so one window serves an enemy's attack and a player's.
Announced byPlayers see a markerEnemies hear a stimulus
A UCF Telegraph Window or UCF Telegraph on a montageYes, each on their own machineYes, on the server
Show Marker on a UCF Telegraph SubjectYes, on the machine that calls itNo
Report Area StimulusNoYes, on the server
  • A player sees an enemy's attack. The enemy's montage plays on the player's machine, the window announces there, and the player's viewer raises the marker its style set picks. Nothing is sent over the network for it.
  • An enemy hears a player's attack. The server plays the player's montage too, and its window announces there, so the server passes the warning to the enemies in its shape. A player's attack montage carrying a window warns enemies with nothing else wired.
  • A state reaches both. A None window, such as the one on AM_UCF_Stun, shows players the marker their style rows pick for its tag and reaches nearby enemies under that same tag, so only the rules naming it fire.
  • Nobody hears their own attack. A character is never shown a marker for its own swing, and the attacker is never told about its own announcement.
The demo shows both directions in LVL_UCF_Demo: an enemy swinging the baton or its fists plays montages that carry windows, so the player sees those attacks coming, and the reaction sets the enemies' items bring, such as ReactionSet_UCF_TwoHanded and ReactionSet_UCF_Sword, carry rules on UCF.Stimulus.AttackTelegraphed, so they can answer the player's. Seam Patterns walks through it.

Debug it

UCF.Debug.Stimulus.Draw 1
Draws the ground each announcement covers at its origin on the server, then one sphere at every pawn it reached, colored by what happened and labeled with the outcome. A pawn that answered gets a thicker sphere and an arrow from the origin; every other pawn gets a plain line. Markers last two seconds, and the same lines go to the Output Log under LogUCFReactions.
Orangethe announcement
The ground the announcement covers, drawn at its origin and labeled with its leading tag and its shape. A Sphere draws a wireframe sphere at full reach; a Cone draws its arc, its two edges and an arrow along the aim.
GrayTeam filtered
The team filter refused this pawn, which is what keeps an attack from startling its own side.
BlueOutside shape
In range but off the ground the shape covers. Widen the shape, or turn a cone with its yaw offset.
RedNot noticed
One of the receiver's Stimulus Filters refused it. The label names which filter.
YellowNo reaction
Noticed, and nothing answered. The label says why: no trigger rule matched, or nothing in the category passed its gates.
GreenReacted
A reaction started, and the label names it.
CyanListener only
A pawn carrying a UCF Stimulus Listener and no reaction component.
WhiteNo receiver
Neither a reaction component nor a listener, so the announcement reached a pawn that cannot use it. A player pawn an enemy's swing reaches shows this, since a player sees warnings through a UCF Telegraph Viewer instead.
Read the colors as a funnel. Gray and blue mean the announcement is mis-shaped: widen the radius or the arc, check the team ids. Red names the filter that refused it. Yellow means the enemy noticed and had no answer, which points at the trigger rules or at the gates on the reactions in that category.
Draw Debug on one window draws its shape in orange on each machine that shows a view, and turns the enemy drawing above on for that announcement alone. The console variable forces the enemy drawing on for every announcement.
The warnings below show by default, each once per session for the same cause.
CategoryWarning saysFix
LogUCFTelegraphwhich the attack it describes does not carryA window's or a one-frame notify's own Tags promise something the attack lacks. Put the tag on the trace window's Extra Damage Tags or the damage config's Damage Tags; for a feint, untick Find The Attack Automatically and clear Attack.
LogUCFTelegraphfound no melee trace window after itA Damage window with Find The Attack Automatically ticked has no trace window after it in its section, so it cannot say when the blow lands. Add a trace window, or tick Override Time To Impact.
LogUCFTelegraphasked for a marker with no lengthA one-frame UCF Telegraph notify set no Duration Seconds, and the matching row sets no Duration. Set either.
LogUCFTelegraphTelegraph presenter ... was still loading when a warning went upThe style set was assigned mid-fight, so its markers loaded on the spot. Assign it before combat; the viewer starts loading them as soon as a set is assigned.
LogUCFTelegraphShow Marker on '...' found no skeletal mesh to hang a marker onThe actor carrying UCF Telegraph Subject has no skeletal mesh to hang the marker on.
LogUCFReactionsreaching 0 cm, so nobody was warnedThe window's shape has no reach. Give it a radius.
LogUCFReactionsuses an Awareness stimulus filter but carries no UCF Awareness componentAdd the component to the enemy's controller, or remove the filter from the AI Config.
AdvancedNothing is going out to enemies
  • The shape is cleared. That reaches no enemy by design and logs nothing. Pick Sphere or Cone.
  • The shape reaches 0 cm. A warning names the announcer and the tag, once.
  • The animation is playing in a preview window. A montage scrubbed in the editor announces to nobody, because the notify needs a running game world.
  • The machine is not the server. Warning enemies is the server's decision, so a client's own copy of a montage tells nobody, and the server's copy does. That is what stops one swing warning the same enemy twice.
  • The receiver is attached to the attacker. A pawn carried by or parented to the source is skipped, along with the source itself.
AdvancedIt reaches the enemy and the enemy does nothing
Follow the label on the yellow marker.
  • No trigger rule matched. The rule's On Stimulus has to match one of the announcement's tags, or sit above one as a parent tag.
  • Nothing in the category was available. Every reaction in the named category was on cooldown, blocked by a tag, or refused by its own gates.
  • A Time To Impact Gate refused it. An announcement that reports 0 seconds left fails any Min Seconds above 0. That is the gate doing its job on a hit that already landed, and a mistake on a window sitting past the montage's last trace window, which reports 0 seconds left and reaches every gate that way.
  • Min Interval has not elapsed. The gap is counted from the moment the rule last started a reaction.
AdvancedNo marker showed up
Walk the steps in order:
  • No viewer, or no Style Set. A viewer without a set does nothing, and an AI pawn is never a viewer, so a map with no player shows nothing. LVL_UCF_Demo plays BP_UCF_Character, which carries one.
  • The player made the attack. A character is never warned about its own attack.
  • Out of reach. The window's shape is a 500 cm sphere to start, and Enemies Only leaves the attacker's teammates out. The window judges reach once, as it opens.
  • No row matches. Check the attack's tags against each row's Required and Blocked Tags. Find The Attack Automatically off and no Attack set means the window carries only its own Tags.
  • A view rule refused. UCF Subject Facing Viewer refuses a player behind the attacker; UCF Within Distance refuses one beyond Max Distance.
  • The row has no Presenter Class. It matched and drew nothing, on purpose.
  • The marker sits on the body, not the weapon. A Drawn Item window falls back to the mesh when nothing answers which item is drawn, such as on a character with no UCF Equipment Manager.
  • The montage plays in a preview window. Markers need a running game world.
AlternativeOther ways to report something
Report Damage Taken Stimulus covers the other half of the story: a flinch or a counter after a blow connects. Call it from the pawn's Handle Incoming Damage once the damage is resolved, and it reads the direction the blow came from off the damage info. Leave Stimulus Tag empty for UCF.Stimulus.DamageTaken. A trigger rule on that tag answers it the way another rule answers a windup, so a flinch reaction and a parry reaction sit side by side in one Reaction Set.
Resolve Enemy Damage does the whole job in one call: run the blow through the pawn's Defense component, take what got through off its vitals, then report the outcome to combat awareness and to AI perception. Make Stimulus from Damage packages the same thing without reporting it, for a graph that wants to change a field before handing it on.
Report Stimulus To hands a single pawn a single announcement, skipping the area sweep. An AI runs its perception filters and then its trigger rules; a pawn carrying a UCF Stimulus Listener gets the plain notification through On Stimulus Noticed, on the server. Make Execution Context from Stimulus fills an execution context from an announcement, so a reaction you start by hand reaches its ability carrying what an automatic one would: the subject as the target, the leading tag as the event tag, the magnitude, the tags, and the direction packed into target data.
A parry prompt on a player's screen belongs on the UCF Telegraph Viewer, which runs on the player's own machine. A UCF Stimulus Listener hears the same warnings on the server, so a prompt built on it needs its own way down to the player.
AdvancedWriting a shape of your own
Subclass UCF Telegraph Shape in Blueprint for ground the built-in shapes cannot describe, such as a corridor or a ring. Answer three events:
  • Get Max Reach returns how far the shape can possibly reach, in centimeters. Nothing beyond it is looked at, so return the distance to the farthest corner rather than an average. A shape returning 0 reaches nobody.
  • Covers Receiver decides whether one pawn stands on the covered ground. Everything handed to it already sits inside Get Max Reach, so a shape filling its whole reach can leave this alone.
  • Draw Shape outlines the ground for the debug view. Feed its World Context Object input into the same pin on every Draw Debug node used inside, not a Self node; the shape can belong to no world, and wiring Self then draws nothing. Left alone, the base draws a sphere at full reach, which is the outer bound rather than what Covers Receiver accepts.
One shape instance answers for every pawn a warning reaches, enemy or player, and a notify is shared by every montage carrying it, so keep a subclass free of stored state.
AdvancedReplacing a whole stage on the enemy side
Two overridable events on the Reaction Evaluation component let a project take a stage over outright.
OverrideReplaces
Can Sense StimulusThe whole perception step. The default runs every filter in force and requires all of them to pass.
Select Reaction CategoryThe whole rule walk. Return a category tag to route an announcement your own way without authoring rules.
On Stimulus Received fires before the rule walk. Call Execute Reaction from there and the rules sit that announcement out, because a rule fires only when nothing already answered.
Fallback Stimulus Filters on the component covers a pawn running without an AI Config. A config listing any filters replaces that list outright rather than adding to it.
Writing a filter or a condition of your own is a Blueprint subclass either way: UCF Stimulus Filter answers Can Sense, and UCFGate answers Passes Gate with the pawn, the target and whatever set it off. A rule's Conditions take the same gate class an enemy's action or reaction takes, so one gate you write serves all three; it is the enemy layer's gate, apart from the UCFAction Gate on a player's action graph nodes. Keep both stateless, since every AI using the asset shares one instance.
MultiplayerMultiplayer
Nothing here replicates. The montage already reaches every machine, so a window announces on every machine playing it, the dedicated server included, and puts its tags on the character there, so a client-side check reads the same state the server does.
Markers are drawn on each machine for its own local players, from the montages that machine is already playing. Split screen spawns one set of markers per player, and every viewport renders all of them; tick Only Owner See on a marker's visible components to show each player only their own, since a marker's owner is the pawn of the player it warns. A dedicated server hears the same announcements and draws none, since it has no local player, and it never loads a presenter. Show Marker raises a marker only on the machine that calls it; for a marker every player should see, call it from something every machine receives, such as a replicated gameplay tag or a gameplay cue.
Enemies are warned on the server only. A window passes its announcement on from the server's copy of the montage, and Report Area Stimulus tells nobody when the source is not the authority, so a player's swing warns each enemy once, however many machines play it. Report Stimulus To and Receive Stimulus are server side for the same reason, and On Stimulus Noticed on a UCF Stimulus Listener fires on the server. Players see an enemy's answer through the reaction ability and its animation, which replicate the way every other ability does. See Multiplayer.
A window's team test runs on each machine that judges it. Put the attacker's UCF Team component on the pawn rather than on its AI controller, which a client does not have; Enemy Character Base carries one on the pawn already. Exclusion lists changed at runtime on the server do not reach clients, so a client can judge such an attacker differently.
C++C++
  • Every announcement goes out through UCFTelegraph::OnBegin(), carrying an FUCFTelegraph, and UCFTelegraph::OnEnd() follows when a window or a Show Marker ends; a one-frame notify sends no end. Both delegates are process-wide, so a listener checks that the announcement's Subject belongs to its own world; two Play In Editor sessions share them.
  • Two world subsystems listen: UUCFTelegraphSubsystem draws markers on machines with a local viewer, and UUCFTelegraphRelaySubsystem hands each announcement made with authority to UUCFStimulusLibrary::ReportAreaStimulus, putting UCF.Stimulus.AttackTelegraphed in front of a Damage announcement whose leading tag is not under UCF.Stimulus. Neither needs calls of its own.
  • FUCFTelegraph carries Subject, Mesh, OriginSocket, Type, Tags, TimeToImpact, bAwaitsExplicitEnd, DurationSeconds, OriginComponent, Origin, Direction, Magnitude, Broadcast and Payload. OriginComponent is set when a drawn item answered, and the marker attaches to it. bAwaitsExplicitEnd says whether an end is coming, so a marker knows to wait rather than time itself out.
  • FUCFTelegraphBroadcast::Reaches is the reach test a marker asks for an announcement with a shape: the team filter, then the shape. Report Area Stimulus runs the same two checks, so a marker and the enemy warning measure alike. With no shape, Reaches answers false for every pawn, so the viewer skips it.
  • ShapeAnnouncement is a virtual on both notifies, called on the announcement before it goes out. Override it in a C++ subclass of UUCFTelegraphMarkerNotifyState or UUCFTelegraphMarkerNotify to fill in what only the attack knows, such as a magnitude read off a charge level, and call Super, which applies Origin Space. It runs on every machine, dedicated server included, and what it fills in decides the ground the telegraph covers, so keep render-only work out of it.
  • A view rule in C++ subclasses UUCFTelegraphViewRule and overrides ShouldShow_Implementation(const FUCFTelegraph&, APawn* Viewer) const. A presenter overrides BeginTelegraph_Implementation, UpdateTelegraph_Implementation and EndTelegraph_Implementation.
  • IUCFTelegraphOriginProvider::GetTelegraphOriginActor is a Blueprint native event. UUCFEquipmentManagerComponent implements it, by GetInstanceByTag for a named item and GetCombatDriverInstance otherwise; the window asks the pawn first, then the first component implementing the interface (FindComponentByInterface).