Dileppy's Weapon Enhancer Mod

A REPO / BepInEx mod by Dileppy

WeaponEnhancer gives you clean, in-game controls for weapon behavior across REPO—primarily ItemGun firearms—plus a dedicated ItemGunLaser section and a Weapon Logic panel for attaching to supported weapons.

Take full control of every firearm in REPO with advanced tuning options for fire rate, accuracy, recoil, damage, explosives, and infinite ammo.

This mod applies globally to all guns that use ItemGun, and includes a clean MenuLib UI inside the REPO "Mods" option in the Menu.

This mod is also designed to be simple to use, safe in multiplayer, and easy to expand over time.

Enjoy!

✨ Features

🔫 Global Gun Tuning (ItemGun-based weapons)

Applies to all weapons using ItemGun:

• Fire rate control
• Accuracy / spread control
• Recoil multiplier
• Damage multiplier
• Explosive hits (visual/physics)
• Bullet modifier (multi-shot per trigger press) (if enabled in your current build)
• Infinite battery / ammo support (toggle)

These changes are intended to affect weapons safely without breaking core battery systems.

🎯 Accuracy Control

• Perfect Accuracy Toggle
  Removes all bullet spread.
• Spread Slider (0–1)
  Controls spread factor when Perfect Accuracy is OFF.
• Recoil Multiplier (0–5)
  Scales gun recoil force and camera shake.

💥 Damage & Explosives

• Damage Multiplier (1×–100×)
  Affects both enemy and player damage caused by gun bullets.
• Explosive Bullets Toggle
  Adds explosion force when bullets hit enemies/objects.
• Explosion Radius Slider
• Explosion Force Slider

🔋 Ammo / Battery

• Infinite Ammo Toggle
  Prevents batteries (ItemBattery) from draining.

🎮 General Options

• Master Mod Enable Toggle
  Instantly enable/disable the entire modification system.

🔥 Laser Section (ItemGunLaser)

Laser weapons behave differently than projectile guns, so they have their own section:

• Laser Tweaks
• Laser Cooldown Between Shots
• Inflict Damage
• Laser Reload Between Shot Speed
• Continuous Fire
• Shot Duration

Laser timing is controlled via a laser-specific state approach to override the typical “~1-3 seconds then stop” behavior.

🧰 Weapon Logic (Connector)

Adds a weapon-focused utility section:

• Connected toggle
• Connects to supported weapon types in-game whether obtained or spawned (guns only)

Notes:

• Behaviour is host / singleplayer only (the game enforces authority for network).
• If you’re not host, the calls will fail gracefully.

....unless

⚙️ Configuration

All settings are available in-game (via REPOConfig) and via config file: BepInEx/config/com.Dileppy.WeaponEnhancer.cfg

🧪 Multiplayer Notes

• Balance changes may affect the lobby depending on what the base game synchronizes.
• Weapon configurations requires host/singleplayer.

📌 Known Limitations

• Not every “weapon-like” entity in REPO uses ItemGun (ex: some CART devices, placed objects, modded turrets).
• Expanding support to those requires per-weapon integration (planned in Phase 2+).

📍 How to Use

1. Launch the game with BepInEx installed.
2. Open the REPO Admin Menu or Empress_Spawn_Browser to spawn in a weapon if you do not have one already.
3. Go to Weapon Enhancer Settings.
4. Adjust sliders and toggles as desired.
   All changes apply instantly and globally.

📦 Installation

Manual Install

1. Download the .zip from Thunderstore.
2. Extract contents into:\BepInEx\plugins\

🧩 Requirements

• BepInEx 5.x
• MenuLib
• REPOLib
• REPOConfig
• Repo Admin Menu or
• Empress_Spawn_Browser

These are usually automatically installed when using a mod manager.

📚 Source Code

The full mod source is included in the source/ folder of the package.

❤️ Credits

• Dileppy — Programming, UI, and REPO integration
• GPT — Code cleanup and system expansion
• REPO Dev Team — Existing gameplay systems and mod hooks
• BepInEx + Harmony
• MenuLib + REPOConfig for UI/config
• REPOLib for item utilities/spawning
• Community tooling & references from Repo modders

📜 License

MIT License.
You may fork, modify, reuse, and redistribute with credit.

Changelog

2.0.0

✨ New

• Added Laser section with dedicated controls for ItemGunLaser behavior:
  • Laser Tweaks
  • Laser Cooldown Between Shots
  • Inflict Damage
  • Laser Reload Between Shot Speed
  • Continuous Fire
  • Shot Duration
• Implemented a laser-specific state approach to extend/override the default “~3 seconds then stop” firing behavior.

🧰 Weapon Logic

• Added Weapon Logic panel (Spawner utilities):
  • New Connected toggle
  • Spawn support for weapon-focused items (guns-only list)

🔁 Changes

• Renamed UI + config keys to match the new terminology:
  • Laser section labels updated for clarity (cooldown, duration, continuous fire, etc.)
  • Spawner section renamed to Weapon Logic
  • “Spawner Enabled” renamed to Connected
• Preserved existing global tuning behavior for ItemGun weapons.

🛠 Fixes

• Clean reintegration of Infinite Battery so battery behavior remains stable while weapon tuning remains active.
• General cleanup for safer expansion and easier future maintenance.

1.1.0

Changes

• Added Bullets Per Shot multiplier (1–20×)
  Allows any firearm to fire multiple bullets simultaneously per trigger pull.
• Fully compatible with existing modifiers:
  • Damage Multiplier
  • Perfect Accuracy
  • Spread / Recoil tuning
  • Infinite Ammo

Fixes

• Improved internal tuning pipeline so bullet multipliers apply reliably across weapon states.
• Strengthened safety around original weapon value caching.
• Removed abandoned code paths for burst/full-auto prototypes.

Improvements

• Refactored WeaponEnhancerMod for clearer structure and easier expansion.
• Optimization pass on Harmony patches and tuning logic.

1.0.1

Fixes

• Resolved C# compiler errors related to unsupported new() shorthand.
• Updated namespace to WeaponEnhancer and plugin class to WeaponEnhancerMod.
• Corrected UI labels still referencing “Handgun Mod”.
• Synced dependency names and identifiers with the Thunderstore package.

Improvements

• Cleaned and organized tuning system internals.
• Improved consistency between config, UI, and gameplay patches.
• Internal optimizations for future features.

1.0.0

Initial Release

• First release of Weapon Enhancer.
• Global enhancement system for all ItemGun weapons.
• Added MenuLib UI in the REPO Admin Menu.
• Included features:
  • Fire Rate slider
  • Infinite Ammo toggle
  • Perfect Accuracy toggle
  • Spread Factor slider
  • Recoil Multiplier slider
  • Damage Multiplier slider
  • Explosive Bullets toggle
  • Explosion Radius slider
  • Explosion Force slider
• Multiplayer-safe and compatible with all base guns.