https://github.com/randomsearch18/a-bit-racey
A car-themed arcade game built using the power of Pygame
https://github.com/randomsearch18/a-bit-racey
pygame pygame-games
Last synced: 7 months ago
JSON representation
A car-themed arcade game built using the power of Pygame
- Host: GitHub
- URL: https://github.com/randomsearch18/a-bit-racey
- Owner: RandomSearch18
- Created: 2023-11-14T17:02:05.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-05T11:05:07.000Z (over 1 year ago)
- Last Synced: 2025-03-22T15:49:09.116Z (10 months ago)
- Topics: pygame, pygame-games
- Language: Python
- Homepage: https://replit.com/@RandomSearch/A-Bit-Racey
- Size: 213 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# A Bit Racey
> A car-themed arcade game built using the power of Pygame
This is our first Pygame project. It is based on the tutorial at , although I have implemented it in an object-oriented way (along with other changes to the program's design).
## Usage
Start by cloning this repository to a folder of your choice. Commands in this guide assume the working directory is set to the root of this repository.
In general, you'll need Python 3.8 or above, and the `pygame` Python package available. For the platforms that I've tested the game on, there are some specific instructions below.
### Arch Linux
1. Install the `python` and `python-pygame` packages, e.g. by running `sudo pacman -S python python-pygame`
2. Run the game: `python3 main.py`
### Android (Termux)
The game seems to work under Android using [Termux](https://termux.dev/) with the experimental [Termux:X11](https://github.com/termux/termux-x11) add-on. Start by installing the dependencies:
```bash
$ pkg install python
$ pkg install sdl2 sdl2-image sdl2-ttf xorgproto # Libaries required by pygame
$ pip install pygame
```
Then, launch an X11 session ([see the Termux:X11 documentation for guidance](https://github.com/termux/termux-x11#running-graphical-applications)) and start the game:
```bash
$ python3 main.py
```
### PostmarketOS
Note: This should also work for Alpine Linux in general, although you may have to replace `sudo` with whatever tool your system uses for elevating permissions, e.g. `doas`.
```sh
$ sudo apk add python3 py3-pygame
$ python3 main.py
```
### Zorin OS
These instructions should also work on Ubuntu 20.04 LTS, which Zorin OS is based on.
```bash
$ sudo apt install python3 python3-pygame
$ python3 main.py
```
## Tips
### Desktop entry
To avoid having to start the game from the terminal, you can create a [desktop entry](https://wiki.archlinux.org/title/desktop_entries) to launch it from your applications menu. Be sure to use the absolute path to Python and set `Path` to the root of this repository (so that the game can find its assets). A simple example is shown below (replace `/path/to/` with the actual path to the cloned repository):
```desktop
[Desktop Entry]
Type=Application
Name=A Bit Racey
Exec=/usr/bin/python3 /path/to/a-bit-racey/main.py
Path=/path/to/a-bit-racey/
Terminal=false
Categories=Game;
```