🦝🦆 Raccoon vs Duck Power-Up System

📊 System Overview

11

Unique Power-Ups

8

Core Scripts

3,500+

Lines of Code

15k+

Words of Docs

🎮 Player Controls

General Controls

1 2 3 - Use power-up in slots
Tab - Toggle inventory UI

Duck Controls

T - Place trap (when Trap Setup active)

When Trapped

Space - Struggle to escape (press repeatedly)
E - Rescue teammate (hold near trapped player)

🦝 Raccoon Power-Ups (Exploration & Evasion)

🟢

Night Vision

Enhances vision in dark areas. Increases FOV radius by 50 units and multiplies brightness by 2x. Perfect for navigating dark mazes.

🔵

Double Grab Bag

Grab two items in one round (one-use). Doubles collection efficiency for completing tasks faster.

🟣

Inverse Climbing

Move 2x faster when controls are inverted (10s duration). Counter duck sabotage with enhanced mobility.

🟡

Maze Footprints

Shows visual path to nearest objective. Yellow footprints guide you through complex mazes.

🟠

Trap Escape (RARE)

Escape from traps 3x faster. Instant-use power-up for emergency situations.

🦆 Duck Power-Ups (Sabotage & Control)

🔷

Camouflage (RARE)

Become semi-transparent and invisible to AI for 8 seconds. Perfect for stealth ambushes.

🔴

Guard Mode

Slow nearby raccoons by 50% for 15 seconds. Creates 8-unit detection radius for area control.

🟣

Clone Spawner (RARE)

Spawn 3 AI decoy clones for 20 seconds. Creates confusion and misdirection.

⚪

Egg Drop (RARE)

Drop 5 eggs from sky to slow players. 15-unit radius, slows hit players 50% for 3 seconds.

🟡

Footprint Vision

See raccoon footprints for 15 seconds. Track and intercept raccoon movements.

🔺

Trap Setup

Place 3 traps on the map. Press T to place. Caught raccoons must escape or be rescued.

🪤 Trap System

How It Works

Duck uses "Trap Setup" power-up
Press T to place trap (max 3)
Trap arms after 0.5 seconds (turns yellow)
Raccoon steps on trap → Gets caught in cage
Escape Options:
- Self-Escape: Press Space repeatedly (5 seconds)
- Rescue: Teammate holds E nearby (3 seconds)
- Power-Up: Trap Escape ability = 3x faster

✨ Key Features

Modular Design - Easy to extend with new power-ups
Role-Based System - Raccoon/Duck specific abilities
Rarity System - 80% common, 20% rare drops
3-Slot Inventory - With keyboard shortcuts
Full UI System - Inventory display & active effects
Automatic Spawning - Configurable rates & positions
Visual Effects - Colors, animations, glows
Trap & Rescue - Complete mechanics
Network-Ready - Designed for multiplayer
One-Click Setup - PowerUpSystemSetup helper

🔧 Quick Setup (Unity)

Add PowerUpSystemSetup component to GameObject

Assign raccoon/duck player references in Inspector

Check "Setup On Start"

Play scene - automatic configuration!

Alternative: Right-click component → "Setup Power-Up System" for instant setup!

📚 Documentation

📖 Documentation Index ⚡ Quick Reference 📋 Complete Manual

🔧 Implementation Guide 🎨 Visual Diagrams 💻 Source Code

📂 Implementation Files

Assets/Scripts/PowerUps/

├── PowerUpBase.cs              # Base class

├── RaccoonPowerUps.cs          # 5 raccoon abilities

├── DuckPowerUps.cs             # 6 duck abilities

├── TrapSystem.cs               # Trap mechanics

├── PowerUpSpawner.cs           # Spawning system

├── PowerUpInventory.cs         # Player inventory

├── PowerUpInventoryUI.cs       # UI system

└── PowerUpSystemSetup.cs       # Setup helper

⚙️ Technical Specifications

~3,500+ lines of production-ready C# code
20+ classes with full XML documentation
Event-driven architecture
Performance optimized (minimal Update() loops)
Memory-efficient data structures
Network-ready (sync points identified)
Object cleanup and pooling ready
Role-based access control

🦝🦆 Power-Up System