# Space Dodge A game where you dodge bullets that are coming down from the top of the screen. It is available on Windows, Mac & Linux. ![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/spacexplorer11/Space_Dodge/total?color=%23A97BFF) ![GitHub Closed Issues](https://img.shields.io/github/issues-closed/spacexplorer11/Space_Dodge?color="blue") ![GitHub commit activity](https://img.shields.io/github/commit-activity/m/spacexplorer11/Space_Dodge?color="red") ## Description This is just a pygame project which I followed a [YouTube tutorial](https://www.youtube.com/watch?v=waY3LfJhQLY) to make. I have been adding new features such as sound effects, and lives and will try to add any suggestions! Please leave them in [Issues under the "suggestion" tag](https://github.com/Spacexplorer11/Space_Dodge/issues/new?template=feature_request.yml). If you have **any** feedback please fill out this [survey](https://tally.so/r/mOo7pA) ## Instructions to install & run the game The instructions to play the game are in-game. You can also find these instructions on [my website](https://spacedodge.space/instructions) 1. Download Python from [python.org](https://python.org). **Make sure it is correct for your computer.** > [!Caution] > Make sure it is the **official** python site (https://python.org)! > [!Important] > If you are on windows, please run `python` **on its own** in the terminal/command prompt and install python from the microsoft store as well 2. Download the latest release [here](https://github.com/spacexplorer11/Space_Dodge/releases/latest/download/Space_Dodge.zip) or on [itch.io](https://spacexplorer11.itch.io/spacedodge) 3. Extract/unzip the file to a desired location. 4. Navigate to the folder where you extracted the files. Find main.py (it is inside the space_dodge folder) >[!Note] > The script will automatically create a venv (virtual environment) in the same folder as the main.py file. > This avoids breaking system Python or relying on global packages. 5. Right click it and open with python (launcher) not IDLE or run the command `python main.py` or `python3 main.py` in your terminal (depending on your OS) to start the game. > [!Note] > It may take a few seconds to open the game, as it is installing necessary packages, so please be patient. ## What to do if anything goes wrong? You should [create an issue](https://github.com/Spacexplorer11/Space_Dodge/issues/new?template=help_wanted.yml) and make sure to upload the mylog.log file if available. Make sure to upload screenshots or screen recordings of **any** errors. Thanks! > [!Tip] > If you can't find the mylog.log file, then > you should try opening the `main.py` file in the default `IDLE` (right click `main.py` and open with python IDLE), and provide a screenshot of the error message when > you run it in the `IDLE`, as this will severely help me solve the issue faster. ## Credits - The first basic concept and code was from a [YouTube tutorial](https://www.youtube.com/watch?v=waY3LfJhQLY). - After that, most of the code was written by me, however not all, please view the [contributors section](https://github.com/Spacexplorer11/Space_Dodge/graphs/contributors) on my repo for more info - All images (except ones mentioned below) were generated using [Leonardo.ai](https://leonardo.ai) and the [Terms of Service](https://leonardo.ai/terms-of-service/) allow commercial use, you can read more [here](https://intercom.help/leonardo-ai/en/articles/8044018-commercial-usage) - Other media that was used is credited here: - The [mini-explosion gif](space_dodge/assets/explosion_gif_frames) when a bullet hits the ground, you can find it [here](https://en.picmix.com/stamp/Explode-Digital-Art-2334354) - The [mute symbol](space_dodge/assets/mute.png) can be found [here](https://www.flaticon.com/free-icons/silent) - The [unmute symbol](space_dodge/assets/unmute.png) can be found [here](https://www.flaticon.com/free-icons/enable-sound) - The [x symbol](space_dodge/assets/x_button_icon.png) (the one to exit the pop-up menus) can be found [here](https://static.vecteezy.com/system/resources/previews/024/780/371/non_2x/red-x-button-icon-sticker-clipart-ai-generated-free-png.png) - The [pause button](space_dodge/assets/pause_rectangle.png) can be found in the SF Symbols app on Mac (It can be downloaded [here](https://developer.apple.com/sf-symbols/)) - The [Settings animated icon](space_dodge/assets/settings_icon_frames) [was created by Freepik - Flaticon](https://www.flaticon.com/free-animated-icons/settings) - The [Mute icon](space_dodge/assets/mute.png) [was created by Freepik - Flaticon](https://www.flaticon.com/free-icons/silent) - The [Unmute icon](space_dodge/assets/unmute.png) [was created by Freepik - Flaticon](https://www.flaticon.com/free-icons/enable-sound) - All sounds were sourced from [Pixabay](https://pixabay.com) and [Uppbeat](https://uppbeat.io) - The [pause music](space_dodge/sounds/background_music/pause_screen/pause_music.mp3) is from uppbeat: https://uppbeat.io/t/aylex/evening-meal - The [main game music](space_dodge/sounds/background_music/background_music.mp3) (not title screen) is from uppbeat: https://uppbeat.io/t/qube/play - The other sounds are licensed under the [Pixabay License](https://pixabay.com/service/license-summary/) ## FAQ - Q: Why does the game freeze when I drag the window? - A: Unfortunately, this is an **operating system bug** which pauses the main thread when you drag the window, causing the game to freeze. ## How to contribute - This project **is** currently in **active development**, I work on it during my free time. - Any help would be **greatly appreciated!** - Do **not** hesitate to open a pull request. I will review it as fast as possible (1-3 days). - If you need help opening a pull request, please follow [this link](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) or watch [this video](https://www.youtube.com/watch?v=nCKdihvneS0). >[!Important] >All commits need to be **signed & verified** >This is automatically done when using Github Web/Github Codespaces >However, in your editor you may need to do extra steps >You can follow this guide for your IDE: > - [Pycharm](https://www.jetbrains.com/help/pycharm/2024.3/set-up-GPG-commit-signing.html?Set_up_GPG_commit_signing=&keymap=macOS#enable-commit-signing) > - [VS Code & Visual Studio](https://blog.mark-burton.com/posts/2023-01-20-signing-git-commits-in-vscode-and-visualstudio) > - [Using Git commands](https://gist.github.com/Spacexplorer11/3709702c972c33265dc83691e08919cb) ## Contact - If you would like to contact me, please use any of the methods available [on my profile/in my profile README!](https://github.com/Spacexplorer11) ## Thanks! 💜 Thank you so much for playing Space Dodge! I'd really appreciate it if you starred my repository! [Back to the top ^](#space-dodge)