A Discord bot used to bridge between Hypixel guild chat to Discord and vice versa.
Open source, with love from xMdb 🤍

Report a bug · Request a feature · Get in touch

⚠️ This application will login to Hypixel using Mineflayer which is not a normal Minecraft client, this could result in your Minecraft account getting banned from Hypixel, so use this application at your own risk. I am not liable for any damages and no warranty is provided as outlined in GPL-3.0 License.

• ❌ Deprecation Notice!
• Installation
  • Prerequisites
  • Initial Setup
  • Running in the Background
• Acknowledgements
• License

Please note that this application will not receive any more feature updates. This is in favour of the newer version, Hychat. As it is being re-written in TypeScript, new bugs may be found and will be retroactively applied to this version. If you find any bugs, report them in this repositories' issues section. If you would like to request new features, please do so in the new version's issues section, as I will likely add it. At this stage, new PRs will still be reviewed. Once the new version is fully released, this application will no longer be maintained, and no new changes will be accepted.

The new version of this application will feature a dashboard, easier customization, and allow bot management through a Discord bot. It will become SaaS (Software as a Service) for those people who do not wish to create their own personal server. If you are just finding this repository now, please consider waiting for the new version to release, as it will be much more stable and feature-complete. Updates will be provided on the website and via the Hychat Twitter.

Hychat is currently in early alpha stage and in active development. It currently is non-functional and not recommended for use.

• Bridges a Discord channel to Hypixel guild chat.
• Sends all guild related messages to the Discord channel (when I mean all, I mean all).
• Logs guild joins and leaves through a webhook (/g leave, /g join).
• Automatic restart and reconnections, making for zero down-time.
• Contains commands that can be used to control the bot's state, such as powering on and off, and sending chat messages through Discord (bot owner only).
• Slowmode and "say" commands (send messages as the Discord bot) for trusted users.
• Log slowmode and "say" command usage through an additional logging webhook.

The bot is a self-hosted application that runs both a Discord bot and a Minecraft bot, which interconnect with each other. This is done using Discord.js and Mineflayer, two awesome Node.js libraries.

This application is for people who are into self-hosting their own applications on server infrastructures or on their own PC. If you don't know how to, don't worry! In the new version, you will be able to host your own fully-featured guild chat bot in just a couple of clicks! Updates will be provided on the Hychat Twitter.

• Git.
• NodeJS.
• A full access premium Minecraft account that you can use to connect to Hypixel.

1. ⭐ Star this repo!
2. Clone the repo into your own directory.

$ git clone https://github.com/xMdb/hypixel-guild-chat-bot.git

3. Enter the new directory and install the NPM packages.

$ cd hypixel-guild-chat-bot
$ npm install

4. Make a new Discord bot account on the Discord Developer Portal and get the bot token.
5. Grant the Message Intent for the bot.
6. Generate an OAuth2 URL by going to OAuth2 on the left side of the application dashboard and clicking the URL generator. Add the bot and application.commands scopes and open the link to invite it.
7. Re-name the .env.example file to .env and edit the values as instructed.
8. Edit the config.js file to your liking. Ensure you have valid IDs and such otherwise the bot will not work.
9. Test the bot.

$ node app.js

If the bot logs into Hypixel, and you can send and receive messages through Discord, proceed to the next steps! If you are having trouble getting it working, open an issue or contact me through Discord.

1. Install PM2 using npm.

$ npm install -g pm2

2. Use the npm start script to start with PM2.

$ npm start

3. Verify that everything works as expected.

Refer to the PM2 documentation for more information about PM2.

Parts of this project are forked from:

mew/discord-hypixel-bridge under GPL-3.0 License.

Myzumi/Guild-Bot under Apache-2.0 License.

Hypixel Guild Chat Bot is open-sourced software licensed under the GPL-3.0 License.