Weapon & Passive System - Complete Roguelike Framework

Build a complete auto-attack combat system in minutes — no coding required to get started.

WHAT'S INCLUDED

► 4 WEAPON TYPES

• Projectile — homing, boomerang, bouncing, pierce, gravity arc, spiral

• Melee — orbiting objects with configurable arc, radius, and rotation speed

• Area — damage zones with grow-over-time, follow-player, heal, chain reactions

• Slash — directional arc sweeps aimed at the nearest enemy

► PROJECTILE BEHAVIORS

Homing, Boomerang (spins + returns), Bouncing (ricochets between enemies),

Gravity Arc (ThrowUp targeting), Split-on-impact, Explosion-on-impact

► PASSIVE ITEM SYSTEM

17 stat multipliers: damage, attack speed, range, projectile speed, area size,

duration, move speed, health, regen, damage reduction, crit, XP, revival, and more.

Stacking multiplicative model — multiple passives combine correctly.

► UPGRADE SYSTEM

Per-level stat deltas + behavior overrides + weapon evolution chains.

Three rarity tiers: Common, Rare, Unique (color-coded in inspector).

maxLevel = 0 for unlimited upgrades.

► OBJECT POOL SYSTEM

Zero Instantiate/Destroy calls in hot paths. WeaponPoolManager pools all

projectiles, area effects, and slash attacks. Prewarm() support.

Falls back to Instantiate/Destroy automatically if no pool is in the scene.

► PERFORMANCE

EnemyRegistry singleton replaces FindGameObjectsWithTag — O(1) enemy lookup,

no per-frame scene scans.

► EDITOR TOOLS

• One-click Demo Scene Builder — playable scene with all 4 weapon types in seconds

• Setup Wizard — visual form for creating weapons and passives without touching code

• Custom WeaponData inspector with live DPS calculator and type-specific warnings

• Custom PassiveItemData inspector with live percentage display and Quick Presets

• Duplicate and Create Upgrade buttons for fast iteration

► INTEGRATION

Clean namespace (WeaponPassiveSystem), assembly definitions, and example

implementations for all dependency scripts (PlayerHealth, EnemyAI, EnemyHealth,

EnemyDebuff, PlayerMovement). Drop into any 2D top-down project.

REQUIREMENTS

• Unity 2022.3 LTS or Unity 6+

• Unity Input System package

• 2D physics (included with Unity)

DOCUMENTATION

Full setup guide, API reference, editor tools guide, and quick-start examples included.