https://github.com/michelbr84/arcade_survival
Arcade Survival is a retro-inspired 2D top-down survival shooter built with Python and Pygame. Fight off endless waves of enemies, collect points, and see how long you can survive. Clean architecture, modular components, and elegant UI design make this project a great base for further development or learning game dev with Python.
https://github.com/michelbr84/arcade_survival
2d-game arcade-game enemy-waves game-development game-loop indie-game json modular-architecture open-source pygame pygame-tutorial python-game resolution-settings retro-game sound-effects survival-shooter topdown-game
Last synced: 3 months ago
JSON representation
Arcade Survival is a retro-inspired 2D top-down survival shooter built with Python and Pygame. Fight off endless waves of enemies, collect points, and see how long you can survive. Clean architecture, modular components, and elegant UI design make this project a great base for further development or learning game dev with Python.
- Host: GitHub
- URL: https://github.com/michelbr84/arcade_survival
- Owner: michelbr84
- License: other
- Created: 2025-05-07T21:45:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-17T02:28:32.000Z (7 months ago)
- Last Synced: 2025-12-20T16:16:43.535Z (7 months ago)
- Topics: 2d-game, arcade-game, enemy-waves, game-development, game-loop, indie-game, json, modular-architecture, open-source, pygame, pygame-tutorial, python-game, resolution-settings, retro-game, sound-effects, survival-shooter, topdown-game
- Language: Python
- Homepage:
- Size: 7.89 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🎮 Arcade Survival
---
## 📖 About the Game
**Arcade Survival** is a top-down 2D survival shooter built with Python and Pygame. The player must survive waves of enemies by moving, dodging, and shooting in a dynamically scaling environment. The game features a retro-inspired interface, resolution switching, basic audio controls, and a responsive UI system.
---
## 📂 Project Structure
```
arcade\_survival/
├── main.py
├── config/
│ ├── **init**.py
│ ├── settings.py
│ └── paths.py
├── core/
│ ├── **init**.py
│ ├── game.py
│ ├── menus.py
│ └── utils.py
├── entities/
│ ├── **init**.py
│ ├── player.py
│ ├── bullet.py
│ └── enemy.py
├── assets/
│ ├── images/
│ │ ├── player.png
│ │ ├── enemy.png
│ │ └── background.jpg
│ ├── sounds/
│ │ ├── shoot.mp3
│ │ ├── kill.mp3
│ │ ├── gameover.mp3
│ │ └── music.mp3
│ └── fonts/
│ └── arial.ttf
├── data/
│ ├── highscores.json
│ └── settings.json
├── requirements.txt
├── README.md
└── .gitignore
````
---
## ✅ Features Implemented
- ✅ Modular and scalable project structure
- ✅ Functional main menu, pause menu, and options menu
- ✅ Player movement (WASD) and mouse-aimed shooting
- ✅ Bullet collision with enemies
- ✅ Enemy wave generation with difficulty scaling
- ✅ Health bar and player damage system
- ✅ Sound effects: shoot, kill, game over (using safe loader)
- ✅ Background music with volume control
- ✅ Resolution switching and fullscreen toggle
- ✅ JSON support for future persistent data
- ✅ Graceful error handling for missing or failed audio assets
---
## 🛠️ To Do / Work in Progress
- ☐ Add individual volume control for `general_volume`, `music_volume` and `effects_volume`
- ☐ Save and load player score from `highscores.json`
- ☐ Animated sprites for characters
- ☐ Add new enemy types with behaviors
- ☐ Implement power-ups (speed, double-shot, etc.)
- ☐ Game over and retry screen
- ☐ Difficulty selection (easy, normal, hard)
- ☐ Gamepad/controller support
- ☐ In-game settings with UI sliders
- ☐ Local leaderboard system
---
## 🧩 Requirements
- Python 3.12+
- Pygame 2.6+
To install dependencies:
```bash
pip install -r requirements.txt
````
---
## 🚀 Running the Game
```bash
python main.py
```
---
## 🧠 Credits
* Developed using **Pygame** and **Python 3**
* All visual and sound assets used here are placeholders — replace them before redistribution
---
## 📃 License
This project is licensed under the **MIT License** (see `LICENSE`).
**Note:** Assets in the `assets/` folder are for educational use only and should be replaced for commercial or production use.