Damage Direction Indicator by KayGee

📢 ModWorkshop x Sidetrack Games

Hey everyone, Milk here. You might remember me as the one who manages ModWorkshop from behind the scenes.

I've got some good News for all of you.

Me and Luffy decided to join ModWorkshop with Sidetrack Games (the guys who made RAID: WW2 updates and maintain PAYDAY 2)

Going forward that means there wont be any more ads. Nobody liked those anyways.
It also means we will have some more resources to run ModWorkshop, so it'll be a bit faster.

As for how ModWorkshop works and operates, that does not change.
The community continues to be in charge and makes the decisions that matter.

This generally means the burden of everything isn't just on me alone anymore.
And it also means that there is a better future ahead for ModWorkshop.
Running certain things alone has not always been easy.

So to a better future and lots of cool new mods.

This mod uses AI-Generated content either partly or fully, see mod's description for more information.

Damage Direction Indicator

TL;DR

Damage Direction Indicator adds a configurable damage indicator when the player takes enemy damage. The indicator appears around the center of the screen, rotates toward the damage source, and fades out after a short delay.

Requires Metro Mod Loader version 3.1.1.

Requires Mod Configuration Menu.

This mod is visual feedback only. It does not change damage, armor, AI behavior, weapon behavior, audio, movement, or projectile simulation.

Features

Adds a red directional indicator when enemy damage hits the player.
Supports multiple simultaneous damage indicators.
Includes a generic center pulse for damage where no reliable direction can be determined.
Draws the indicator procedurally, with no external image asset.
Hides indicators while menus/interfaces are open, including the pause menu.
Supports vanilla enemy hitscan, BTR fire, explosions, and Simulated Ballistics enemy projectile damage.
Includes MCM sliders for timing, size, radius, center distance, opacity, and active indicator count.

MCM Options

Settings are stored at:

user://MCM/DamageDirectionIndicator/config.ini

Available options:

Enabled: default On
Generic Pulse For Unknown Source: default On
Hold Time: 0-1000ms, default 150ms
Fade Time: 100-2000ms, default 650ms
Indicator Radius: 25-500px, default 100px
Center Distance: 0-500px, default 100px
Indicator Scale: 5-200%, default 10%
Indicator Alpha: 0-100%, default 15%
Max Active Indicators: 1-8, default 4

Indicator Radius controls the arc’s curvature/shape.
Center Distance controls how far from the screen center the indicator appears.

Compatibility

Damage Direction Indicator hooks player damage and common enemy damage source events.

Potential conflict areas:

Mods that heavily modify res://Scripts/Character.gd
Mods that replace or bypass WeaponDamage(...)
Mods that replace or bypass ExplosionDamage(...)
Mods that fully replace AI/BTR/explosion damage source flow

Known compatibility:

Works with vanilla human enemy firearm damage.
Works with vanilla BTR/vehicle gun damage.
Works with explosion damage when a source position can be inferred.
Works with Simulated Ballistics because Simulated Ballistics reports enemy projectile impact sources to this mod when both are installed.

Known limits:

Unknown or ambiguous damage sources use the generic pulse instead of a directional arc.
Environmental damage such as starvation, dehydration, falling, and similar non-enemy damage is not the intended target for directional indicators.
Direction is based on the best available source position at damage time, not a full combat log.