# 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.**

Summon Snapshot — Changelog

A development history of the features, fixes, safeguards, and testing leading to v0.3.5. Earlier experimental builds were part of development; not every intermediate version was published on Thunderstore.

v0.3.5 — Transparency and Description Upgrade

Changed

• Rewrote the Thunderstore README and mod description to explain supported summons, inheritance, automatic equipment use, and the F8 inspector in a more accessible, engaging way.
• Expanded the changelog to document development milestones, tested fixes, safety protections, and known limitations from earlier builds.
• Clarified that REX/Engineer summon limits are informational only and not enforced.
• Clarified that Equipment Coupler extra equipment slots are not supported by the current implementation.
• Kept gameplay behavior unchanged from v0.3.4; this is a documentation and transparency release.

v0.3.4 — Release packaging and settings diagnostics

Changed

• Bumped plugin and Thunderstore package version to 0.3.4.
• Improved built-in default blacklist descriptions, removing unnecessary callouts about allowed items.
• Added more useful diagnostic warnings when Risk of Options cannot construct/register the integer summon-cap sliders.
• Prepared the release package with root-level manifest.json, README.md, CHANGELOG.md, icon.png, and compiled DLL.

Still experimental / not implemented

• REX and Engineer summon-cap settings do not enforce summon limits; no destructive removal is performed when a cap is exceeded.
• Risk of Options registration for the two integer cap controls has not been confirmed fixed in-game.
• Equipment Coupler's additional equipment slots are not copied; the current implementation copies only the selected equipment slot.

v0.3.3 — Inventory synchronization, Operator support, and usability

Summon inheritance

• Added item inheritance for Operator skill drones.
• Added eligible item inheritance for Operator-owned purchased drones and turrets, without equipment copying.
• Added eligible item inheritance for purchased stationary Gunner Turrets for supported owners.
• Added a configurable grounded Gunner Turret tether, with a default 100-meter distance and 10-second check interval. Teleporting requires a valid grounded destination.
• Continued support for REX Offshoots, Engineer equipment activation, and Squid Polyp item inheritance.

Inventory correctness and performance

• Added periodic Operator-owner inventory checks with fingerprints to avoid unnecessary writes.
• Tracked granted inherited stacks so the mod can remove its own inherited items when the owner's eligible inventory changes.
• Corrected inherited-item synchronization after scrapping; playtesting confirmed scrapped items were removed from supported Operator drones.
• Added cleanup for destroyed summon references and tracked inventory state.
• Added an option to avoid redundant inventory updates.

Settings and debugging

• Added optional Risk of Options integration for supported settings.
• Corrected formatting for numeric settings so time, distance, and inspector scale display meaningful units instead of misleading percentages.
• Added an F8 read-only summon inventory inspector that reads actual minion inventories.
• Enlarged the inspector and added configurable scale, with screen-fitting behavior.
• Added extra logging to identify Operator summons, inventory changes, and prefab equipment-slot patches.
• Added experimental REX Offshoot and Engineer turret cap settings, explicitly labeled as not enforced.

Safety and filtering

• Added Warbanner to the default inherited-item blacklist.
• Removed the special default blacklist exclusion of Happiest Mask while retaining the functional exception that allows it to be inherited.
• Maintained default restrictions on summon-spawning/recursive items, hidden items, and selected unsafe equipment behavior.
• Protected inherited Tricorn use pending safe owner-charge handling.

Testing notes

• Confirmed Operator skill drones and purchased Operator-owned drones inherit items.
• Confirmed purchased stationary Gunner Turrets inherit items.
• Confirmed item removal after scrapping and improved settings display in user playtests.
• Logs showed successful plugin loading and REX Offshoot inheritance/equipment activity.
• Logs also showed two Risk of Options integer cap registration failures and unrelated-looking Unity pooling warnings; their causes were not conclusively established.

v0.2.0 — Initial public feature set

• Added REX Proliferation Offshoot inheritance of eligible permanent item stacks and selected equipment.
• Added automatic activation of inherited equipment for supported REX Offshoots and Engineer turrets.
• Added Squid Polyp eligible item inheritance on spawn.
• Patched supported summon body prefabs with equipment slots before network spawning, avoiding unsafe late network-component additions.
• Added Goobo Jr. safeguards against recursive clone chains, including clone identification and nested-summon checks.
• Added configurable equipment polling and safety settings.
• Added inherited-item filtering for dangerous recursive-summon interactions.

Earlier development and testing (pre-v0.2.0)

• Built the first BepInEx plugin and established the com.chronicrick.summonsnapshot plugin identity.
• Iterated through early REX Offshoot item/equipment inheritance prototypes.
• Investigated Goobo clone behavior and added guard logic for clones that share the original Offshoot prefab naming.
• Refined equipment activation checks to avoid network issues and unwanted repeated activation.
• Tested prefab equipment-slot initialization and tracked in-game results through BepInEx logs.

Known limitations in v0.3.5

• Summon-cap configuration is informational only, not enforced.
• Equipment Coupler additional slots are not inherited.
• Integer cap slider registration in Risk of Options needs retesting.
• Multiplayer and large modpack compatibility vary; use the same version across players and report reproducible conflicts with logs.