Hunter Enhancements Mod by PlusBlankPlus

Is the Hunter's constant firing getting predictable? This mod introduces tactical depth by giving the Hunter limited ammo, variable reload speeds, and several optional behaviors like interrupting reloads on damage, retreating while vulnerable, and a devastating minigun mode. Make the Hunter encounters more dynamic and challenging!

Support

Added - * https://thunderstore.io/c/repo/p/FNKT_Labs/BerserkerEnemies/ BerserkerEnemies

Features

• Reload Mechanic & Skills: Hunters no longer fire indefinitely.

  • Skill Levels: Each Hunter spawns with a random Reload Skill (Fast, Medium, or Slow), determined by configurable weights.
  • Variable Reload Times: Reload speed depends on the Hunter's skill (e.g., Fast might take 2s, Medium 5s, Slow 7s by default - all configurable).
  • Vulnerability: Hunters cannot shoot while reloading, providing strategic openings.

• Damage Interrupt (Optional): Punish careless attacks!

  • If enabled, hurting a Hunter while it's reloading cancels the reload.
  • A configurable delay is imposed before the Hunter can attempt to reload again. Don't let it recover easily!

• Run Away While Reloading (Optional): Smart Hunters stay safe.

  • If enabled, the Hunter will actively try to move away from players while reloading, seeking cover using the NavMesh.

• Total Ammo Limit (Optional): Make every shot count.

  • If enabled, Hunters have a finite total ammo supply.
  • Once out of ammo, the Hunter will attempt to leave the area permanently and will not re-engage.

• Minigun Mode (Optional): Unleash suppressive fire!

  • If enabled, replaces the standard shot with a rapid burst (default 10 shots).
  • Shot count and delay between shots are configurable. Great for area denial!

