Skip to content

briankabbo/Meme-Mayhem

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dragon

Meme Mayhem

Another party game for the people who grew up on the internet and never recovered.

Meme Mayhem is a real-time multiplayer web game where players slap their funniest meme reaction onto a scenario and pray the crowd agrees. They vote. You either become a legend or a cautionary tale. There is no in-between.

Play with friends or enemies. No skill required.


🎮 Gameplay

  • 2–10 players per room - playable with 2, but the chaos really kicks in at 3+
  • Private room codes - no randoms unless you invite them
  • Host controls everything - rounds, themes, and the vibe
  • 5 cards in hand at all times - draw 1 after each round, reshuffled when the deck runs dry
  • 15 seconds to pick your meme. Choose wisely. Or don't. You have 15 seconds.
  • Random turn order every round - no one is safe, no one sees it coming
  • Three reactions to cast: 💀 Lmao (5pts) · 😂 Haha (1pt) · 😐 Meh (0pts)
  • Vote while you wait. No self-voting - we know you think you're funny. Prove it to others.
  • Auto-skip on disconnect - the game never stops for one person
  • Late joiners drop into spectator mode - watch, laugh, and wait for the next round

Open Source Contribution & Extensible

  • Custom meme packs & themes - add your own cards and scenarios
  • Modular game rules - tweak scoring, timers, and UI to your liking
  • Community contributions welcome - whether it's a bug fix, a meme pack, or a wild new feature

code Tech Stack

Layer Technology Purpose
Frontend React + TypeScript Game UI & player experience
Backend C# / ASP.NET Core Game logic, API & server
Real-time SignalR Live multiplayer & room sync
AI Groq API Generating hilarious game prompts
Meme GIPHY API Meme card content & reactions

flask Getting Started

⚠️ Meme Mayhem is currently under active development. Setup instructions will be updated as the project stabilizes.

👁️ Watch or ⭐ Star the repo to stay updated!

Installation & Configuration

# Clone the repo
git clone https://github.com/briankabbo/Meme-Mayhem
cd Meme-Mayhem

Full setup guide & environment configuration coming soon. In the meantime, feel free to open an issue if you have questions!


handshake Contributing

First off thank you for even considering contributing to Meme Mayhem. You are already funnier than most people.

Submitting a PR?

  1. Fork the repo
  2. Create a new branch (git checkout -b feature/your-feature-name)
  3. Make your changes
  4. Commit with a clear message (git commit -m "Add: thing that makes game funnier")
  5. Push and open a Pull Request
  6. Wait for a review - we don't bite. Much.

Your meme collection was training you for this moment.

About

Another party game for the people who grew up on the internet and never recovered.

Topics

Resources

License

Stars

Watchers

Forks

Contributors