Migration to Codeberg

2026-07-30 16:38:22 +02:00
commit 17048b703a
556 changed files with 3040 additions and 0 deletions
@@ -0,0 +1,58 @@
+
+# Asteroids
+
+## Overview
+Asteroids game is built using the [Pygame](https://www.pygame.org/) library, which provides tools for creating 2D games in Python.
+
+## Prerequisites
+To run the game, ensure you have the following installed on your system:
+
+- **Python 3.13 or later**: Install the latest version of Python from the [official Python website](https://www.python.org/).
+- **Pygame**: The game relies on Pygame for graphics and input handling. 
+
+## Setting Up the Environment
+To set up the game environment, follow these steps:
+
+1. **Create a virtual environment:**
+   ```bash
+   python3 -m venv venv
+   ```
+   This command creates a virtual environment in the `venv` directory.
+
+2. **Activate the virtual environment:**
+   On macOS or Linux:
+   ```bash
+   source venv/bin/activate
+   ```
+   On Windows:
+   ```cmd
+   venv\Scripts\activate
+   ```
+
+3. **Install Pygame:**
+   With the virtual environment activated, install Pygame:
+   ```bash
+   pip3 install pygame
+   ```
+
+## Running the Game
+To start the game, ensure the virtual environment is activated, then run the following command:
+
+```bash
+python3 asteroids.py
+```
+
+## Troubleshooting
+- Ensure the virtual environment is activated before running the game or installing dependencies.
+- If you encounter issues with Pygame installation, ensure your Python version is compatible with the latest Pygame release.
+- Check that all game files, including `asteroids.py`, are in the correct directory.
+
+## License
+This project is distributed under the MIT License. See the `LICENSE` file for details.
+
+## Contributions
+Contributions are welcome! Feel free to fork the repository and submit pull requests.
+
+## Credits
+- **Developer:** Joaquin Gottlebe
+- **Built With:** Pygame and Python