Skip to content

daveragos/mafia

Repository files navigation

🎭 Mafia Game

This is a Flutter project that simulates the popular party game, Mafia.

📝 Description

In this game, players are secretly assigned roles and must try to accomplish their goals without the other players finding out their role. The roles are either "Mafia" 😈 or "Citizen" 😀, and they are represented by emojis. The game is designed for a minimum of 6 players.

🚀 Features

  • Input the number of players
  • Generate roles for the players
  • Display the roles one by one

🏃‍♂️ How to Run

  1. Clone the repository
  2. Navigate to the project directory
  3. Run flutter pub get to install dependencies
  4. Run flutter run to start the app

🤝 How to Contribute

I welcome contributions from everyone. Here are a few ways you can help:

  1. Report bugs 🐛: If you find a bug, please create an issue in the GitHub issue tracker describing the problem and including steps to reproduce it.

  2. Suggest enhancements 💡: If you have an idea for a new feature or an improvement to an existing feature, please create an issue describing your suggestion.

  3. Contribute code 👨‍💻: If you'd like to fix a bug or implement a feature yourself, here's a basic workflow:

    • Fork the repository
    • Clone your fork to your local machine
    • Create a new branch for your changes
    • Make your changes and commit them to your branch
    • Push your changes to your fork
    • Submit a pull request from your fork to the main repository
  4. Improve documentation 📚: Good documentation is just as important as good code. If you can improve this README that's a big help.

Thank you for your interest in contributing!

⭐ Starring & Following

If you find this project useful, please consider giving it a star ⭐. Also, you can follow me on GitHub to stay updated with my latest projects. Your support is greatly appreciated! 🙏

📦 Dependencies

  • Flutter SDK

🌟 Future Improvements

  • Add more roles
  • Wireless based
  • Implement a game logic

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published