Skip to main content
/promote with a user and a rank gives a Discord member a rank in-game and on Discord in one go. It is bot-admin only.

​
The ranks

Highest first: The three officer tiers share Hypixel’s one Officer rank; the tier exists only on Discord.

​
What it does

  • In-game: /g setrank <name> <rank> in the guild you name, or else in whichever bridged guild the member is in, found by reading the rosters. This needs a bridge link: a member who has not linked is ranked on Discord only. The bot never guesses a Minecraft name from a nickname, because a wrong guess would change somebody else’s rank.
  • On Discord: the rank’s role, the other five rank roles removed, and the nickname [Rank] <Minecraft name> (their own name when unlinked), cut to Discord’s 32 characters. The Knight role stays.
Each step reports separately in the reply, one failing does not stop the others, and the whole change is recorded in the audit channel.

​
Setting it up

  1. Put each rank’s role id in .env (see Configuration) and restart the bot. A rank with no id set uses the server role with the rank’s name. An id that matches no role is reported rather than replaced by a same-named role, so a deleted role is noticed.
  2. Give the bot Manage Roles and Manage Nicknames, with its own role above every rank role and above the members it ranks. Discord never lets a bot rename the server owner.
  3. The guild’s Minecraft account must be allowed to change ranks in-game.