Skip to content

FeaturesAuto-requeue

The AutoRequeue module keeps sending you to a new Bed Wars 4v4 lobby (/play bedwars_two_four) until the one you land in is worth staying in.

Read this first

Sending commands automatically breaks Hypixel's rules. Mode = Confirm only prints the command it would have run and leaves the decision to you. Automatic mode is at your own risk. See server safety.

Four reasons to leave

All four go through one requeue path, so the Confirm/Automatic split and the MaxRequeues cap apply uniformly.

reason how it is detected switch
the game ended the VICTORY / GAME OVER title RequeueOnGameEnd
the lobby was not fresh the player count read from your own join line, compared with FreshMaxPlayers SeekFreshLobby
a party joined a burst of join lines, from PartyDetector DodgeParties
the map is blacklisted the sidebar's Map: row, falling back to Hypixel's "You are currently playing on X" line MapFilter, Maps

Landing in a fresh lobby resets the requeue counter, so a party arriving later still has a full budget.

Party dodging

Hypixel never tells clients who is partied. What it does do is add a party's members to the lobby in one go, so their join lines arrive together. Detection is therefore a quiet period, not a fixed window: join lines accumulate and the group is reported once nothing new has arrived for BurstQuietMs (60 ms by default).

Three arriving together already own most of a 4v4 team, so that is the dodge threshold. PartyDetector → MinSize on Auto follows the mode's team size.

Map blacklist

Set MapFilter to Blacklist and tick maps in Maps. The catalogue comes from hwic.dev and is cached in ~/.bitchos/maps.json, with a copy bundled in the jar as a fallback.

There is deliberately no whitelist: Hypixel offers no way to queue a specific map, so a whitelist would be a blacklist of everything else with a friendlier name. A config still holding an old Whitelist value is read as no filtering, never inverted into a blacklist.

Diagnosing it

/bitchos requeue prints what the module currently sees: the lobby fill, the party state, the map, how many requeues it has used, and how many maps loaded and from where. Debug logs every decision.