SummonSnapshot

# Summon Snapshot

**Give your summons more than just a fighting chance.**

Summon Snapshot is a Risk of Rain 2 mod that expands the capabilities of certain player-created summons by allowing them to inherit items and utilize equipment from their owner.

The goal is to make summons feel like meaningful extensions of the player's build, rather than disposable allies with limited scaling.

Whether you're deploying REX's Proliferation Offshoots or Engineer's turrets, Summon Snapshot aims to make your equipment choices matter beyond your own survivor.

## Features

### REX — Proliferation Offshoots

REX's Proliferation Offshoots receive a snapshot of their owner's eligible items and currently selected equipment when summoned.

- Inherit eligible item stacks from their owner.

- Benefit from compatible offensive, defensive, and utility item effects.

- Receive the owner's selected equipment, subject to safety restrictions.

- Automatically attempt to activate supported equipment when ready.

- Preserve their inherited loadout independently of later player inventory changes.

Item inheritance is applied when the summon is initialized. Existing Offshoots are not continuously synchronized with the player's inventory.

### Engineer — Turret Equipment

Engineer turrets gain the ability to use their owner's selected equipment automatically.

- Receive the owner's selected equipment when deployed.

- Automatically attempt to activate supported equipment when ready.

- Continue using reusable equipment as cooldowns become available.

- Support standard Engineer turret variants recognized by the mod.

Engineer's normal turret item inheritance remains handled by the game. Summon Snapshot focuses on extending their equipment functionality.

### Squid Polyp — Item Inheritance

Squid Polyp turrets receive eligible items from their owner's inventory when summoned.

- Inherit eligible item stacks at spawn.

- Benefit from compatible item effects.

- Exclude certain summon-generating items to reduce recursive spawning.

Automatic equipment activation is not currently provided for Squid Polyp turrets.

## Equipment Automation

Summon Snapshot provides automatic equipment activation for supported summons.

Once equipped, eligible summons periodically check whether their equipment can be activated.

When an equipment item is ready, the summon attempts to use it through the game's equipment system.

**Important considerations:**

- Equipment activation is automatic and does not require player input.

- Reusable equipment can activate again after its cooldown expires.

- Equipment that requires specific targets or activation conditions may not function in every situation.

- Equipment is inherited when the summon is created, rather than updated continuously.

- Equipment Coupler's additional equipment slots are not yet supported.

### Goobo Jr. — Safety Restriction

Goobo Jr. is intentionally excluded from automatic summon equipment activation by default.

Allowing summons to duplicate themselves can create recursive spawning loops, resulting in excessive ally counts, severe performance degradation, or unstable gameplay.

This restriction prioritizes reliable gameplay over unrestricted equipment interactions.

Players can still use Goobo Jr. normally on their own survivor.

## Item Inheritance and Safety

Summon Snapshot copies eligible permanent item stacks from the summoning player's inventory.

To reduce unintended interactions, the mod includes safeguards for:

- Recursive summon generation.

- Nested summons inheriting additional inventories.

- Certain items capable of creating further allied entities.

- Equipment-driven duplication loops.

- Repeated initialization of the same summon.

Not every item or modded item is guaranteed to work correctly on every summon. Item effects depend on the receiving summon and the underlying game's behavior.

## Configuration

The mod provides BepInEx configuration options for supported summon types and equipment behavior.

| Setting | Default | Description |

|---|---|---|

| RexFlowers | Enabled | Enable item and equipment inheritance for REX Offshoots |

| EngineerEquipment | Enabled | Enable automatic equipment functionality for Engineer turrets |

| SquidPolyp | Enabled | Enable item inheritance for Squid Polyp turrets |

| CheckIntervalSeconds | 0.25 | How frequently supported summons check equipment readiness |

Additional safety options may be available depending on the installed build. For normal gameplay, the default safety settings are recommended.

## Version History

### v0.2.0 — Stability and Equipment Automation

**Current Release**

A major stability-focused update addressing equipment behavior and recursive summon generation.

- Improved automatic equipment activation for supported summons.

- Confirmed repeated equipment use when cooldowns become available.

- Added safer item inheritance filtering to reduce summon multiplication.

- Restricted Goobo Jr. activation on summons by default.

- Strengthened protections against nested summon inheritance.

- Retained support for REX Offshoots, Engineer turrets, and Squid Polyps.

