Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thekartikeyamishra/santagame
Welcome to Santa's Gift Run, a fun and festive game created with Python using the Pygame library. Control Santa Claus as he collects gifts, avoids obstacles, and spreads Christmas cheer in a snowy wonderland! 🎅🎄
https://github.com/thekartikeyamishra/santagame
2d-game game gamedev pygame python
Last synced: about 1 month ago
JSON representation
Welcome to Santa's Gift Run, a fun and festive game created with Python using the Pygame library. Control Santa Claus as he collects gifts, avoids obstacles, and spreads Christmas cheer in a snowy wonderland! 🎅🎄
- Host: GitHub
- URL: https://github.com/thekartikeyamishra/santagame
- Owner: thekartikeyamishra
- Created: 2024-12-25T09:57:33.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-25T10:00:58.000Z (about 2 months ago)
- Last Synced: 2024-12-25T10:29:24.216Z (about 2 months ago)
- Topics: 2d-game, game, gamedev, pygame, python
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Santa's Gift Run: A Christmas-Themed Python Game
Welcome to **Santa's Gift Run**, a fun and festive game created with Python using the **Pygame library**. Control Santa Claus as he collects gifts, avoids obstacles, and spreads Christmas cheer in a snowy wonderland! 🎅🎄
---
### **Game Description**
- **Objective**:
Help Santa collect as many gifts as possible while dodging snowballs and icy patches.
- **Features**:
- A snowy, Christmas-themed landscape.
- Animated Santa character.
- Randomly appearing gifts and obstacles.
- Scoring system with high score tracking.
- Background music for an immersive experience.
---
### **File and Folder Structure**
```bash
SantaGame/
├── assets/
│ ├── santa.png # Santa sprite
│ ├── gift.png # Gift sprite
│ ├── snowball.png # Obstacle sprite (snowball)
│ ├── background.jpg # Background image (snowy landscape)
│ ├── music.mp3 # Background music
├── main.py # Main game logic
├── requirements.txt # Dependencies for the project
├── README.md # Documentation for the game
```
---
### **Installation Instructions**
1. **Clone the Repository**:
```bash
git clone https://github.com/thekartikeyamishra/SantaGame.git
cd SantaGame
```
2. **Set Up Virtual Environment (Optional)**:
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
4. **Run the Game**:
```bash
python main.py
```
---
### **Game Features**
1. **Dynamic Gameplay**:
- Gifts and snowballs spawn randomly for a unique challenge each time.
2. **Scoring System**:
- Gain 10 points for every gift collected.
- Tracks your high score.
3. **Game Over Screen**:
- Displays your score, high score, and restart option.
4. **Christmas-Themed Graphics and Sound**:
- Immersive visuals and cheerful background music.
---
### **Game Controls**
- **Up Arrow**: Move Santa up.
- **Down Arrow**: Move Santa down.
- **R**: Restart after a game over.
---
### **Assets Needed**
- **Images**:
- `santa.png`: Animated sprite for Santa Claus.
- `gift.png`: Sprite for gifts.
- `snowball.png`: Sprite for obstacles.
- `background.jpg`: A snowy Christmas-themed background.
- **Audio**:
- `music.mp3`: Christmas-themed background music.
Ensure all assets are placed in the `assets/` folder.
---
### **Requirements**
The game uses the **Pygame library**. Install it using:
```bash
pip install pygame
```
---
### **How to Play**
1. Launch the game by running `main.py`.
2. Use the **up** and **down** arrow keys to control Santa.
3. Collect gifts while avoiding snowballs.
4. Try to beat your high score!
---
### **Future Enhancements**
1. **Levels**:
- Introduce increasing difficulty levels with faster obstacles.
2. **Additional Obstacles**:
- Add new challenges like icy patches or flying snowflakes.
3. **Multiplayer Mode**:
- Include a competitive mode for two players.
4. **Power-Ups**:
- Add power-ups like shields or speed boosts.
---
### **Contribute**
Have ideas for improving the game? Contributions are welcome!
- Fork the repository.
- Make your changes.
- Submit a pull request.
---
### **Support**
If you enjoyed the game, consider giving it a ⭐ on GitHub: [Santa's Gift Run](https://github.com/thekartikeyamishra/SantaGame).
Merry Christmas and happy coding! 🎅🎄✨