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.