ModulesHypixel¶
Stats default on¶
The headline feature: Hypixel stats appended to every name in the TAB list, plus a threat tier mark in front of the name. It is injected at the point vanilla builds each row, so vanilla's own column maths does the layout. Bed Wars shows 231✫ 7.90 (star coloured by prestige, FKDR on a shared skill ramp); SkyWars shows KDR and wins; elsewhere, network level.
| setting | type | default | description |
|---|---|---|---|
Game |
Auto · Bedwars · Skywars |
Auto |
Which stats to show. Auto follows the game you are in. |
ShowGuild |
toggle | on | Show guild tags. Free: read from the nametags Hypixel already sends. |
AlignColumns |
toggle | on | Line every stat up in a column, to the pixel. |
ColumnGap advanced |
12–32 | 12 |
Pixels of breathing room between columns. |
Winstreak advanced |
toggle | off | Add the player's current win streak. |
ShowBBLR |
toggle | off | Add beds broken / beds lost to TAB. |
ShowKDR |
toggle | off | Add ordinary kills / deaths to TAB. |
Threat |
Off · Dot · Score |
Dot |
Colour-code every name by skill tier: a dot, or the 0–100 score itself. |
TagBadges |
toggle | on | Show the PlayerTags badge beside names you or the shared database have flagged. |
ShowNicks |
toggle | on | Mark nicked players in TAB. |
Source |
Auto · Abyss · Proxy · OwnKey |
Auto |
Where stats come from. Auto uses your own key if you set one, then the keyless mirror, then hwic.dev. |
HypixelKey |
text, masked | empty | Your own Hypixel API key from developer.hypixel.net, so the quota is yours alone. |
UrchinKey |
text, masked | empty | Your api.urchin.gg key. Marks known cheaters in TAB. |
UrchinWarn |
toggle | on | Announce in chat when a blacklisted player is in the lobby. |
Prewarm advanced |
toggle | on | Load the lobby's stats before you open TAB. |
Diagnostics: /bitchos stats, /bitchos tab. Set the Hypixel key from chat with /bitchos apikey <key>; it is never echoed back.
ChatStats default on¶
Prints a player's stats into chat the first time they speak in the lobby, and can print the entire lobby when /who answers. Also alerts you when somebody says your name.
| setting | type | default | description |
|---|---|---|---|
Where |
OutsideHub · PreGameOnly · MentionsOnly |
OutsideHub |
Where to print stats for everyone who talks. Hubs are never included. |
AfterWho |
toggle | on | Print stats for the whole lobby when /who answers. Needs AutoWho on to ask in the first place. |
MentionAlerts |
toggle | on | Anywhere on Hypixel, show the stats of anyone who says your name. |
IncludeSelf |
toggle | off | Also print your own stats when you talk. |
WaitMs advanced |
500–15000 | 6000 |
How long to wait for stats before giving up on a player. |
Debug advanced |
toggle | off | Log what it saw and why it did or did not print. |
AutoWho default off¶
Runs /who automatically when a game starts, triggered off Hypixel's "the game starts in 1 second" line, so stats are already resolved before you open TAB. This sends a command; see server safety.
| setting | type | default | description |
|---|---|---|---|
HideOutput |
toggle | on | Hide the /who reply so chat stays clean. |
DelayTicks advanced |
10–200 | 60 |
Ticks to wait after the countdown ends before asking. |
AutoGG default off¶
Says a short message in chat when a game ends. This sends chat; see server safety.
| setting | type | default | description |
|---|---|---|---|
Message |
text | gg |
What to say. Keep it short; Hypixel filters spam. |
OnLoss |
toggle | on | Also say it when you lose. |
DelayTicks advanced |
10–200 | 40 |
Ticks to wait before sending. Too soon and Hypixel drops it. |
PlayerTags default off¶
Persistent notes on accounts: a label from a fixed list plus optional free text, keyed on UUID so it survives name changes. Shows a badge in TAB and a caution icon over the nametag, alerts when a tagged account joins your lobby, and optionally shares labels with hwic.dev's counts-only database. See Tags & lists.
| setting | type | default | description |
|---|---|---|---|
Cloud |
toggle | on | Share labels with hwic.dev and see what other users have flagged. |
ShareNotes |
toggle | off | Also upload the free text of your tags. Off by default: a note is written expecting privacy. Visible when Cloud. |
Alert |
toggle | on | Announce in chat when a tagged account joins your lobby. |
Sound |
toggle | on | Play a ping with the alert. Visible when Alert. |
MinShared |
1–25 | 3 |
How many other users must agree before a shared tag alerts you. Your own tags always alert. Visible when Cloud. |
AlertOn |
checkbox list | none (= all) | Which labels are worth interrupting you for: cheater, sus, sweat, rusher, runner, friend, note. |
ShowInTab |
toggle | on | Put the tag's badge next to the name in TAB. |
ShowOnNametag |
toggle | on | Draw a caution icon on the nametag above flagged players. |
NametagOwnTags |
toggle | on | Let your own tags put an icon over a head. Visible when ShowOnNametag. |
NametagSharedTags |
toggle | on | Let tags from the shared database do the same, once MinShared other users agree. Visible when ShowOnNametag and Cloud. |
NametagUrchin |
toggle | on | Also mark accounts on the Urchin community blacklist. Needs an Urchin key in Stats. Visible when ShowOnNametag. |
NametagAntiCheat |
toggle | on | Also mark whoever the local AntiCheat flagged this session. Visible when ShowOnNametag. |
NametagSus |
toggle | off | Include sus-level flags. Off by default: an uncorroborated hunch is not worth an accusation over someone's head. Visible when ShowOnNametag. |
Commands: /bitchos tag <player> <label> [note], /bitchos untag <player>, /bitchos tags [player].
ThreatReport default off¶
Shown in the menu as Threat report. Prints the lobby's 0–100 threat score, its tier and who is carrying it, once, a few seconds after a match starts. It waits for stat lookups to settle rather than firing on a fixed timer. See Threat & rush.
| setting | type | default | description |
|---|---|---|---|
AutoReport |
toggle | on | Print the lobby threat report once, when a match starts. |
WaitForStats |
toggle | on | Hold the report until the stat lookups stop arriving, instead of printing on the timer alone. |
ReportDelay advanced |
1–30 s | 3 |
Seconds to wait after a match starts, so stats have time to arrive. |
SettleLimit advanced |
2–40 s | 12 |
Never wait longer than this. A lobby of nicks never settles. Visible when WaitForStats. |
Diagnostic: /bitchos threat, and /bitchos threat teams [player] for who was excluded as a teammate and why.
Wrapped default off¶
Shown in the menu as bitchos wrapped. Records every match you play (mode, map, outcome, duration) plus a daily reading of your lifetime stats, and reports your maps, hours and where your FKDR is going over a chosen window. Hypixel exposes lifetime totals and no match history, so a game not recorded as it finishes is gone; that is why this is a module rather than a lookup.
| setting | type | default | description |
|---|---|---|---|
Window |
7 · 30 · 90 |
30 |
The default number of days /bitchos wrapped covers. |
MinGames |
1–25 | 4 |
How many games a map needs before it is ranked rather than pooled. |
AnnounceStreaks |
toggle | on | Say something when a session's win streak reaches a round number. |
TrackProgression advanced |
toggle | on | Read your own lifetime stats once a day, to build the FKDR curve. |
Command: /bitchos wrapped [days] (1–365). FKDR is reported as a delta between two dated readings, never a fitted trend. Data lives in ~/.bitchos/history.json.
AutoRequeue default off¶
Requeues Bed Wars 4v4 (/play bedwars_two_four) until the lobby is worth staying in: it leaves when a game ends, when the lobby was not empty on arrival, when a party big enough to fill a team joins, or when the map is on your blacklist. Full design on the auto-requeue page.
Confirm mode is the safe choice
Sending commands automatically breaks Hypixel's rules. Confirm only prints the command it would have run and leaves it to you.
| setting | type | default | description |
|---|---|---|---|
Mode |
Automatic · Confirm |
Automatic |
Automatic sends the command for you. Confirm only suggests it. |
SeekFreshLobby |
toggle | on | Keep requeueing until you land in an empty lobby. |
DodgeParties |
toggle | on | Leave when a party joins that is big enough to fill a team. |
MapFilter |
Off · Blacklist |
Off |
Blacklist requeues out of the picked maps. |
Maps |
checkbox list | none | Which maps to leave. The list comes from hwic.dev's map catalogue. Visible when MapFilter = Blacklist. |
RequeueOnGameEnd advanced |
toggle | on | Requeue automatically when a game finishes. |
FreshMaxPlayers advanced |
1–8 | 1 |
How many players still counts as a fresh lobby. Visible when SeekFreshLobby. |
MaxRequeues advanced |
1–40 | 8 |
Safety cap on requeues before it gives up and stays. |
Announce advanced |
toggle | on | Print why it is requeueing. |
Debug advanced |
toggle | off | Log every decision, for working out why it did or did not requeue. |
Diagnostic: /bitchos requeue. Party detection comes from the PartyDetector module.