mirror of
https://github.com/rivi-s/pfQuest-turtle-HDB-Install.git
synced 2026-11-19 09:34:35 +00:00
55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# Optional pfQuest-HDB Hitch Profiler 1.0.3
|
|
|
|
This is a diagnostic addon, not a DLL or replacement pfQuest installation.
|
|
It updates the older profiler supplied with previous install repositories.
|
|
Uses the current tested instrumentation: frame/event/callback/decoder timings,
|
|
memory and GC thresholds, startup gates, route/map readiness and visibility.
|
|
Works with existing HearthDB DLLs. The exp.3 DLL additionally supports native
|
|
phase timings and diagnostic dumps. A memory drop does not identify the addon
|
|
that originally allocated the garbage; instrumentation itself has some overhead.
|
|
|
|
## Install
|
|
Replace the old Interface/AddOns/pfQuest-HDB-HitchProfiler folder with the
|
|
pfQuest-HDB-HitchProfiler folder in this ZIP. Do not install a second copy under
|
|
a renamed folder. Run /reload, or restart when also changing a DLL.
|
|
|
|
## Capture login
|
|
Login capture is off by default. Run /hdbhitch login on, then /reload or log in
|
|
again to capture 45 seconds after entering the world. Send the chat
|
|
output, including the 'profiler 1.0.3' line if available. With the experimental
|
|
DLL it also requests Logs/hdb_delivery_exp3.log at capture end.
|
|
|
|
## Capture a random hitch or quest completion
|
|
Run /hdbhitch on BEFORE reproducing the
|
|
problem. When done, run /hdbhitch off and copy the relevant chat lines.
|
|
With exp.3, request an updated native timing log after reproduction using:
|
|
/run if HDB_DumpDeliveryDiagnostics then DEFAULT_CHAT_FRAME:AddMessage(tostring(HDB_DumpDeliveryDiagnostics())) end
|
|
Then attach Logs/hdb_delivery_exp3.log, if created. The old DLL has no native
|
|
dump function; send its chat capture instead.
|
|
|
|
Compare the old and experimental DLL with the same addons and settings. Fully
|
|
exit before replacing a DLL. Include pfQuest-HDB/DLL versions, what happened,
|
|
and whether the hitch also occurs with the old DLL. Review logs before sharing.
|
|
|
|
/hdbhitch status reports capture state. /hdbroute reports routing state.
|
|
Disable this diagnostic addon after testing. Only the login capture preference is saved.
|
|
|
|
## Saved login capture setting
|
|
/hdbhitch login off disables automatic capture after entering the world and
|
|
stops an automatic capture already running. The setting is saved per character
|
|
and survives /reload and future logins. /hdbhitch login on enables automatic
|
|
capture on the next world entry. New installations default to login capture OFF. Existing saved preferences are
|
|
preserved; use /hdbhitch login off to disable a previously enabled setting.
|
|
|
|
Manual /hdbhitch on and /hdbhitch off remain independent; disabling automatic
|
|
login capture does not stop a manually started capture. /hdbhitch status shows
|
|
both current capture state and the saved login setting.
|
|
|
|
## Manual capture file
|
|
With the client ExportFile API (Nampower), /hdbhitch on starts a separate
|
|
Imports/hdb_hitch_manual.txt file. It contains the latest 2000 diagnostic lines,
|
|
exports every 30 seconds, and exports again on /hdbhitch off or logout. Each new
|
|
manual capture replaces the previous file; copy it before starting another.
|
|
This does not overwrite Logs/hdb_delivery_exp3.log. Without ExportFile, chat
|
|
capture still works. Login capture remains off by default.
|