Return By Death

A Re:Zero-inspired personal cereal upgrade for R.E.P.O.

Eat once. Return once per level. Three tiers: 1 / 50 / 100 HP.

How it works

• Buy RETURN BY DEATH cereal in the shop. Regular price starts at $25,000; normal shop discounts still work.

• Eating it permanently grants that player one automatic resurrection per playable level.

• After death, you return to the truck with 1 / 50 / 100 HP after the first / second / third cereal. Health is capped at your maximum HP. The charge refreshes on the next level.

• A second and third box improve revival health, not the number of returns. Three tiers maximum; further consumption is blocked.

• Handles death-pit falls by moving the death head to the truck before revival.

• Delays a last-player game over while a valid resurrection is pending, with a bounded timeout.

• Inventory follows the normal game death rules.

• Custom Subaru cereal artwork and an atmospheric return sound, played for the owner both on consumption and resurrection.

Installation

Install with a Thunderstore-compatible mod manager. Requires BepInExPack 5.4.2305 and REPOLib 4.3.0.

All players need this mod and its dependencies. Resurrection decisions are made by the host.

Manual installation: place ReturnByDeath.dll in BepInEx/plugins/sqyan-ReturnByDeath/ and restart the game.

Testing and compatibility

Built against R.E.P.O. v0.5.1. Basic gameplay was tested locally by the author. Automated checks cover charge accounting (19 tests), 11 Harmony patch targets and embedded assets. Multiplayer, host migration and all edge cases have not been exhaustively tested. This is an early release.

Optional testing tool: RepoCommandConsole. Open F2 and run /spawn "item:RETURN BY DEATH" 1 player-location. The console is not a dependency and is not bundled.

Credits

• Mod: sq_yan.

• Re:Zero / Subaru Natsuki belong to their respective creators and rights holders. Unofficial fan mod; no affiliation or endorsement.

• Custom cereal artwork generated with AI.

• Sound source: Return By Death on Myinstants, with filtering, echoes and fade processing. Third-party audio is not covered by the code license.

• REPOLib for item and upgrade registration.

• SelfReviveUpgrade studied as an API reference. Its code and DLL are not bundled.