Meshcore Hangman Bot

A collaborative hangman game bot for Meshcore mesh networks that runs in the #gameroom-limburg channel.

Features

• 🎮 Collaborative hangman game - everyone plays together
• 📡 Radio-themed ASCII art showing remaining lives
• 🔄 Automatic game restart after win/loss
• 🎯 Single-letter guessing system
• 📝 Tracks failed and successful guesses

How to Play

1. The game starts automatically when the bot connects
2. Players guess letters by sending a single character (a-z) in the channel
3. Correct guesses reveal letters in their positions (e.g., "a.a.." for "alarm")
4. Wrong guesses reduce lives and are shown in the failed letters list
5. Win by completing the word before running out of lives (6 lives total)
6. Game automatically restarts after completion

Game Display

Guessed letters: dipud
     📡 ~~~~~~📶 6-dB
      |
      |
    /  \
  [ ___ ]

a.a..

Setup

1. Install dependencies:

npm install

2. Update the serial port in hangman_bot.js or set environment variable:

export SERIAL_PORT=/dev/ttyUSB0  # Linux
# or
export SERIAL_PORT=COM3  # Windows

3. Run the bot:

npm start

Configuration

• SERIAL_PORT: The serial port your Meshcore device is connected to
• CHANNEL_NAME: The channel to monitor (default: #gameroom-limburg)
• MAX_LIVES: Number of lives before game over (default: 6)
• WORD_LIST: Array of words to use in the game (edit in hangman_bot.js)

Messages

• Win: "You won!!! I will restart"
• Loss: "FAILED! You destroyed the radio!!! I will restart"

Requirements

• Node.js 14+ (with ES modules support)
• Meshcore device connected via serial port
• meshcore.js library

License

MIT