For World of Warcraft

Addons

One small addon that brings the site into the game. Everyone in the guild should install it; it asks nothing of you while you play.

These downloads are always the latest versions.

Hammerlog

version 72

Your guild's fight reports, in game: damage, healing and deaths for every raid and dungeon fight, shared by your officers, and your guildmates' gear and talents. How.

Also in the same install, for gearing: upgrades for every slot, at your level and for your talents, with where each one drops, and the auction house prices you've seen - for anyone, guild or not. How. Each has its own tabs, and the window opens on the one you used last.

While you play it notes where gear comes from and how much XP things give, for the item finder and the XP page. More below.

Hammerlog is the two old addons, Wowparse Reports and Wowparse Loot, in one. If you have them, install Hammerlog over them: it takes everything they recorded or received.

Download Hammerlog

Installing

Close the game, or plan to restart it: it only finds new addons when it starts.
Unzip the download into your game's Interface/AddOns folder, inside the game's version folder (WoW Forever's is _classic_beta_ during the beta; the name may change when it launches), replacing what's there. You get three folders: Hammerlog, with Hammerlog.toc directly inside it (not one folder deeper), and WowparseLoot and WowparseReports.
At character select, open AddOns and check all three are ticked. If the game says they're out of date, tick Load out of date AddOns.
Log in. Chat says "Hammerlog: version … loaded"; if you had the old addons, also that it took over their records.

The WowparseLoot and WowparseReports folders run no code any more: they only hand what the old addons saved over to Hammerlog. Once you've logged in with Hammerlog and logged out (or typed /reload), you can delete them.

Updating: unzip over the old folders, replacing their files. You don't lose anything: what the addon has recorded or received lives in the game's saved data, not in the addon folder.

Using Hammerlog: reports

/hlog reports opens the window on its Reports tab: pick a run, then which fights. The window opens on whichever tab you used last. /hlog reports status sums up what you have in chat.
The window's Gear tab shows each guildmate's latest known gear from the site: item level, talents, and every slot (hover an item for its tooltip; enchantable slots say whether they're enchanted; gear not seen for 3 days is greyed and listed last). Gear comes from the site's combat logs and from the game: everyone's addon shares their own gear when it changes, and officers' addons share what they see inspecting guildmates. Each character's page says where theirs came from; an officer can take back a wrong one with /hlog gear reset <name>. Player tooltips get a line with it too: item level and HS, the Hammer score - their worn items' stats added up, weighted for their class and talents ("HS 412 (Arms)"; a ? when their talents aren't known and the best fit is shown). It's a rough guide: the weights are rules of thumb, not everyone plays the way they assume, and it compares players of one class and spec better than across classes.
Officers: the Gear tab's Readiness button lists everyone with what they're missing before a raid, and how many are ready ("4 of 18 ready"). It asks for enchants on chest, wrists, hands, feet, back and main hand (and a shield or off-hand weapon, and a hunter's bow or gun) - not head, legs or shoulders, whose enchants are rare - for every slot but shirt and tabard to be filled (an empty off hand is fine beside a two-hander, an empty relic slot for paladins, druids and shamans), and, if you set an item level floor, for no item below it. Sort by name, HS or item level, within each class or overall; hover a row for the details, click it for their gear. In the HS column, ? means their talents aren't known and * that some items couldn't be scored.
Or click the gem on the minimap (drag it to move it; right-click for settings), or set a key under Key Bindings > Hammerlog. The settings are also in the game's AddOns options; /hlog reports minimap hides or shows the gem.
In the window, the right side switches between Damage, Healing, Taken and Deaths. Click a player for their abilities, or a death for what led up to it.
Members: nothing else to do. Reports your officers share arrive on their own while you're online (the run shows "arriving" in the window meanwhile). If you were offline, your addon catches up the next time you're online with that officer.

Officers: sharing a report with the guild

Officers are the ranks that can talk in officer chat.

Upload the night's log on the Reports page.
The helper script brings your guild's newest reports in by itself. Or, on the finished report, download it for the addon and save it as Import.lua in Interface/AddOns/Hammerlog, replacing the one there.
Type /reload in game. The addon takes the report in and shares it with everyone online, about a message a second (a night of dungeons: under a minute). It waits while you're in combat or in an instance.

/hlog reports stop cancels; /hlog reports share sends everything again, if it's ever needed.

Using Hammerlog: gearing

For everyone, in a guild that uses it or not: no log, no site visit.

/hlog upgrades (or the window's Upgrades tab) shows better gear for you, slot by slot: items your class can use at your level that score higher than what you wear, for your talents (pick another spec with one click). Best upgrades lists each slot's best, biggest first.
Items known in game come first, with where they come from: what drops them and how often, quest rewards, vendors, and what your guild has seen on the auction house. Items nobody has seen in game yet are listed apart. The row of buttons above them narrows it down to one kind of source: dungeon and raid drops, world drops, quests, vendors or the auction house.
Item tooltips get a line when an item would be an upgrade for you: "Hammerlog: an upgrade for your hands (+12%, Arms)".
The item list comes with the download and is rebuilt from the site's data every few hours: download again now and then to pick up new drops and sources.
/hlog prices (or the Prices tab) searches the auction house prices Hammerlog has seen, by item name: the newest price, how many were up, and the lowest of the last two weeks. It records the prices your auction house searches show.

Using Hammerlog: where gear comes from

Combat logs don't say where gear comes from or how much XP things give. Hammerlog notes it while you play, and what you send here feeds the item finder, upgrade suggestions and the XP page. It records:

what drops from what, quest rewards and what vendors sell
XP per kill and per quest
items seen on other players and on the auction house (what your searches there show; the window's Prices tab, or /hlog prices, searches them by name)
a snapshot of each player it inspects: what they wear and their talents, with their class and level, so the site can show what each spec actually wears and picks

It keeps no character or seller names. Snapshots are kept under the game's ID for the character; the site keeps them under a coded form of that ID, never the ID itself.

Check it's running

When you log in, chat says "Hammerlog: version 72 loaded".
/hlog shows what it has recorded so far.
/hlog scan on also looks at the gear and talents of players near you (turn friendly nameplates on). /hlog gear says how many players' snapshots it holds.

Send its file

The game saves it when you log out or /reload, at WTF/Account/<account>/SavedVariables/Hammerlog.lua. Upload it here now and then, or let the helper script do it.

Uploading needs a login, so the site knows whose records they are. In a guild you may not need to: an officer's file carries the whole guild's records (guild sync).

Guild sync

In a guild, Hammerlog quietly shares what it records with the guild's officers who run it, so an officer's file carries the whole guild's records and members don't need to upload theirs. Members send their changes to one online officer; officers pass them to each other on the officer channel. Only changes travel, at the game's pace for addon messages, so a big first sync takes a while (a few thousand records: about a quarter of an hour of play).

/hlog sync shows how it's going, including the pace it has found: it starts at a message a second and speeds up until the game says it's too fast, then stays a little below that. It never sends in combat or during a boss fight, only between pulls. /hlog sync off stops it.
Officers are the ranks that can talk in officer chat, as your guild's rank settings say - nothing to set up. Only if the game doesn't tell the addon does it fall back to ranks 0 and 1 (/hlog rank 2 counts rank 2 too).
Nothing names anyone: each install has a random ID, and the site counts each install once however many files its records arrive in.

The helper script

Optional: a small script that sends Hammerlog.lua and your finished combat logs for you, and brings your guild's gear data and newest reports into Hammerlog.

Nothing to install. Plain-text scripts that use what your computer already has (PowerShell and curl on Windows 10+, sh and curl on macOS / Linux). Open them in a text editor to see exactly what they do.
Runs only when you start it. Double-click it after playing (after logging out or /reload, when the game saves the file). It adds no service, startup entry or scheduled task. Start it with --watch (-Watch on Windows) to keep checking every 2 minutes while its window is open.
Sends your combat logs too (version 4): finished ones only, never the one the game is still writing, each once, shared with the token's guild (private without one). Sending a log that has grown since adds to its report rather than making another. It also brings your guild's newest reports into Hammerlog's Import.lua. LOGS=no and REPORTS=no in the .conf turn either off.
Sends: Hammerlog.lua files, only when they've changed, and it prints each one before sending.
Uses a token, not your Discord login. A token can only upload the addon's file and your logs, and fetch the guild's gear data and reports. Make it for your guild, so your logs are shared with it and its reports come back. Revoke it below any time.

Make a token

Run it

Unzip anywhere. If you didn't download it with your token, open l2p-helper.conf in a text editor and paste the token after TOKEN=. Then, after playing:

Windows: double-click l2p-helper.cmd.
macOS / Linux: in a terminal, sh l2p-helper.sh.

It finds the game under the usual install folders; if yours is elsewhere, set GAME_DIR= in the .conf file, written as it is: spaces are fine, and ~ is your home folder (GAME_DIR=~/Games/World of Warcraft). It uploads to https://l2p.lol.

Download the helper (no token)