2026-11-16 01:00:42 +01:00

ChronicleClassic.com

ChronicleCompanion

Every raid tells a story. Chronicle helps you read it.

The official companion addon for ChronicleClassic.com — created and maintained by the Chronicle team. ChronicleCompanion enriches your combat logs with extended unit metadata so Chronicle can transform them into clear, actionable insights for raid leaders.

⚙️ Built for WoW 1.12 clients (Vanilla)

Upload your logs at chronicleclassic.com.

Features

  • Extended Unit Tracking — Automatically logs unit GUIDs, names, levels, owners (for pets/minions), and buff information to your combat log
  • Challenge Mode Detection — Detects and logs player challenge modes (Hardcore, Level One Lunatic, Exhaustion, etc.)

Requirements

  • World of Warcraft 1.12 client
  • Nampower

Installation

  1. Download the latest release
  2. Extract to your Interface/AddOns/ folder
  3. Ensure the folder is named ChronicleCompanion
  4. Restart WoW

Usage

On Raid Night

Optional: Configure the addon with /chronicle config

1. Prepare the logs

Type /chron delete to delete any existing logs.

2. Do your raid

3. Save your logs

Type /chron save to save the logs to disk.

4. Upload the file

Upload <VanillaWoWFolder>/CustomData/Chronicle_<character_name>.txt to ChronicleClassic.com.

Chronicle Sidekick (addon integration)

The configuration window includes Archive and upload... and a collapsible Sidekick status tray, sharing the right side with Extra Events. Uploading archives the current log, starts a fresh log session, and queues the immutable archive for a compatible Chronicle Sidekick. The tray shows request-level processing status, retries, and copyable links to all instances found in a log. Select Say, Yell, Guild, Party, or Raid in the tray, then use Announce on an instance to share its name and URL. Stock Vanilla chat does not make web URLs clickable; recipients need a URL-handling addon for that. Use /chronicle upload to open the upload confirmation without opening settings. A live, ready Sidekick is required for the upload button.

This addon uses Chronicle local RPC v1: ChronicleRPC.requests, ChronicleRPC.status, and combat_log.upload. A Sidekick build implementing that contract is required; the earlier ChronicleSidekick.* wire format is not supported. Sidekick owns managed archive retention and can retry either upload or Chronicle processing without a new log boundary. Future RPC/cache ideas are tracked in Sidekick #32, not implemented v1 features.

Slash Commands

Command Description
/chronicle help Show all available commands
/chronicle config Open the options panel
/chron delete Delete existing logs
/chron save Save logs to disk
/chronicle upload Confirm archive and upload via Sidekick

You can also use /chron as a shorthand for /chronicle.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Development checks

Install Node.js, then run the static WriteN arity checks:

npm ci --prefix tools/write-arity
npm test --prefix tools/write-arity
npm run check --prefix tools/write-arity

The Lua tests require Lua 5.0.3 because the baseline Write implementation uses Lua 5.0 vararg semantics:

tools/install_lua_5_0_3.sh .cache/lua-5.0.3
.cache/lua-5.0.3/bin/lua tests/raid_composition_test.lua
.cache/lua-5.0.3/bin/lua tests/ursol_client_test.lua
.cache/lua-5.0.3/bin/lua tests/write_correctness_test.lua
.cache/lua-5.0.3/bin/lua tests/talent_invalidation_test.lua
.cache/lua-5.0.3/bin/lua tests/sidekick_test.lua
.cache/lua-5.0.3/bin/lua tests/sidekick_ui_test.lua
.cache/lua-5.0.3/bin/lua tests/options_refresh_test.lua

License

MIT

Author

Emyrk · Creator of ChronicleClassic.com


ChronicleCompanion is the official addon for ChronicleClassic.com — every raid tells a story. 📜

S
Description
No description provided
Readme
316 KiB
Languages
Lua 100%