🎮 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

mumble_game

Runtime