- Continued improvements to diagnostic logging and summon initialization.

### v0.1.9 — Equipment Prefab Initialization

- Introduced equipment-slot initialization on supported summon body prefabs.

- Addressed missing equipment components that previously prevented activation.

- Improved compatibility with the game's networking requirements.

- Continued testing of REX Offshoot and Engineer turret equipment functionality.

### v0.1.8 — Diagnostics and Troubleshooting

- Expanded diagnostic logging for summon initialization.

- Added equipment-slot detection and reporting.

- Identified why certain summons could inherit equipment but could not activate it.

- Avoided dynamically adding networked equipment components to already spawned summon bodies.

### v0.1.7 — Clone Protection Improvements

- Improved detection of Goobo Jr. clones.

- Added additional protections against recursive equipment activation.

- Refined nested summon handling.

- Cleaned up obsolete API warnings in the development build.

### v0.1.4–v0.1.6 — Summon Inheritance Development

- Expanded item and equipment inheritance for REX Proliferation Offshoots.

- Improved detection of supported summon types.

- Developed safeguards for duplicated and nested summons.

- Refined equipment activation and initialization behavior through testing.

### v0.1.1–v0.1.3 — Early Equipment Experiments

- Developed automatic equipment activation for Engineer turrets.

- Successfully tested equipment activation with Disposable Missile Launcher.

- Investigated equipment-slot and networking limitations.

- Established the foundation for extending equipment functionality to additional summons.

### v0.1.0 — Initial Release

- Established the Summon Snapshot plugin.

- Introduced the core concept of snapshot-based summon inheritance.

- Began support for REX Offshoots, Engineer turrets, and Squid Polyps.

## Development Roadmap

Summon Snapshot is an actively evolving project. Future updates will focus on expanding summon compatibility while maintaining predictable behavior and multiplayer stability.

### Planned — Equipment Coupler Compatibility

Support for equipment systems that provide multiple equipment slots.

Potential functionality includes:

- Detecting additional equipment slots.

- Allowing compatible summons to inherit multiple equipment selections.

- Managing activation behavior for multiple equipped items.

- Preventing conflicting or recursive equipment interactions.

### Planned — Artifact of Devotion Integration

Expand functionality for Lemurian allies created through the Artifact of Devotion.

The intended system would allow players to donate equipment to Lemurian Eggs, enabling their resulting allies to use that equipment.

Development goals include:

- Equipment donation through Lemurian Eggs.

- Persistent equipment assignment for the resulting allies.

- Automatic activation of compatible equipment.

- Compatibility testing with other Artifact of Devotion modifications.

### Under Consideration — Expanded Summon Support

Explore additional player-created allies that could benefit from item inheritance or equipment functionality.

Any additional summon types will require individual compatibility and balance testing.

### Long-Term — Improved Compatibility and Customization

- More granular item inheritance rules.

- Per-summon equipment restrictions.

- Improved compatibility with modded items and equipment.

- Additional safeguards against recursive spawning.

- Better multiplayer reliability and diagnostic tools.

- Expanded configuration options for players who want greater control.

*Roadmap features are development goals, not guaranteed features or release commitments.*

## Known Limitations

- Goobo Jr. is disabled for automatic summon activation by default.

- Equipment Coupler's additional equipment slots are not currently supported.

- Artifact of Devotion equipment donation is not yet implemented.

- Some equipment may fail to activate because of targeting or summon-specific limitations.

- Some modded items may behave unexpectedly when inherited by summons.

- Equipment and item snapshots are taken when a summon is created.

- Multiplayer compatibility requires further testing; all participants should use the same mod version.

## Compatibility

**Game:** Risk of Rain 2

**Mod Framework:** BepInEx

Summon Snapshot is intended for use with compatible BepInEx-based Risk of Rain 2 installations.

Because the mod changes summon inventories and equipment behavior, compatibility with other mods that modify the same systems cannot be guaranteed.

For multiplayer, all participants should install the same version of Summon Snapshot.

## Feedback and Bug Reports

When reporting an issue, please include:

- The installed Summon Snapshot version.

- The summon type involved.

- The items or equipment being used.

- Whether the issue occurred in single-player or multiplayer.

- A BepInEx log, when available.

- Steps to reproduce the issue.

Detailed reports help identify interactions between summons, items, equipment, and other mods.

---

**Summon Snapshot — Your build. Your summons. Their firepower.**