Getting Started
Getting Started
🧠 How It Works
The Modular Weapon System allows you to create fully customizable weapons by assembling modular components. You can configure:
- Weapon: The core controller that handles firing input and state.
- Barrel: Defines the shooting behavior (raycast, projectile, shotgun, laser…).
- Magazine: Controls ammo logic (bullet-based, rechargeable…).
- Recoil: Adds recoil feedback with customizable spray patterns.
- Damage System: Supports hitboxes, health, and explosion damage.
You simply create a prefab of your 3D model, assign the relevant scripts, customise it, and you’re good to go.
Note
Everything is extensible , so you can make more shooting behaviors if you need to
📦 What’s Included
- ✅ 5 fully functional demo weapons (Pistol, Shotgun, Grenade Rifle, Rocket Launcher, Laser Gun)
- ✅ Configurable Weapon components: Weapon, Barrels, Magazines, Recoil
- ✅ Health & damage support: Health, DamageData, Hitboxes
- ✅ Example scenes with prefabs, animations, VFX, and SFX
- ✅ Support for standard, URP and HDRP
- ✅ Easy-to-extend C# codebase
⚙️ Installation
Import the Core Package
Drag the main.unitypackage
into your Unity project or import it from the Asset Store.Set Up SRP Support (URP or HDRP)
- Navigate to
Assets/ModularWeaponSystem/SRPSupport/
- Double-click either
URP_Support.unitypackage
orHDRP_Support.unitypackage
ℹ️This automatically updates materials for your render pipeline.
- Navigate to
Set Up Layers (Recommended)
- Configure Unity Layers for:
- Bullets / Projectiles
- Damageable Targets
- Raycast filtering (for lasers or hit detection)
- Configure Unity Layers for:
Explore the Demo Scene
- Open
Assets/ModularWeaponSystem/Examples/Blueprint.unity
to see everything in action.
- Open
Create Your Own Weapon
- Use the sample prefabs or build from scratch with
Weapon
,Barrel
,Magazine
, and other modules.
- Use the sample prefabs or build from scratch with