A bot used to Bridge between Discord and Hypixel guild chats.

🚨 USE AT YOUR OWN RISK: This application will log into Minecraft using Mineflayer, a Minecraft bot client. This may be against the rules of some servers and could result in punishment. All contributors to this repository are not liable for damages, and no warranty is provided under the MIT License.

⚠️ MAINTENANCE NOTICE: This application will no longer receive updates that contain new features or QOL improvements. Updates, where necessary, will only contain patches for security vulnerabilities and bugs.

• Features
• Installation
  • Prerequisites
  • Setup
• Contributing
  • Issues and Bug Reports
• Acknowledgements
• License

• Bridges between Discord and Hypixel guild chats.
• Sends all guild related messages, including chat, guild announcements and more to Discord.
• Automatic restarts and reconnections.
• Toggleable use of Discord emojis for Hypixel ranks in chat messages.
• Privileged slash commands to control bot behaviour in-game.
• Toggleable slowmode to slow and control member usage.

• Git
• NodeJS >=16.6.0 and npm
• A full access Minecraft Java Edition account

1. ⭐ Star this repository!
2. Clone the repository into a directory of your choice.

$ git clone https://github.com/MiscGuild/bridge.git

3. Enter the new directory and install packages.

$ cd bridge
$ npm install

4. Make a new Discord bot account on the Discord Developer Portal and retrieve the bot token.

5. Under the Bot tab, grant the bot the Message Content Intent.

6. Generate an invite URL by going to the OAuth2 tab and clicking on the URL Generator. Add the bot and application.commands scopes, before opening the link to invite the bot to your server.

7. Fill out the .env.template file with your credentials and rename it to .env.

8. Remove the .template file endings from src/util/_blacklist.json.template and src/util/emojis/_emojiIds.json.template.

9. Promote the Minecraft account the bot uses to Officer in-game in order for it to view the Officer chat and run privileged commands.

10. Build and run the bot.

$ npm run build
$ npm start

Optionally, you may activate the use of rank emojis in discord messages by following these steps:

1. Run the /emojis upload command in a discord server of your choice. (Note: It is recommended to run this command in an alternate server, as it uses a significant number of emoji slots. In this case, only the user of id BOT_OWNER_ID is the only person with permission to run this command).

2. Set the value of USE_RANK_EMOJIS in the .env file to true (Use false to disable this feature).

If at any time you wish to delete the emojis created by the bot, run the /emojis remove command.

Pull requests are welcome. If you would like to chat with other developers please join our Discord and go to #programming-talk.

Please ensure commit messages follow the Angular Convention and all code has been tested before contributing.

To submit an issue or bug, please contact a developer or open an issue here.

Parts of this project use code from the following repositories:

• Hychat Self-Host Under MIT License.
• Hypixel API TypeScript Under MIT License.

This is an open-source project licensed under the MIT License.