DroneEffectAuraOverlay

v1.0.0·Updated 2026-03-07

【Client MOD】Shows colored overlays on targets affected by drones or Zero Gravity Orb effects.

About this mod Author’s original text

DroneEffectAuraOverlay

DroneEffectAuraOverlay is a visual overlay mod for R.E.P.O.

It shows colored overlays on targets that are currently affected by drone effects or Zero Gravity Orb effects, making them easier to identify at a glance.

Important

This mod is client-side visual only.

It only changes what you see on your own game client.

It does not change game logic, target behavior, physics, damage, drone behavior, orb behavior, or networked gameplay state.

Other players will not see these overlays unless they also install this mod.

This mod is intended for visual recognition only.

Features

  • Shows overlays on targets currently affected by drone effects
  • Shows overlays on targets currently affected by Zero Gravity Orb effects
  • Supports players
  • Supports enemies
  • Supports valuables and other physical objects
  • Uses the actual in-game effect colors
  • Restores original appearance when the effect is removed
  • Supports two animation modes
  • Ink
  • Gradient
  • Gradient flows from top to bottom
  • Default animation mode is Gradient
  • Excludes the outer AreaEffect shell of ItemOrbZeroGravity so the outer sphere stays at its vanilla appearance
  • Includes debug logging for detection and rendering verification

Supported effect sources

Current supported sources:

  • Drone effects based on active ItemDrone targets
  • Zero Gravity Orb effects based on active ItemOrbZeroGravity affected object lists

Rendering approach

This mod prioritizes visible and reliable results.

It uses multiple rendering paths at the same time when needed:

  • Original material overlay updates
  • Emission color updates
  • Base color tint fallback
  • Dedicated overlay clone renderers

This makes the effect more reliable across different target types and material setups.

Animation modes

Ink

Uses only the colors currently applied to the target.

When multiple colors are present, the visible color shifts between those applied colors in a mottled animated style.

Gradient

Uses only the colors currently applied to the target.

When multiple colors are present, the colors blend and flow from top to bottom across the target.

This is the default mode.

Notes

  • This mod is visual only
  • This mod works only on the client where it is installed
  • This mod does not synchronize overlays to other players
  • This mod does not modify gameplay logic
  • ItemOrbZeroGravity outer shell visuals are intentionally excluded from overlay so the outer sphere does not block visibility

Configuration

A General

EnableMod

Enable or disable this mod

OverlayAlpha

Overlay alpha for all drone and orb effects

EmissionStrength

Emission multiplier used when materials support emission

UpdateIntervalSeconds

How often target detection and visual updates run

RescanIntervalSeconds

How often renderer lists are rebuilt for active targets

AnimationMode

Animation mode selection

Available values:

  • Ink
  • Gradient

Default:

  • Gradient

A Fallback Paths

UseOriginalMaterialOverlay

Apply color and emission to original materials when supported

UseOverlayCloneRenderer

Create dedicated transparent overlay clone renderers

Z Debug

DebugLog

Enable debug logs for target detection and visual application

Recommended settings

For a stronger and easier-to-read effect:

  • OverlayAlpha = 0.75
  • EmissionStrength = 5.0
  • AnimationMode = Gradient

For a more mottled effect-color look:

  • OverlayAlpha = 0.75
  • EmissionStrength = 5.0
  • AnimationMode = Ink

Technical details

The mod detects active drone targets from ItemDrone state and target references.

It also detects active Zero Gravity Orb targets from ItemOrbZeroGravity through ItemOrb affected object tracking.

For players, it prioritizes actual visual roots such as PlayerHealth.meshParent and PlayerAvatarVisuals.meshParent.

For enemies, it prioritizes EnemyHealth.meshParent.

For physical objects, it collects renderer groups from the actual object hierarchy.

For ItemOrbZeroGravity itself, the renderer subtree under sphere effect/AreaEffect is excluded so the outer

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
DroneEffectAuraOverlay-1.0.0.zip
File size
112.3 KiB