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/umbreon222/LastStand/ LastStand

Added - * https://thunderstore.io/c/content-warning/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/OOA (Optional): Smart Hunters (or panicked ones) stay safe.

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

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

  • If enabled, Hunters have a finite total ammo supply.
  • Ammo Renewal (Optional): If enabled (default), Hunters will run away when OOA and eventually renew their ammo after a random time (configurable range). If disabled, they run away permanently.

• Aim Modes (Optional): Choose the Hunter's deadliness!

  • Default: Uses the game's standard aiming logic.
  • MinigunAccuracy: Tighter spread for minigun mode.
  • SniperAccuracy: Pinpoint accuracy. Hunter may walk closer before firing (no shooting through walls).

• 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)
• HunterAimMode: Enum (Default, MinigunAccuracy, SniperAccuracy) - Accuracy mode. (Default: Default)

[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. Behavior]

• 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/waiting for ammo. (Default: true)

[E. TotalAmmo]

• EnableTotalAmmoLimit: Boolean - If true, Hunter has limited shots. (Default: false)
• TotalAmmoCount: Integer - Total shots if limit is enabled. (Default: 30, Range: 1-200)
• EnableAmmoRenewal: Boolean - If total limit is enabled, should ammo regenerate after running out? (Default: true)
• AmmoRenewalTimeMin: Float - Minimum time (s) to wait before renewing ammo. (Default: 10.0, Range: 5-60)
• AmmoRenewalTimeMax: Float - Maximum time (s) to wait before renewing ammo. (Default: 30.0, Range: 5-120)

Installation

1. Install BepInEx: Ensure BepInEx 5 (using the specific pack listed in dependencies) is installed for your game.
2. Download: Get the latest Hunter_Enhancements_v1.0.5.zip file (or the appropriate version).
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 downloaded zip file.
   • Place the BepInEx folder from the zip into your game's root directory (where the game executable is located). Merge folders if prompted.
5. Run Game: Launch the game to generate the config file. Edit as desired.

Dependencies

• BepInExPack (Version listed in manifest.json, e.g., BepInEx-BepInExPack-5.4.2100)

Changelog (Recent)

• 1.0.4: Added Ammo Renewal, Aim Modes, Run Away logic, various fixes & config options. (Corresponds to latest code version 1.5.1)
• 1.0.3: Added Berserker Enemies compatibility.
• 1.0.2: Fixed bug with minigun mode.
• 1.0.1: Initial Release.

Enjoy the enhanced hunt!🤗👺🔫

Changelog

[1.2.3]

• Falling back to stable versions of the mod.*

[1.2.1] - Fixes - tested in single mode.

• Fixes.
• Added previews.

[1.2.0] - Fixes - new features - tested in single mode.

• Many fixes and improvements.
• Added dynamic sound when huntsman walking.(experimental)

[1.0.13] - Hotfix for testing, consider use older versions, check working versions and tell me what works and what doesn't.

• Infinity huntsman shooting(fixed?)

[1.0.12] - GitHub Open Source.

• Open Source on GitHub now!

[1.0.11] - 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.