coolstats - rising gods

coolstats brings UwU Logs lookups, a searchable player browser, cached gear and talent inspection, and an optional character-panel overhaul together inside the game.

Supported realms:

• Rising Gods

It is built for raid formation and pugging: instead of repeatedly leaving the game to look players up, you can quickly see their parses, rankings, available specializations, and any equipment or talent snapshots you have previously cached.

NEW FEATURE! Class Representation Statistics in the Player browser (07/22/2026 - v.34)

• Added the Statistics panel from the player browser, with class/spec representation bars, counts, percentages, a bottom sum, and a realm-aware boss drilldown selector.
• Right-aligned class/spec labels into their spec icons for a cleaner chart layout.
• Fixed browser and logs panel tabard backgrounds so the tabard texture stays visible above the black fallback backdrop.

New Major Feature in 0.22! Log Linking and Sharing

• Players who have the addon can now share and link player logs inside of the in-game chat.
• Clicking the link opens up the logs of said player if present in the database of both the person linking and the person opening the link
• Added compact [coolstats: Player] chat tokens that open logs for players running 0.2.22 or later.

Core Features

• Bundled UwU Logs database containing up to the top 600 players for every class specialization.
• Overall raid score, best rank, and specialization-specific parse data.
• Individual boss parses directly inside player tooltips by holding ALT.
• Parse colors and specialization icons make results easy to scan.
• Dedicated logs panels show every available specialization for a player.
• UwU Logs action added to supported player and chat-name right-click menus.

The logs database is bundled with each addon release. coolstats does not make web requests while the game is running.

Player Browser

The player browser brings all available player information into one searchable table:

• Search players by name with responsive, delayed filtering.
• Filter by class, favourites, or main specialization.
• Sort columns in ascending, descending, or default order.
• View main spec, off spec, parses, best rank, and cache availability.
• See whether logs, gear, and talents are available before opening a player.
• Favourite players so they remain at the top of the default list.
• Right-click players to whisper, invite, view cached talents, or favourite them.
• Open the normal logs and cached-armory panels by clicking a player.
• Clear the locally stored inspection cache from inside the browser.
• Comparison mode - compare your logs to any other player side by side.

Cached Gear And Talents

When a player is available within inspection range, clicking, inspecting, or looking them up can store a local snapshot of their equipment and talents. Those snapshots can then be viewed later, even when the player is no longer nearby.

• Paperdoll-style cached gear view with item icons, rarity borders, and item levels.
• Cached GearScore, equipped item level, and implied combat ratings.
• Cached talent builds with specialization backgrounds, rank indicators, specialization switching, and Blizzard-style talent tooltips when available.
• Up to 500 recent player snapshots are retained.
• Snapshots older than 14 days are automatically removed.

Cached gear statistics are estimates derived from item data. Some effects, gems, enchants, talents, buffs, and other character-specific modifiers may not be represented accurately.

Optional Character Panel Improvements

coolstats also includes an optional overhaul of the default character panel:

• Extended stats panel with GearScore, item level, ratings, durability, repair cost, movement speed, and additional class-relevant statistics.
• Reorderable stat rows and configurable sections with quick bulk toggles.
• Favourite important statistics.
• Detachable stat popouts.
• Configurable backgrounds, opacity, zoom, contrast, and text palettes.
• Item-level badges and rarity-colored equipment-slot borders.
• Cleaner item tooltips when GearScore is installed.
• Configurable loot-alert toasts for looted items, roll wins, and crafts.

Character-panel features can be disabled in settings while keeping the logs browser, tooltip parses, and lookup functionality enabled. Changing this option requires a UI reload.

Quick Start

1. Download the repository as a ZIP and extract it.
2. Place the addon folder inside Interface/AddOns/.
3. Ensure the final path is Interface/AddOns/coolstats/coolstats.toc.
4. Restart the game or run /reload.
5. Left-click the coolstats minimap button to open the player browser.

On login, coolstats confirms that it loaded successfully and shows the freshness date of the bundled UwU Logs data. If the data is more than seven days old, the addon displays a red update warning.

Minimap controls:

• Left-click: open the player browser.
• Right-click: open the coolstats menu.
• Left-click and drag: move the minimap button.

Using Player Data

