# mruniquehacker/knightbot-md

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mruniquehacker-knightbot-md).**

6,737 stars · 16,820 forks · JavaScript

## Links

- GitHub: https://github.com/mruniquehacker/Knightbot-MD
- Homepage: https://www.youtube.com/@mr_unique_hacker
- awesome-repositories: https://awesome-repositories.com/repository/mruniquehacker-knightbot-md.md

## Topics

`github-whatsapp-bot` `knight` `knight-bot` `knight-bot-md` `knightbot` `knightbot-whatsapp-bot` `whatsapp` `whatsapp-bot` `whatsapp-bot-md` `whatsapp-bot-multi-device`

## Description

Knightbot-MD is a WhatsApp bot framework that connects through the multi-device protocol to automate group management, moderation, and interactive features. It provides a modular system for running turn-based multiplayer games like Tic-Tac-Toe within group conversations, converting images into WebP stickers for chat sharing, and synthesizing text messages into audio clips through text-to-speech conversion.

The bot includes a link-detection moderation engine that scans incoming messages against blocklisted domains and triggers automated warnings or muting. It enforces role-based command authorization, restricting sensitive operations to group administrators only, and uses prefix-triggered command parsing to match messages against registered handlers. Group management capabilities cover member permissions, muting, warnings, all-member tagging, and group settings control.

The system maintains in-memory game state for turn-based interactions and processes media through an image-to-sticker conversion pipeline that resizes and encodes uploaded images. The bot is implemented in JavaScript and connects as a WhatsApp client using the WebSocket-based multi-device protocol for message synchronization and sending.

## Tags

### Networking & Communication

- [WhatsApp Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations.md) — Connects as a WhatsApp client using the WebSocket-based multi-device protocol for message sync and sending.
- [WhatsApp Bot Frameworks](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations/whatsapp-bot-frameworks.md) — Provides a modular bot framework connecting via the WhatsApp multi-device protocol for automation and interactivity.
- [WhatsApp Moderation Bots](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations/whatsapp-moderation-bots.md) — Enforces chat rules, manages member permissions, and detects blocked links in WhatsApp groups automatically.

### Part of an Awesome List

- [WhatsApp Group](https://awesome-repositories.com/f/awesome-lists/devops/management-bots/whatsapp-group.md) — Manages WhatsApp group settings, moderates members, and enforces chat rules through automated commands.
- [Chat Text-to-Speech Bots](https://awesome-repositories.com/f/awesome-lists/media/text-to-speech/chat-text-to-speech-bots.md) — Transforms typed text into audio messages and sends them to WhatsApp chats for accessibility or fun.

### Business & Productivity Software

- [Group Settings Management](https://awesome-repositories.com/f/business-productivity-software/group-management/group-settings-management.md) — Adjusts group-level settings like who can send messages or edit group information. ([source](https://youtube.com/@mr_unique_hacker))
- [WhatsApp Group Moderation](https://awesome-repositories.com/f/business-productivity-software/group-management/group-settings-management/whatsapp-group-moderation.md) — Manages group chat settings, member permissions, and enforces rules using a bot that listens to admin commands.
- [Member Muting](https://awesome-repositories.com/f/business-productivity-software/team-member-management/chat-member-administration/member-muting.md) — Restrict a selected member's ability to send messages in a group or lift that restriction as needed. ([source](https://www.youtube.com/@mr_unique_hacker))
- [Member Unmuting](https://awesome-repositories.com/f/business-productivity-software/team-member-management/chat-member-administration/member-muting/member-unmuting.md) — Remove the sending restriction from a previously muted member, restoring their ability to message. ([source](https://www.youtube.com/@mr_unique_hacker))
- [Chat Muting Controls](https://awesome-repositories.com/f/business-productivity-software/group-management/chat-muting-controls.md) — Restricts or restores the ability for members to send messages in a group, giving admins control over conversation flow. ([source](https://www.youtube.com/@mr_unique_hacker))
- [Member Permission Modifiers](https://awesome-repositories.com/f/business-productivity-software/team-member-management/member-permission-modifiers.md) — Adjusts member permissions and chat rules within a group chat by issuing commands. ([source](https://youtube.com/@mr_unique_hacker))

### Graphics & Multimedia

- [Sticker Converters](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/sticker-converters.md) — Converts uploaded images into WebP stickers for sharing directly in WhatsApp chats.
- [Text-to-Speech Engines](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/audio-processing-systems/audio-processing/text-to-speech-engines/text-to-speech-engines.md) — Converts text messages into voice audio files using a TTS engine and sends them as chat attachments.
- [WhatsApp](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-manipulation/media-processing/sticker-converters/whatsapp.md) — Converts uploaded images into WebP stickers for sharing directly in WhatsApp chats.

### Security & Cryptography

- [Link-Based Moderation](https://awesome-repositories.com/f/security-cryptography/automated-moderation/link-based-moderation.md) — Scans incoming messages against blocklisted domains and triggers automated warnings or muting.
- [Role-Based Access Control](https://awesome-repositories.com/f/security-cryptography/role-based-access-control.md) — Checks the sender's group role against required permission levels before executing a command.

### Artificial Intelligence & ML

- [Text-to-Speech](https://awesome-repositories.com/f/artificial-intelligence-ml/text-to-speech.md) — Converts typed text into an audio message that plays in a chat for accessibility or entertainment. ([source](https://cdn.jsdelivr.net/gh/mruniquehacker/knightbot-md@main/README.md))

### Development Tools & Productivity

- [Command Trigger Prefixes](https://awesome-repositories.com/f/development-tools-productivity/custom-command-execution/configuration-file-command-execution/command-trigger-prefixes.md) — Parses commands from message text using a user-defined prefix character and registered handlers.

### Game Development

- [Turn-Based Game Bots](https://awesome-repositories.com/f/game-development/online-multiplayer/game-chat-bots/turn-based-game-bots.md) — Runs turn-based multiplayer games like Tic-Tac-Toe directly inside WhatsApp group conversations.
