FeaturesTags and lists

bitchos has no separate blacklist, safelist or friends file. One system covers all of them: player tags, a label plus an optional note, keyed on the account's UUID so it survives name changes.

Labels

label	badge	typical use
cheater	✖ dark red	confirmed
sus	? red	a hunch, not an accusation
sweat	▲ gold	strong, plays to win
rusher	» yellow	rushes early
runner	~ aqua	runs
friend	♥ green	the friends list
note	• grey	anything else

/bitchos tag <player> <label> [note…]
/bitchos untag <player>
/bitchos tags [player]

A nick or an unresolved name is refused with an explanation; the refusal starts a lookup, so a retry a moment later usually works. Tags live in ~/.bitchos/tags.json.

Where tags show

Controlled by the PlayerTags module:

• a badge in TAB next to the name (ShowInTab; also needs Stats → TagBadges)
• a caution icon over the nametag (ShowOnNametag), with separate switches for your own tags, shared tags, Urchin flags, local AntiCheat flags, and whether sus counts
• a chat alert when a tagged account joins your lobby (Alert, Sound, AlertOn)

Scripts can read and write tags through bitchos.tags and decorate nametags themselves with providers.

The shared database

With Cloud on, labels are shared with hwic.dev and you see what other users have flagged. The design is deliberately narrow:

• The server stores label triples and answers with counts only. It never says who tagged anybody.
• Notes are uploaded only if ShareNotes is on. It is off by default because a note is written expecting privacy.
• Your own tag always outranks a shared one.
• A shared tag alerts you only once MinShared other users agree (default 3). A single stranger's opinion is not an alert.
• A shared sus never goes over a head unless NametagSus is on.

Urchin blacklist

Urchin is a community database of known cheaters. With a key set, bitchos marks flagged accounts in TAB and on nametags and can announce them in chat. One request per name, cached for 30 minutes; nothing is stored server-side.

The key is yours: bitchos does not ship one.

/bitchos set Stats UrchinKey <key>
/bitchos urchin              # is the key present and accepted, and what has it judged
/bitchos urchin <player>     # clean, a headline tag with reason, or "queued — ask again"

Related switches: Stats → UrchinWarn (chat), PlayerTags → NametagUrchin (nametag icon).

Hypixel API key

Optional. Stats come from a shared source by default. With your own key from developer.hypixel.net, the quota is yours alone.

/bitchos apikey <key>
/bitchos apikey clear

Or Stats → HypixelKey in the menu, which renders masked. Pick the source explicitly with Stats → Source: Auto uses your key if set, then the keyless mirror, then hwic.dev.

Map blacklist

The maps AutoRequeue leaves. The catalogue is served from hwic.dev and cached in ~/.bitchos/maps.json, so a Hypixel rotation is a server file edit rather than a mod release.

Set AutoRequeue → MapFilter to Blacklist, then tick maps in the Maps list. From chat: /bitchos set AutoRequeue Maps <mapname> flips one; all and none do the lot. See auto-requeue.

Not in this build

AutoBlacklist, AutoSafelist and a separate safelist are on the parity list but not implemented. The friend tag is the friends list.