Skip to main content


We've worked hard over the last few months to bring you this massive update!

Developers: Please read the hint for developers below.


  • Increased Custom Games player limit. For Premium users, the max. player number per custom game queue has been increased to 520 players (previously: 149). That allows you to fill up to five lobbies with a single key distribution process.
  • New Dashboard.
    The dashboard has been rewritten from scratch. It aims to be more user and mobile friendly and is generally cleaner and more polished than the old dashboard. Additionally, it includes some more new neat features like some server statistics. This also includes dashboard logs that tracks every action and change on your dashboard if an unwanted change happens and you need to figure out who it was.
  • Live Host feedback.
    The custom game process now features an advanced process feedback system while hosting. While the old version just showed a few numbers, the new version will show you the state each player is in. For example: how many players are in a certain step, who got rejected and why, and so on - all in real-time, on your dashboard while hosting. Amazing!
  • Custom and Creative Game Presets.
    Custom Games and Creative Matchmaking are now controlled using Match presets. That means that administrators of each server have to predefine one or more presets that include all the match settings that have previously been configured directly on the host page itself. Hosts can only use these presets and can not change settings anymore. This prevents abuse, and the accidental misconfiguration of the custom games feature by hosts that are not desired by server administrators. Moreover, these presets allow a much more detailed configuration of the whole hosting process; in particular, you can configure one channel per message type.
  • Custom Games Ban Detection.
    The updated version of custom key distribution can scan for banned players in each party and reject that party if a banned player has been found. Therefore, if you have this setting turned on, banned users can't join your matches by queueing with other players anymore. If you want, you can even require all players in each party to be verified (instead of only the party leader).
  • Custom Games auto-retry.
    If a user times out in the middle of a key insertion process, Yunite will give them a second chance and restart the process. In a few first tests, this appears to significantly increase the success rate of custom game key insertions.
  • Enhanced creative session building.
    The creative match builder has been equipped with the same stunning live feedback system of the custom games key distribution system. Moreover, it has been changed so that each user only has to add one bot and stay its friend all day - no need to re-add it for every single box-fight!
  • Custom Command Groups.
    Many servers are using Yunite's command system and have come up with lots of commands! The new version allows you to group your custom commands into groups of related commands for a better overview and allows you to change permissions of all commands in a group with a single setting.
  • Custom Command Replacements. For a long time, {user} was the only available replacement you could use in messages sent by Yunite through the commands system. We added a long list of new replacements that enable users to mention roles, channel, or users in these messages easily or show data related to the invoking user, the channel, or the server. You can find a list in our documentation on the Commands page.
  • New command action type: Apply Permission Overrides. The custom commands module has a new action type called "Apply permission overrides". It allows you to configure a set of permission overrides that can be applied to a channel once you invoke the command. This is useful to build customized commands to lock channels, combat raids, or any other purpose where you need to switch between a few sets of permission overrides for a channel from time to time. Unlike other bots that offer channel locking, we do not have any opinions on how to lock a channel; you can configure it however you want.
  • Verification flow.
    The verification flow changed slightly; users don't have to enter their Epic Games username anymore, which has been a source of errors and frustration in the past. All users need to add the in-game bot, and the system will figure out the account details.
  • Registration constraint join types.
    You can now configure Yunite to join your registration role constraints to be joined with either AND or OR - on both a constraint type level and a global role level. This allows for more complex constraint structures without creating more roles.
  • Rank system multipliers. You can configure roles in the rank/level system that should receive more XP per messages than regular users by adding a factor between one and five. You can use this for VIPs, as a reward for server boosters, or any other type of reward system.
  • Scheduled Permission Notifications.
    Scheduled Permissions now support a message to be sent into the affected channels to notify users about the channel being closed, for example. This is optional.
  • And maybe one of the other things we forgot to mention ...


  • Snipes.

Developers & API

The new version introduces a completely reworked API. We changed the authentication model from guild based API keys to application keys that need to be authorized on guilds, similar to how bots are added to Discord itself. Additionally, our API endpoints changed significantly.

The legacy endpoints will continue to work for existing systems until 2021-03-01. After that, you must have switched to the new endpoints.

Go ahead and read our new API documentation right now!