SlugRace is an exciting and fun Python-based game built using the Kivy framework. It combines Python and KvLang to deliver an engaging racing experience where players bet on slugs and watch them race to victory!
- Interactive Betting System: Place bets on your favorite slug and see if they win the race.
- Dynamic Gameplay: Real-time slug racing simulations with randomized results.
- User-Friendly Interface: Built using Kivy for a smooth and responsive user experience.
- Customizable Settings: Tailor the game to your preferences with adjustable configurations.
- Modular Design: Organized codebase with reusable components for easy development and maintenance.
| File/Folder | Description |
|---|---|
main.py |
The entry point for the game, containing the primary logic and application lifecycle. |
accident.py |
Handles random events or accidents occurring during the race. |
bets.py |
Manages the betting system, allowing users to place bets on their chosen slugs. |
race.py |
Contains the logic for simulating slug races. |
settings.py |
Configuration file for game settings and user preferences. |
widgets.py |
Custom widgets used throughout the game interface. |
.kv Files |
Define the UI structure and design using KvLang. |
assets/ |
Directory for game assets such as images, sounds, or other media. |
__pycache__/ |
Auto-generated directory for Python bytecode files. |
-
Clone the Repository:
git clone https://github.com/bentted/slugrace.git cd slugrace -
Install Dependencies: Make sure Python is installed. Install the required dependencies using:
pip install kivy
-
Run the Game: Execute the following command to start the game:
python main.py
-
Enjoy the Game: Follow the on-screen instructions to place bets, start races, and have fun!
- Python (55.8%): The primary programming language used for game logic and backend systems.
- KvLang (44.2%): Used to create responsive and visually appealing user interfaces.
Contributions are welcome! If you’d like to contribute:
- Fork the repository.
- Create a feature branch.
- Submit a pull request.
Did you know? Slugs can stretch to 20 times their normal length when racing (in this game, at least)!