• Berserker Enemies Compatibility:

  • Detects if FNKTLabs' Berserker Enemies mod is active.
  • If a Hunter is chosen as the Berserker, this mod automatically disables the Total Ammo Limit for that specific Hunter to prevent conflicts (unkillable enemies shouldn't run out of ammo). Other features remain active.

Configuration

Customize the enhanced Hunter! After running the game once with the mod, edit the configuration file at:

BepInEx/config/com.plusblankplus.huntermod.cfg

Available options:

[A. General]

• EnableMinigunMode: Boolean (true/false) - Toggles the rapid-fire minigun mode. (Default: false)
• MinigunShots: Integer - Number of shots in a minigun burst. (Default: 10, Range: 1-50)
• MinigunShotDelay: Float - Delay (seconds) between minigun shots. (Default: 0.1, Range: 0.02-0.5)

[B. ReloadTimes]

• FastReloadTime: Float - Reload time (s) for 'Fast' skill Hunters. (Default: 2.0, Range: 0.5-120)
• MediumReloadTime: Float - Reload time (s) for 'Medium' skill Hunters. (Default: 5.0, Range: 1-180)
• SlowReloadTime: Float - Reload time (s) for 'Slow' skill Hunters. (Default: 7.0, Range: 1.5-300)

[C. SkillWeights] (Higher number = more likely)

• FastSkillWeight: Integer - Probability weight for 'Fast' skill. (Default: 5, Range: 1-100)
• MediumSkillWeight: Integer - Probability weight for 'Medium' skill. (Default: 3, Range: 1-100)
• SlowSkillWeight: Integer - Probability weight for 'Slow' skill. (Default: 1, Range: 1-100)

[D. DamageBehavior]

• EnableDamageInterrupt: Boolean - If true, damage cancels reload and adds a delay. (Default: true)
• DamageInterruptDelay: Float - Delay (s) after reload is interrupted. (Default: 5.0, Range: 0.5-15)
• RunAwayWhileReloading: Boolean - If true, Hunter moves away while reloading. (Default: true)

[E. TotalAmmo]

• EnableTotalAmmoLimit: Boolean - If true, Hunter has limited shots before leaving permanently. (Default: false)
• TotalAmmoCount: Integer - Total shots if limit is enabled. (Default: 30, Range: 1-200)

[Z. Logging]

• EnableErrorLogging: Boolean - Allow this mod to write ERROR messages to the log. (Default: true)
• EnableWarningLogging: Boolean - Allow this mod to write WARNING messages to the log. (Default: true)

Installation

1. Install BepInEx: Ensure BepInEx 5 is installed for your game.
2. Download: Get the latest Hunter_Enhancements.zip file.
3. Install via Mod Manager (Recommended):
   • Use r2modman or Thunderstore Mod Manager. Import the zip file or install directly from the mod page.
4. Install Manually:
   • Extract the Hunter_Enhancements.zip file.
   • Place the BepInEx folder from the zip into your game's root directory (where the game executable, e.g., REPO.exe, is located). Merge folders if prompted.
5. Run Game: Launch the game to generate the config file. Edit as desired.

Changelog

• 1.0.3: Added Berserker Enemies compatibility.
• 1.0.2: Fixed bug with minigun mode.
• 1.0.1: Mod added.

Enjoy the enhanced hunt!🤗👺🔫

Changelog

[1.0.10] - Minigun animation hotfix.

• Fixed Minigun Animation: The minigun animation was not playing correctly.(fixed...?)

[1.0.10] - Multiplayer Synchronization Overhaul

• Fixed Major Multiplayer Desync Issues: Completely overhauled the network synchronization logic for all mod features. Hunter state (ammo count, reloading status, reload skill, out-of-ammo status, minigun active status, interrupts) should now be consistent between the host (MasterClient) and all connected clients.
• Implemented MasterClient Authority: All decisions regarding ammo usage, starting/interrupting reloads, and running out of ammo are now authoritatively handled by the MasterClient.
• Added Proper Network State Sync: Utilized Photon's IPunObservable (OnPhotonSerializeView) to regularly synchronize the Hunter's core modded state across the network.
• Added RPCs for Key Events: Implemented Remote Procedure Calls (RPCs) to ensure reliable and timely communication of initial state (like assigned reload skill and ammo on spawn, including for late joiners) and important events (like reload start/interrupt notifications).
• Synced Reload Skill: Hunters should now consistently have the same reload skill (Fast/Medium/Slow) assigned for all players in the lobby.
• Reliable Damage Interrupts: The damage interrupt feature should now function correctly and consistently in multiplayer sessions.
• Consistent Ammo Tracking: Total ammo limits and current ammo counts should now be accurately tracked and synced for all players.
• Internal Code Refactoring: Significant changes to HunterAmmoTracker.cs, HunterPatches.cs, and Plugin.cs to support the new synchronization model.
• Fixed Compiler Errors: Resolved various compiler errors related to reflection and missing return paths identified in previous debugging steps.

[1.0.9]

• Again Multiplayer issues fixed(Final version).

[1.0.8]

Fixed

• Fixed Hunter getting stuck in an endless 'Leave' state loop when permanently out of ammo (isOutOfAmmoPermanently was true). The Hunter will now correctly transition to the Despawn state after reaching its current Leave destination or timing out in the Leave state, instead of trying to find new retreat points indefinitely.
• Optimized internal reflection helper (GetEnemyNavMeshAgent) to resolve potential log spam by removing unnecessary checks for the game's internal NavMeshAgent component.
• Refined the logic in StateLeavePrefix to more clearly differentiate between running away while reloading (which uses the stuck counter) and being permanently out of ammo (which now leads directly to Despawn).

[1.0.7]

• Added semi-compatibility to LastStand mod.

[1.0.6]

• Photon Fixes(Multiplayer issues).

[1.0.5]

Added

• Optional Total Ammo system.
• Optional Ammo Renewal system with configurable timer range.
• Optional Aim Modes: Default, MinigunAccuracy, SniperAccuracy (configurable).
• Hunter now runs away (enters Leave state) if reloading (configurable) or waiting for ammo renewal.
• Hunter runs away permanently if Total Ammo is enabled but Renewal is disabled.

Fixed

• Resolved various CS1061 and CS0246 compiler errors related to NavMeshAgent access and namespace visibility.
• Fixed PlayerAvatar.IsDead() check in retreat logic.
• Prevented Hunter from getting stuck in corners when running away by forcing Leave state and continuously finding new retreat points.
• Corrected logic for Sniper Mode approach behavior.

[1.0.4]

• Reloaded the mod with new manifest.

[1.0.3]

Added

• Added compatibility check for FNKTLabs' Berserker Enemies mod. Automatically disables Total Ammo Limit for Berserk Hunters.

[1.0.2]

Changed

• Reworked Minigun Mode logic to use an internal timer within StateShoot.

Added

• Added MinigunShotDelay configuration.

Fixed

• Addressed Minigun mode getting stuck.

[1.0.1]

Added

• Initial Release of Hunter Enhancements.
• Features: Limited Ammo per reload cycle, Reload Skills (Fast/Med/Slow), Reload speed varies by skill, Damage Interrupts Reload (Optional), Minigun Mode (Optional).

Fixed

• Fixed initial compiler errors related to accessing private members.