https://github.com/iapetus-11/villager-bot

The code behind Villager Bot, a multipurpose Minecraft-themed Discord bot
https://github.com/iapetus-11/villager-bot

bot discord discord-bot discordpy minecraft python villager villager-bot

Last synced: about 1 year ago
JSON representation

The code behind Villager Bot, a multipurpose Minecraft-themed Discord bot

• Host: GitHub
• URL: https://github.com/iapetus-11/villager-bot
• Owner: Iapetus-11
• License: mit
• Created: 2020-03-26T14:07:36.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2025-03-10T11:41:06.000Z (over 1 year ago)
• Last Synced: 2025-03-30T19:05:00.876Z (about 1 year ago)
• Topics: bot, discord, discord-bot, discordpy, minecraft, python, villager, villager-bot
• Language: Python
• Homepage:
• Size: 58.2 MB
• Stars: 137
• Watchers: 8
• Forks: 44
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# **Villager Bot**

[![CodeFactor](https://www.codefactor.io/repository/github/iapetus-11/villager-bot/badge)](https://www.codefactor.io/repository/github/iapetus-11/villager-bot)

[![Bot Status](https://top.gg/api/widget/status/639498607632056321.svg?noavatar=true)](https://top.gg/bot/639498607632056321)

[![Server Count](https://top.gg/api/widget/servers/639498607632056321.svg?noavatar=true)](https://top.gg/bot/639498607632056321)

[![Support Server](https://img.shields.io/discord/641117791272960031?color=0FAE6E&label=discord%20server)](https://discord.gg/39DwwUV)

[![CI](https://github.com/Iapetus-11/Villager-Bot/actions/workflows/ci.yml/badge.svg)](https://github.com/Iapetus-11/Villager-Bot/actions/workflows/ci.yml)

## Notable Features

* Check/ping the status of any Minecraft server (Bedrock & Java supported!)

* Ability to generate Minecraft pixel art from images sent in the chat

* Expansive economy game (based upon emeralds obviously!) with mining, fishing, farming, quests, and so much more!

* Multi-language support! (English, Español, Français, Português)

* Tons of customization and configuration options

## Support / Contact Information

* [Discord Support Server](https://discord.gg/39DwwUV)

## Technologies

- [discord.py](https://github.com/Rapptz/discord.py)

- [Cython](https://cython.org/)

- [OpenCV](https://opencv.org/) + [Numpy](https://numpy.org/)

- websockets

### Architecture

Villager Bot is separated into two components; Karen and the clusters. A "cluster" is a group of shards (websockets connected to Discord in this case).

Due to the nature of Villager Bot, these clusters need to share state and communicate, which is what Karen facilitates via the use of websockets.

Villager Bot is dockerized and this architecture allows scaling while maintaining functionality and easy development.

## [Privacy Policy](PRIVACY-POLICY.md)

## [Contributing](CONTRIBUTING.md)