• Hover a player: view their overall UwU Logs result.
• Hold ALT while hovering: view individual boss parses.
• Right-click a supported player name: open their UwU Logs panel.
• Click a player in the browser: open their logs and cached gear.
• Right-click a browser row: whisper, invite, view talents, or favourite.
• Inspect or interact with a nearby player: update their local gear and talent snapshots when inspection data is available.

Commands

If no name is supplied to /coolstats uwu, the current target is used. If there is no target, coolstats uses your character.

Settings And Optional Dependencies

Most visual and quality-of-life features can be configured or disabled from the coolstats settings panel.

• GearScore: optional. coolstats includes its own GearScore calculation; installing GearScore additionally enables compatibility and tooltip-cleanup behavior.
• BonusScanner: optional. Without it, the addon still works normally, but some detailed gear-contribution lines in stat tooltips are unavailable.

Neither dependency is required for logs, the player browser, cached gear and talents, loot alerts, or the character-panel improvements.

Public Data Updaters

Rising Gods log data can be refreshed without waiting for a full addon feature release. The public updaters update only coolstats_Data_RisingGods.

Both launchers show a confirmation screen before replacing live addon files and use numbered progress steps while they work. The Linux launcher is run through bash, so it does not rely on the ZIP preserving executable permissions. Refreshes also include duplicate-name safeguards for reused Rising Gods character names: ambiguous ranked rows are confirmed through the UwU Logs character endpoint, and affected boss rows are automatically repaired. Generated data uses the same dynamic chunk metadata as official releases, so the in-game player data-load slider can avoid loading lower-ranked chunks after the next /reload.

Python 3 Requirement

The public log updaters rebuild the Rising Gods data from UwU Logs on your machine, so they require Python 3. The Windows .bat file launches the PowerShell updater, and that updater calls Python during the data refresh. The Linux .sh launcher calls python3 when it is available, then falls back to python.

Install Python only from the official Python website:

• Download Python: https://www.python.org/downloads/
• Windows setup guide: https://docs.python.org/3/using/windows.html
• Linux and Unix setup guide: https://docs.python.org/3/using/unix.html

On Windows, the easiest setup is the official installer from python.org. During installation, enable the option that adds Python to PATH, then open a new Command Prompt or PowerShell window and run:

python --version

On Linux, most distros already ship Python 3. To check:

python3 --version

If Python is installed under a custom command or path, set it before running the launcher:

$env:COOLSTATS_PYTHON = "C:\Path\To\python.exe"
.\Update_Rising_Gods_Logs.bat

COOLSTATS_PYTHON=/custom/path/python3 bash ./Update_Rising_Gods_Logs.sh

Available modes:

• 1: preview the UI and validate the currently bundled data.
• 2: refresh this working folder only, with no live WoW install.
• 3: refresh and install into a live Interface/AddOns folder.

When the official ZIP is extracted directly into Interface/AddOns, both launchers auto-detect the current folder as the live AddOns folder and ask only for confirmation.

The updater is intentionally readable source instead of a compiled executable. It performs no GitHub publishing, uses no credentials, requests no administrator rights, and ships no maintainer-local paths or saved install folders. It stages new data, audits Rising Gods metadata, encounter coverage, chunk balance, player-load metadata, duplicate keys, duplicate-name repairs, ranked-player count, and rankless-row guards, then backs up the old live data addon before replacement. The installed data addon is audited again after replacement.

If your WoW install is under a Windows protected folder such as Program Files, Windows may deny write access to Interface/AddOns. In that case, run the official updater from an elevated terminal or move the WoW/addon folder to a normal writable location. The updater checks this before downloading data and will leave the existing live addon untouched when writes are denied.

Examples:

.\Update_Rising_Gods_Logs.bat
.\Update_Rising_Gods_Logs.bat -NoInstall
.\tools\update_rising_gods_live_logs.ps1 -ValidateOnly

bash ./Update_Rising_Gods_Logs.sh
bash ./Update_Rising_Gods_Logs.sh --no-install
python3 ./tools/update_rising_gods_live_logs.py --validate-only

Data And Privacy

• coolstats does not make web requests or send telemetry from inside the game.
• Bundled logs are updated by installing a newer addon release.
• Cached gear, talents, favourites, and settings are stored locally in coolstatsDB.
• Cached inspection data can be cleared from the player browser.

Support

Use the blue HELP button inside the player browser for any questions, suggestions, or bug reports.