Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nekyro/cosmic-escape
Cosmic Escape is an exhilarating space adventure where you pilot your ship through a treacherous meteor field! Dodge falling meteors, rack up your score, and see how long you can survive. Ready your reflexes it's a battle against gravity and speed in this thrilling race to safety!
https://github.com/nekyro/cosmic-escape
128x64 esp8266 game
Last synced: 25 days ago
JSON representation
Cosmic Escape is an exhilarating space adventure where you pilot your ship through a treacherous meteor field! Dodge falling meteors, rack up your score, and see how long you can survive. Ready your reflexes it's a battle against gravity and speed in this thrilling race to safety!
- Host: GitHub
- URL: https://github.com/nekyro/cosmic-escape
- Owner: Nekyro
- License: other
- Created: 2024-11-02T02:31:01.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-09T02:02:02.000Z (about 1 month ago)
- Last Synced: 2024-11-27T03:29:45.567Z (26 days ago)
- Topics: 128x64, esp8266, game
- Language: C++
- Homepage:
- Size: 373 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Cosmic Escape
## Overview
**Cosmic Escape** is an exciting space-themed mini game where players control a ship, dodging incoming meteors while racking up points. Built for the ESP8266 microcontroller, this game showcases the power of embedded programming and real-time graphics on a 128x64 LCD display. Now with **space-themed background music**!
## Features
- **Simple Controls**: Move your ship left and right using two buttons.
- **Challenging Gameplay**: Avoid meteors that fall from the top of the screen and try to survive as long as possible.
- **Scoring System**: Increase your score by letting meteors pass without collision. Score resets if you hit a meteor!
- **Graphics**: Beautifully rendered graphics on a 128x64 pixel display using the U8g2 library.
- **Space Music**: Background music plays while you dodge meteors, adding to the space atmosphere.
## Hardware Requirements
To run this project, you will need the following hardware:
- **ESP8266 Microcontroller**: A Wi-Fi enabled microcontroller that allows for easy programming and integration with various components (other microcontrollers can work with proper connections).
- **128x64 LCD Display**: A graphical display to show the game interface.
- **Two Push Buttons**: For controlling the movement of the ship (left and right).
- **Connecting Wires**: To connect the display and buttons to the ESP8266.
## Installation
1. Clone this repository to your local machine.
2. Open the project in your Arduino IDE.
3. Make sure you have the U8g2 library installed. You can install it through the Arduino Library Manager.
4. Connect the hardware as specified in the code.
5. Upload the code to your microcontroller.
6. Enjoy dodging meteors in space, now with background music!
## How to Play
- Use the **left button** to move your ship left.
- Use the **right button** to move your ship right.
- Avoid the falling meteors to keep your score going and stay in the game.
## License
This project is open-source and available under the [MIT License](LICENSE.md).
## Acknowledgments
Thanks to the open-source community for the libraries and resources that made this project possible!