space-shooter - GitLite

KO | EN

gitlite — search

#developer-tools #monitoring #shell #csharp #machine-learning #animation #macos #python #mysql #ai-agents

space-shooter

(★ 9)

A fast-paced 2D space shooter built with Python and Pygame, featuring scrolling backgrounds, asteroid battles, alien enemies, a boss fight, sound effects, and an arcade-style scoring system.

File Explorer

ZIP Download

- - alien_boss.png
  - asteroid.png
  - bg.jpg
  - enemy_1.png
  - enemy_2.png
  - laser.png
  - player_ship.png
  - thumbnail.png
- - alien_hit.wav
  - alien_killed.wav
  - asteroid_explosion.wav
  - big_asteroid_hit.wav
  - boss_death.wav
  - boss_hit.wav
  - game_over.wav
  - laser_sound.wav
  - main.mp3
  - space_ship_hit.wav
  - victory_end.wav
- 1.png
- 2.png
.gitattributes
banner.png
LICENSE
main.py
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="banner.png" alt="Space Shooter banner" width="100%">
</p>

<h1 align="center">🔶 Space Shooter</h1>
<p align="center">
  <strong>A fast-paced 2D arcade space shooter built with Python and Pygame.</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python">
  <img src="https://img.shields.io/badge/Pygame-2D%20Game-2E8B57" alt="Pygame">
  <img src="https://img.shields.io/badge/Genre-Arcade%20Shooter-7C3AED" alt="Genre">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="MIT License">
</p>

## 🟠Overview

Space Shooter is a vertical scrolling arcade game where the player controls a spaceship, fires lasers, dodges asteroids, fights alien enemies, and survives long enough to defeat a boss. The game uses Pygame sprites, collision detection, background scrolling, sound effects, and a simple progression system to create a complete playable desktop game.

## 🟠Features

- Player-controlled spaceship with left/right movement.
- Laser shooting with keyboard controls.
- Infinite scrolling space background.
- Regular asteroids and larger high-health asteroids.
- Alien enemies with two-frame sprite animation.
- Enemy laser attacks after aliens appear.
- Boss enemy with high health and horizontal movement.
- Player health system.
- Score/points display.
- Game-over screen with final score.
- Victory screen after defeating the boss.
- Background music and multiple sound effects.
- Clean asset structure with separate image, sound, and screenshot folders.
- Asset loading through script-relative paths, so the game can be launched from different working directories.

## 🟠Screenshot
The project includes screenshots in the `screenshots/` folder.

<table>
  <tr>
    <td align="center"><img src="screenshots/1.png" width="360" alt="Space Shooter screenshot 1"></td>
    <td align="center"><img src="screenshots/2.png" width="360" alt="Space Shooter screenshot 2"></td>
  </tr>
</table>

## 🟠Technology Stack

| Area | Technology |
| --- | --- |
| Language | Python |
| Game Framework | Pygame |
| Graphics | Pygame sprites and image surfaces |
| Audio | Pygame mixer |
| Asset Management | Local `assets/images` and `assets/sounds` folders |
| Main Runtime | `main.py` |

## 🟠Project Structure
```text
space-shooter/
├── README.md
├── LICENSE
├── main.py
├── banner.jpg
├── assets/
│   ├── images/
│   │   ├── alien_boss.png
│   │   ├── asteroid.png
│   │   ├── bg.jpg
│   │   ├── enemy_1.png
│   │   ├── enemy_2.png
│   │   ├── laser.png
│   │   ├── player_ship.png
│   │   └── thumbnail.png
│   └── sounds/
│       ├── alien_hit.wav
│       ├── alien_killed.wav
│       ├── asteroid_explosion.wav
│       ├── big_asteroid_hit.wav
│       ├── boss_death.wav
│       ├── boss_hit.wav
│       ├── game_over.wav
│       ├── laser_sound.wav
│       ├── main.mp3
│       ├── space_ship_hit.wav
│       └── victory_end.wav
└── screenshots/
    └── screenshot.png
```

## 🟠Installation

### Prerequisites

- Python 3.10 or newer
- `pip`

### 1. Open the Project Folder

```bash
cd space-shooter
```

### 2. Install Pygame

```bash
pip install pygame
```

### 3. Run the Game

```bash
python main.py
```

On some systems, use:

```bash
python3 main.py
```

## 🟠Controls

| Action | Key |
| --- | --- |
| Move left | `Left Arrow` |
| Move right | `Right Arrow` |
| Shoot laser | `Space` |
| Quit | Close the game window |

## 🟠License

This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

## 🟠Author

Ashish Kumar