> For the complete documentation index, see [llms.txt](https://neo-soft-entertainment.gitbook.io/replicated-explosion-plugin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://neo-soft-entertainment.gitbook.io/replicated-explosion-plugin/readme.md).

# Replicated Explosion Plugin

A server authoritative explosion component for Unreal Engine multiplayer games, with optional Gameplay Ability System damage and chain reactions.

An explosion system for Unreal Engine multiplayer games. Add one component to any actor, point it at a data asset, and call `Explode` on the server. The server finds who is in range, applies falloff damage, and every client plays the effects.

Describe each explosion in a data asset. Put a component on your barrel, grenade or mine. Optionally route the damage through your own Gameplay Effect, and let nearby explosives chain.

{% hint style="info" %}
Official support: <https://discord.gg/HA2CBfdCFT>
{% endhint %}

## Start here

{% content-ref url="/pages/NwQFJN4zRI7TDTl2EJKM" %}
[How it works](/replicated-explosion-plugin/start-here/how-it-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/MrsI4nS5BMS1NqQJRwwv" %}
[What you get](/replicated-explosion-plugin/start-here/what-you-get.md)
{% endcontent-ref %}

{% content-ref url="/pages/P5wFW7PpHVEQWbQyaK4a" %}
[Install and requirements](/replicated-explosion-plugin/start-here/install.md)
{% endcontent-ref %}

{% content-ref url="/pages/foIykU4sALJC6Buoavsd" %}
[Core concepts in 5 minutes](/replicated-explosion-plugin/start-here/core-concepts.md)
{% endcontent-ref %}

{% content-ref url="/pages/K1VRldp0zrFCTMeRJdn9" %}
[Your first explosion](/replicated-explosion-plugin/start-here/your-first-explosion.md)
{% endcontent-ref %}

{% hint style="info" %}
**New to the plugin?** Read [Core concepts in 5 minutes](/replicated-explosion-plugin/start-here/core-concepts.md), then build [Your first explosion](/replicated-explosion-plugin/start-here/your-first-explosion.md). Everything else assumes you know those two.
{% endhint %}

## What it does

|                          |                                                                                        |
| ------------------------ | -------------------------------------------------------------------------------------- |
| **Server authority**     | Damage is decided on the server. Clients can only request, and the server validates    |
| **Data driven**          | Radius, damage, falloff, effects and chain rules live in one `UNeoExplosionData` asset |
| **Falloff**              | Linear, quadratic, exponential or your own curve, between an inner and an outer radius |
| **Two damage paths**     | A Gameplay Effect for GAS targets, or `ApplyPointDamage` for everything else           |
| **Immunity and filters** | Skip targets by gameplay tag, or require tags to be affected                           |
| **Chain reactions**      | Nearby explosive actors detonate after a delay, with a hard depth limit                |
| **Effects everywhere**   | Niagara, light flash, decal, sound and camera shake play on every client               |
| **Late join recovery**   | Clients that join after the blast replay the effects from replicated state             |
| **Editor tooling**       | Radius preview on the asset, a viewport visualizer and a content browser asset type    |

## What comes in the box

**The plugin.** A Runtime module, `ReplicatedExplosionPlugin`, with a Blueprint API for everything you use day to day, and an Editor module, `ReplicatedExplosionPluginEditor`, with the asset tooling.

**No demo content.** The plugin does not ship a demo map. [Your first explosion](/replicated-explosion-plugin/start-here/your-first-explosion.md) builds a working test in about ten minutes.

## Requirements

|                    |                                                                                              |
| ------------------ | -------------------------------------------------------------------------------------------- |
| **Plugin version** | 3.0                                                                                          |
| **Platforms**      | Win64 (the Runtime module allow list)                                                        |
| **Language**       | C++ module with a Blueprint API                                                              |
| **Network modes**  | Standalone, listen server, dedicated server                                                  |
| **Dependencies**   | Engine `GameplayAbilities` plugin (required), `Niagara` plugin (optional in the plugin file) |

## Links

* Support: [Discord](https://discord.gg/HA2CBfdCFT)
* [Changelog](/replicated-explosion-plugin/updates/changelog.md)
* [FAQ](/replicated-explosion-plugin/resources/faq.md)
* [Troubleshooting](/replicated-explosion-plugin/resources/troubleshooting.md)