🎮 An intense endless runner with horror atmosphere, gravity-defying mechanics, and nightmarish enemies! 🎮
Features • Gameplay • Controls • Installation • Enemies • Screenshots
Shadow Run: Endless Nightmare is a fast-paced, atmospheric endless runner that plunges you into a dark, horror-themed world. Run, jump, flip gravity, and shoot your way through an ever-increasing nightmare as you try to survive as long as possible!
The game features smooth progressive difficulty scaling that makes the experience more challenging the further you go—without sudden spikes that break your flow.
- Gravity Flip System — Defy physics! Switch between running on the ground and ceiling at will
- Shooting System — Blast through enemies with your weapon (5 ammo with auto-regeneration)
- Invisibility Power — Charge up and become invisible to pass through dangers
- Double Jump — Unlock the ability to jump in mid-air
- Smooth Auto-Run — The game runs automatically; you focus on survival!
- Dark, moody visuals with fog effects and eerie color palette
- Nightmarish enemy designs that get more terrifying as you progress
- Haunting background with dead trees, blood moon, and creeping shadows
- Smooth scaling — Difficulty increases gradually based on your score
- Enemy evolution — New enemy types unlock as you progress:
- Basic Enemies (Start)
- Chasers (500+ score)
- Shooters (1500+ score)
- Berserkers (3000+ score)
- Swarm Patterns (5000+ score)
- 10+ Enemy Types — Including ground, ceiling, flying, ghost, teleporter, and spider enemies
- Power-Ups & Collectibles — Coins, health packs, and special abilities
- Leaderboard System — Compete for the highest score
- Full Menu System — Main menu, pause, settings, tutorial, and game over screens
Your goal is simple: survive as long as possible and rack up the highest score!
- Run automatically through an endless nightmare landscape
- Jump over obstacles and pits
- Flip gravity to run on the ceiling and dodge enemies
- Shoot enemies to clear your path
- Collect coins for bonus points
- Grab health packs to stay alive
- Use invisibility to phase through danger
| Action | Key |
|---|---|
| Jump | SPACE / W / ↑ |
| Flip Gravity | F / G |
| Shoot | Left Click / X |
| Invisibility | Right Click / C |
| Pause | ESC / P |
- Python 3.8+
- Pygame library
-
Clone the repository
git clone https://github.com/yourusername/shadow-run.git cd shadow-run -
Install dependencies
pip install pygame
-
Run the game
python unigame.py
| Enemy | Description | Unlocks At |
|---|---|---|
| Basic Enemy | Patrols back and forth | Start |
| Chaser | Aggressively pursues the player | 500 pts |
| Shooter | Fires projectiles at you | 1500 pts |
| Berserker | Fast and deals heavy damage | 3000 pts |
| Ceiling Enemy | Lurks on the ceiling | Various |
| Flying Enemy | Hovers and attacks from above | Various |
| Ghost | Phases through obstacles | Various |
| Teleporter | Blinks around unpredictably | Various |
| Spider | Fast and deadly | Various |
- Distance — The further you run, the more points you earn
- Coins — Each coin adds 10 points
- Survival — Stay alive to keep multiplying your score
- Leaderboard — Your top 10 scores are saved locally
- Resolution: 1280 × 720
- Frame Rate: 60 FPS
- Language: Python 3
- Engine: Pygame
- Architecture: Modular OOP design with separate systems for player, enemies, UI, camera, sound, and more
Shadow-Run/
├── unigame.py # Main entry point
├── assets/
│ ├── audio/ # Sound effects and music
│ └── sprites/ # Player and enemy sprites
│ └── player/
│ ├── idle/
│ ├── walk/
│ ├── jump/
│ └── Dash2/
├── data/
│ └── leaderboard.json
└── game/
├── __init__.py
├── game.py # Main game manager
├── player.py # Player class
├── enemies.py # All enemy types
├── platforms.py # Ground and world generation
├── collectibles.py # Coins, health, power-ups
├── difficulty.py # Progressive difficulty system
├── camera.py # Camera system
├── background.py # Visual effects
├── sound.py # Audio manager
├── ui.py # All UI screens
├── leaderboard.py # Score tracking
├── settings.py # Game configuration
└── utils.py # Helper utilities
- Master gravity flipping — It's your best tool for dodging enemies
- Save your ammo — Bullets regenerate slowly, use them wisely
- Charge invisibility early — Have it ready for emergencies
- Watch the ceiling — Ceiling enemies are just as deadly as ground ones
- Don't panic at swarms — Use gravity flip to escape large groups
This project is open source and available under the MIT License.
- Developer: Danesh khodadadzadeh
- Engine: Pygame Community
- Inspiration: Classic endless runners with a horror twist
⚡ Can you survive the endless nightmare? ⚡
