🎮 Mumble

A terminal-based word guessing game combining Wordle and Hangman mechanics, built in Ruby.

Features

• 🎯 Wordle-style gameplay - Guess the 5-letter word with color-coded feedback
• ☠️ Hangman integration - Wrong guesses build the hangman
• 🏆 High scores - Track your best performances
• 📊 Statistics - Games played, win rate, streaks
• 🎨 Beautiful terminal UI - Colors, animations, ASCII art
• 💾 Persistent data - Your progress is saved locally
• 🌐 Online word fetching - Fresh words from Datamuse API
• 📱 Responsive design - Adapts to small and large terminals

Installation

gem install mumble_game

Or add to your Gemfile:

gem "mumble_game"

Usage

Simply run:

mumble

Controls

Key	Action
A-Z	Type letters
Backspace	Delete letter
Enter	Submit guess
↑↓	Navigate menus
1-5	Quick menu select
Ctrl+C	Exit game

Color Guide

Color	Meaning
🟩 Green	Correct letter, correct position
🟧 Orange	Correct letter, wrong position
🟥 Red	Letter not in word

Requirements

• Ruby 3.0+
• Terminal with 80x24 minimum size
• Internet connection (for word fetching, optional)

Screenshots

Main Menu

Gameplay

Win Screen

Lose Screen

High Scores

Development

# Clone the repo
git clone https://github.com/yourusername/mumble_game.git
cd mumble_game

# Install dependencies
bundle install

# Run the game
bundle exec rake play

# Run tests
bundle exec rake spec

# Run linter
bundle exec rubocop

Data Storage

Mumble stores data in ~/.mumble/:

• config.json - Player profile and settings
• high_scores.json - Leaderboard
• word_cache.json - Cached words for offline play
• error.log - Error logs for debugging

To reset all data:

rm -rf ~/.mumble

Contributing

Bug reports and pull requests are welcome on GitHub. See CONTRIBUTING.md for guidelines.

License

This gem is available as open source under the MIT License.

Author

Built with ❤️ by Hady Mohamed