Mad Libs Game

A friendly, colorful console-based Mad Libs Game that lets you create hilarious stories with dynamic templates. Built using Rich.

Table of Contents

• Mad Libs Game
  • Table of Contents
  • About
  • Preview
  • Features
  • Getting Started
    • Prerequisites
    • Installation
    • Running the Game
  • Contributing
  • License

About

Mad Libs Game is a fun and interactive console application that allows users to create humorous and dynamic stories by filling in blanks with their own words. The game is built with Python and leverages the power of the Rich library to offer a vibrant, colorful interface and smooth user experience.

(back to top)

Preview

Click to expand

Features

• Dynamic Story Templates: Enjoy a variety of engaging story templates with placeholders for words.
• Interactive Commands: Use commands like random, history, and restart to control your game flow.
• Customizable Themes: Choose between different color themes (default, dark, and light) to personalize your gaming experience.
• User-Friendly Interface: The game utilizes Rich to display beautiful text, panels, and loading animations for an enhanced UI.
• Story History: View the last 10 stories you've created to relive your hilarious moments.

(back to top)

Getting Started

Follow these steps to set up a local copy of Mad Libs Game and start creating your own stories.

Prerequisites

• Python 3.6+
• pip (Python package installer)

Installation

1. Clone the Repository:

   git clone https://github.com/Exonymos/mad-libs-game.git

2. Navigate to the Project Directory:

   cd mad-libs-game

3. Install Required Dependencies:

   pip install -r requirements.txt

   If a requirements.txt file is not present, create one with the following content:

   rich

Running the Game

1. Start the Game:

   python mad-lib.py

2. Follow the On-Screen Prompts:
   Enjoy creating your stories by entering words and using available commands.

(back to top)

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)