kompolompoandClaude Sonnet 5
60c67c5eef
Missing/incorrect ClassicAPI.dll causes errors and a blank grey readout; add setup and troubleshooting notes. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
## OctoLatency
|
|
|
|
A lightweight latency monitor for Vanilla WoW (1.12.1). Shows a small, movable,
|
|
color-coded latency readout on your screen.
|
|
|
|
### Requirements
|
|
|
|
- **ClassicAPI.dll** must be installed before you install this addon. Without
|
|
it, the addon will throw errors and the readout will show as an empty grey
|
|
box with no text/numbers inside it.
|
|
- You'll need to add `ClassicAPI.dll` to your client's `dll.txt` (the entry
|
|
is case-sensitive).
|
|
|
|
### What it does
|
|
|
|
- Displays your current world latency (falls back to home latency if world
|
|
isn't available) as `NNN ms` next to your screen.
|
|
- Color-codes the number so you can tell your connection quality at a glance:
|
|
- **Green** — under 150 ms (good)
|
|
- **Yellow** — 150-350 ms (moderate)
|
|
- **Red** — over 350 ms (critical)
|
|
- Hover the frame for a tooltip with home latency, world latency, and
|
|
bandwidth.
|
|
- Updates every 2 seconds (not every frame), so it has no meaningful impact on
|
|
game performance.
|
|
|
|
### Options
|
|
|
|
There's no settings panel — the addon is intentionally minimal. The only
|
|
"option" is position:
|
|
|
|
- **Move it**: left-click and drag the frame anywhere on screen. Its position
|
|
is saved automatically and restored on your next login.
|
|
|
|
### Error reporting
|
|
|
|
If something inside the addon errors (e.g. an unexpected `GetNetStats()`
|
|
response), it's caught instead of spamming a Lua error popup, and logged for
|
|
you to report:
|
|
|
|
- `/octolat errors` — print the last 20 logged errors (with timestamps) to
|
|
chat.
|
|
- `/octolat copyerrors` — open a copy-paste window with the same log, since
|
|
vanilla WoW's chat frame doesn't let you select/copy its text. The window
|
|
opens with the text already highlighted, so you can just press Ctrl+C.
|
|
- `/octolat clearerrors` — clear the error log.
|
|
|
|
The log is also saved to your `SavedVariables` file, so it survives
|
|
logout/relog.
|
|
|
|
### Troubleshooting
|
|
|
|
- **Grey box with no numbers / constant errors**: This almost always means
|
|
`ClassicAPI.dll` isn't installed correctly. Check that:
|
|
- `ClassicAPI.dll` is present in your client folder.
|
|
- It's listed in `dll.txt` exactly as `ClassicAPI.dll` (matching case — the
|
|
entry is case-sensitive).
|
|
- After adding it, fully restart the client (not just `/reload`).
|