FeaturesDiagnostics¶
Every engine in bitchos can explain itself. Before reporting anything, run the command for the symptom and read what it says; most reports are answered by the first line.
By symptom¶
| symptom | run | what to look for |
|---|---|---|
| "Unlicensed" or nothing works | /bitchos licence |
the last result and what the server said. A network failure means offline grace, not a rejection. |
| No stats in TAB | /bitchos stats |
whether the TAB hook applied, whether you are on Hypixel and which game, the active source, the current backoff and last error, and whether any chat packets were seen at all. |
| Stats aligned wrong | /bitchos tab |
the columns as the hook builds them. |
| Ping missing or wrong | /bitchos ping |
whether Ping is on, and the lobby's raw values. |
| Threat score looks wrong | /bitchos threat, then /bitchos threat teams |
the unknown percentage, and who was excluded as a teammate. |
| Rush pick looks wrong | /bitchos rush |
which teams have a learned island and which were excluded. |
| No timer alerts | /bitchos timers |
whether the sidebar was parsed and a generator is in range. |
| Hitboxes do not draw | /bitchos hitboxes |
which of the two render hooks is live. "Neither" is a different bug from "drawn 0". |
| Requeue did or did not fire | /bitchos requeue |
the fill, party and map it saw, and the count used. |
| Pre-game detection wrong | /bitchos sidebar |
the raw scoreboard and how it was interpreted. Also in the log. |
| AntiCheat flagging or silent | /bitchos ac |
per-player check state. Also in the log. |
| Party alerts not sent | /bitchos party |
whether they can be sent and why not. |
| Urchin marks nobody | /bitchos urchin |
whether the key is present and accepted. |
| Obsidian will not place | /bitchos misplace |
what AntiMisplace is blocking. |
| Cape not showing | /bitchos capes |
which cape is selected and where to add your own. |
| A script does nothing | /bitchos script errors, /bitchos script hooks |
the last error, and which host hooks are live. |
Reading a stats report¶
/bitchos stats walks the whole chain in order. The first line that is not green is the problem:
- module enabled: it is on by default; check it was not toggled.
- TAB hook applied: the hook is optional so that a client rename skips it instead of crashing. If it never fired, the report says so, and that is a bug report with the exact client version.
- on Hypixel, game: outside Hypixel there is nothing to show.
- fetcher running, entries cached: how many lookups have resolved.
- source and backoff: a 503 or 403 backs off for 10 minutes, a 429 for 60 seconds. If your own key is set, that is the source in use.
- chat packets seen: zero means the chat hook never applied, which also disables ChatStats and every chat-driven event.
Logs¶
Lines from the mod are prefixed [bitchos] in latest.log. On Lunar, the agent also writes ~/.bitchos/agent.log every launch, with the loader version on the first line, and the installer writes ~/.bitchos/install.log with the exact paths it wrote. If agent.log is missing, the JVM argument never ran; if it is present but the mod is not, the report is in that file.