Automated Hypixel Tourney Bot

Liability

By running this software you agree that Cryptizism or any other distributors are not held liable including but not limited to: punishment of any sort on the Hypixel Network or any other servers, failure to work, and more.

Requirements

• Java (You will already have this if you can run Minecraft)
• Node.js Version 12 or over
• A Minecraft account
  • Must be able to join Hypixel
  • Person running the bot must have MVP++ for private
• Discord server
  • Must have Manage Server role
• A bot that you own (Click here to create)
• Participants must have access "Slash command" privilege

To-Do list

• Link Discord and Minecraft account
  • Get name from API and see if it matches that of the end-user
  • Change nickname to Minecraft name
  • Make a JSON/DB (file) to link Discord names and Minecraft names so people can't change their nickname and exploit the system
  • Give role with their respected team name
  • Create a JSON/DB (file) to hold teams and team members so there aren't too many roles and bulk
• Let moderators assign teams a round to play in
• Alert players in Discord DMs, Minecraft and in the server to get them ready, this will be triggered by a command a moderator will say
• Party all particpants
• Let the particpants request an invite if: they were not ready, didn't get an invite or any other reason
• (Optional) Output stats of all players after game and post them in the discord

Discord Commands

Commands starting with "/" use the "slash command" feature. Example: 1, 2

Comamnd : Description

Participants

/verify : Links your Discord and Minecraft account

/help : Shows all commands

/creator : Sends my Discord (Cryptizism#2999)

/current : Sends how long till a game starts or if there is a game going on

/invite : Requests another invite for bot if their round is up!

Moderators

tb!setup : Starts the setup process

tb!assign [Team Name] [round] : Assigns people who are in a team a round role

tb!notify [time] [round] : Notifs people with a round role that they are going up in x amount of time

tb!staff [@role] : Sets staff role defaults to people with admin perms

tb!players [@role] : Sets player role for pings

Config

Try not to change the below during the process as it will make it unstable
TOURNEY_NAME = Current tourney name for naming scheme and output images [default: "Bedwars Tournament"]
GAMEMODE = Current tourney gamemode, [solo,doubles,3s,4s]
PER_GAME = Teams per game [solo/doubles: 1-8, 3-4s: 4]
OUTPUT_BOOLEAN = Whether or not to ouput stats
OUTPUT_CHANNEL = Where to ouput stats of the game if it true
ANNOUNCEMENT_CHANNEL = Where the bot will ping for the tourney
BRACKET_BOOLEAN = Whether or not to output a bracket image
BRACKET_CHANNEL = Where to output the bracket image
BRACKET_BG = Bracket background image
IMG_PATH = The path that the auto generated bracket will be located [default: ./images/brackets/{TOURNEY_NAME}]

Installation

1. Install everything in prequisites
2. Go into the .env file and replace CLIENT_ID_HERE with your Client ID, SERVER_ID_HERE with the Server ID, API_KEY_HERE with your hypixel api key
3. Open the start.bat file (This will npm install ect.)
4. Open up Minecraft and go onto Hypixel
5. Use the bot and it should work!
6. Try not to touch anything as it may disturb the process

FAQ

"How does it work?"

First off it gets all the details from the staff members and players! Then after that it will, on command, initate a round inviting all the people that was assigned to be playing in that round. The way it invites people is VIA macro which is where the bot get's use at ur own risk. For the stats it reads your latest.log file and parses it line by line!

"Why should I tust it?"

All the code is open source and at the end it is not even in an exe you can still view the code :)

"I have a question about this project"

Fire me a DM on Twitter or on Discord (Cryptizism#2999)

"What does the bat do?"

The start.bat file installs all of the dependancies and makes it run, this is for less tech literate users 👍🏿

Bugs

Robustness

• If player disconnects/lags out the bot may break