EnemyValuableTweaks
Tweaks the EnemyValuable (orb) to make it a little more fair and interesting. Fully configurable.
| Last updated | a week ago |
| Total downloads | 7668 |
| Total rating | 4 |
| Categories | Mods Valuables Monsters Client-side Server-side |
| Dependency string | BLOKBUSTR-EnemyValuableTweaks-1.0.2 |
| Dependants | 2 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
EnemyValuableTweaks
This mod introduces various mechanical tweaks to the Enemy Valuable (the pink soul orb that drops from killed enemies) to make it a little more fair and interesting in certain scenarios.
You wanna know what my first motivation for this mod was? You know those moments when you put so much effort into dealing with an enemy, and you decide to throw it down a pit, only for the orb to bounce everywhere and break on its own without giving you a single chance to get anywhere close to catch it? Yeah, I know it too well because it happened WAY TOO MANY TIMES to me. So, I decided to make this mod as my own solution. On top of that, I figured it would be nice to implement some extra functionality to make the orb a little more interesting from vanilla gameplay.
❗️ All players must have this mod installed, and all clients must have the same config settings as the host! Otherwise, visual desync at the very least will occur.
❇️ Features
⏲️ Enable, disable, and adjust the length of the indestructible timer duration of the orb.
💨 Automatically disable indestructibility when the orb's velocity slows to a stop. This is intended to cancel the main timer if the orb has already reached a standstill, so that the orb wouldn't remain invincible for longer than it needs to.
👐 Disable indestructibility when a player grabs ahold of it, since at this point the safety of the orb is now in your hands... get it?
🛒 Disable indestructibility when the orb has been placed in a safe area, such as the C.A.R.T. or an extraction point.
🎲 Configure the probability of an orb exploding upon destruction for each Moon Phase! This can add a little more tension and unpredictability when handling orbs.
This mod is extensively configurable, so you can fine-tune the orb's behavior to your liking. The default configs are intended to make a slightly more fair and interesting experience than vanilla without feeling overpowered. If you do want to make it either completely overpowered or brutally unfair, you have all the freedom to do so!
🚧 Roadmap
- Improve multiplayer synchronization
- Automatically edit Moon Phase modifier descriptions to tell current explosion probability
- Ability to configure the amount of orbs that can be dropped per level, and perhaps even per enemy
Suggestions are welcome! Tell me what's on your mind in the Discord Thread.
🔧 Configuration
Configs update immediately, especially while in-game if using RepoConfig.
Click to expand config list:
- Timer
- EnableTimer: Whether to enable the main timer that automatically disables indestructibility once expired. If disabled, the orb will never become destructible unless any of the following additional checks are enabled.
- TimerLength: Time in seconds until the orb loses indestructibility. Vanilla default is 5 seconds.
- Additional Checks
- AdditionalChecksDelay: Time in seconds before all following checks activate after the orb has initially spawned. Will not work if greater than TimerLength. Additional checks take precedence over the main timer, meaning they will cut off the timer early if any one of their conditions have been satisfied.
- Velocity
- EnableVelocityCheck: Automatically disables indestructibility when the orb slows down to the specified velocity threshold.
- VelocityThreshold: The minimum threshold for the velocity check.
- Player Grab
- EnablePlayerHold: Automatically disables indestructibility when the orb is grabbed by a player.
- PlayerHoldTime: Time in seconds that a player must continue holding onto the orb before indestructibility is disabled. Resets when the player lets go, so that it will not prematurely become destructible if the player gets distracted by something else. Can be set to 0 to immediately disable indestructibility.
- Safe Areas
- EnableSafeAreaCheck: Disables indestructibility if the orb has been placed inside a safe area, such as the C.A.R.T. or an extraction point.
- SafeAreaTime: Time in seconds that the orb must remain in a safe area to disable indestructibility. Works exactly like PlayerHoldTime.
- Moon Phase Explosion Probability
- InitialExplosionProbability: The probability of orbs exploding at the start of a new game, before any moon phases have even taken effect.
- CrescentMoonExplosionProbability: The probability of orbs exploding during the Crescent Moon phase, beginning on Level 5.
- HalfMoonExplosionProbability: The probability of orbs exploding during the Half Moon phase, beginning on Level 10.
- FullMoonExplosionProbability: The probability of orbs exploding during the Full Moon phase, beginning on Level 15.
- SuperMoonExplosionProbability: The probability of orbs exploding during the Super Moon phase, beginning on Level 20.
- Debug
- EnableDebugTimerLogs: Enable debug logs for this mod's timers. "Debug" or "All" must be included in Logging.Console.LogLevels in the BepInEx config to be able to see these logs. Note that this will create a lot of spam in the console, so please keep this disabled for normal gameplay!
- EnableDebugGeneralLogs: Enable debug logs for other calculations and logic performed by this mod.
⚠️ Compatibility
This mod may potentially conflict with other mods that extensively patch the Start() and Update() methods of EnemyValuable.
❤️ Acknowledgements
- Huge thanks to OrigamiCoder and Omniscye in the R.E.P.O. Modding Server for helping me get started with modding, and for guiding me through the making of this mod!
Please report any issues on GitHub or the Discord Thread.
