Dead Drop Delivery - Standalone Edition

A standalone horror delivery game built from scratch in Python with pygame. Navigate through five distinct districts, deliver packages during the day, and survive the monsters that emerge at night.

🎮 Game Features

• Standalone Architecture: No Unity, no external engines - pure Python implementation
• Modular Systems: Delivery, monster AI, upgrades, day/night cycle, and multiplayer
• Five Unique Districts: Each with distinct hazards, monsters, and delivery challenges
• Horror Elements: Dynamic monster spawning, fear system, and atmospheric effects
• Multiplayer Support: Lobby system with up to 4 players
• Upgrade System: Vehicle improvements and special abilities
• Day/Night Cycle: Safe deliveries by day, monster encounters by night

🏗️ Architecture

dead-drop-delivery/
├── engine/                 # Core game engine
│   ├── core/              # Game loop, config, main systems
│   ├── rendering/         # Graphics and camera system
│   ├── input/             # Input management and key bindings
│   └── audio/             # Sound effects and music
├── systems/               # Gameplay systems
│   ├── delivery/          # Package delivery mechanics
│   ├── monsters/          # Monster spawning and AI
│   ├── upgrades/          # Vehicle and ability upgrades
│   └── time/              # Day/night cycle management
├── scenes/                # District scenes and hazards
├── ui/                    # User interface components
│   ├── hud/               # In-game HUD and alerts
│   └── menus/             # Main menu and settings
├── net/                   # Multiplayer networking
│   └── lobby/             # Lobby and session management
├── ai/                    # AI behavior systems
│   ├── behavior/          # Behavior trees for monsters
│   └── pathfinding/       # A* pathfinding system
├── assets/                # Game assets
│   ├── sprites/           # Sprite graphics
│   ├── sounds/            # Audio files
│   └── maps/              # Scene data
└── data/                  # Save files and configuration

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• pip package manager

Installation

1. Clone the repository:

git clone <repository-url>
cd dead-drop-delivery

2. Install dependencies:

pip install -r requirements.txt

3. Run the game:

python main.py

🎯 Game Systems

Delivery System

• Accept contracts from various districts
• Pick up and deliver packages within time limits
• Earn money based on distance, danger level, and performance
• Manage vehicle capacity and fuel consumption

Monster System

• Stalkers: Hunt players relentlessly during night
• Screamers: Alert other monsters to player location
• Crawlers: Block paths and latch onto vehicles
• Lurkers: Distort vision and ambush from shadows
• Mimics: Disguise as delivery points to trap players

Upgrade System

• Engine: Speed, acceleration, and boost abilities
• Armor: Protection from crashes and monster attacks
• Stealth: Noise reduction and cloaking devices
• Utility: Better lights, GPS, and cargo capacity
• Defense: Monster repellents and EMP systems

Districts

• Suburban Sprawl: Quiet streets with hidden dangers
• Downtown Core: Busy traffic and rooftop predators
• Industrial District: Toxic hazards and maze-like layout
• Old Town: Haunted atmosphere with reality distortions
• Outskirts: Dense forests and wildlife encounters

🎮 Controls

• WASD: Move vehicle
• Space: Accelerate
• Shift: Brake
• E: Interact (pickup/deliver packages)
• F: Toggle headlights
• H: Horn
• Tab: Toggle detailed HUD
• M: Open upgrade menu
• Escape: Pause game

🌐 Multiplayer

1. Host Game: One player hosts a lobby
2. Join Game: Other players connect using host's IP
3. Cooperative Play: Work together to complete deliveries
4. Shared Upgrades: Pool resources for vehicle improvements
5. Survival Mode: See who lasts longest against the monsters

🔧 Development

Adding New Monsters

1. Define monster type in systems/monsters/monster_manager.py
2. Create behavior tree in ai/behavior/behavior_tree.py
3. Add monster-specific logic and rendering

Creating New Districts

1. Create scene class in scenes/scene_manager.py
2. Define unique hazards and delivery points
3. Add district-specific monster preferences

Implementing New Upgrades

1. Add upgrade definition in systems/upgrades/upgrade_manager.py
2. Define effects and requirements
3. Integrate with relevant game systems

📝 Technical Details

• Engine: Custom pygame-based engine
• Networking: TCP sockets with JSON messaging
• AI: Behavior trees with A* pathfinding
• Audio: 3D positional audio system
• Graphics: 2D sprite-based rendering with lighting effects

🎨 Asset Pipeline

The game uses procedural generation and simple geometric shapes for development. Asset placeholders can be replaced with:

• Sprite sheets for vehicles and monsters
• Audio files for engine sounds and monster effects
• Map data for detailed district layouts

🐛 Known Issues

• Audio files are procedurally generated (placeholders)
• Networking is basic TCP implementation
• Graphics are geometric shapes (development phase)
• Save system not yet implemented

🤝 Contributing

This is a demonstration project showcasing standalone game development. The modular architecture makes it easy to extend and modify systems.

📄 License

This project is for educational and demonstration purposes.

---

Can you survive the night deliveries? The city is waiting...