CharacterStats

A lightweight, customizable addon for tracking your character's statistics in World of Warcraft.

Overview

CharacterStats displays your character's important stats in a clean, movable frame. Track Strength, Agility, Intellect, Critical Strike, Haste, Mastery, Versatility, and more—all without opening the Character panel.

Highlights

• 📊 Movable stats frame with real-time updates
• 🎨 Fully customizable fonts, colors, and layout
• 🛡️ Optional class-colored borders and themes
• 💬 Shift-click the frame to share stats in chat
• 🎯 Smart filtering shows only relevant stats for your spec
• ⚙️ Auto-switching profiles for different specializations
• 🗺️ Minimap button for quick access
• 🌍 Localized in 12 languages

Features

🎯 Smart Stat Display

• Role-Based Filtering — Automatically shows only relevant stats for your spec and role
• Tank Stats — Dodge, Parry, Block automatically shown for tank specs
• Caster Stats — Spell Power, Mana Regen for casters and healers
• Physical Stats — Attack Power for melee and ranged DPS
• Primary Stat Auto-Filter — Shows only your spec's primary stat (Str/Agi/Int)
• Item Level — Automatically color-coded by gear quality

⚙️ Spec-Based Profiles

• Auto-Switching — Automatically switch settings when you change specs
• Per-Spec Customization — Different stat displays, colors, and layouts for each specialization
• Profile Management — Create, copy, and manage multiple profiles
• Independent Positioning — Each profile can have its own window position and size

🎨 Extensive Customization

• Drag the frame anywhere on your screen with optional locking
• Adjust frame scale from 50% to 150%
• Choose from 60+ fonts with multiple sizes and outlines
• Customize the color of any stat individually
• Default gold theme plus class-colored themes for all 13 classes
• Optional class-colored borders
• Show or hide individual stats
• Drag-and-drop reordering of stats
• Display stats as percentages, raw values, or both
• Flexible value placement (split, right-aligned, left-aligned)
• Independent transparency controls for background, border, and text
• Multiple border styles

🖱️ User Interface

• Minimap Button — Left-click to toggle, right-click for options, shift-click to reset
• Quick Sharing — Shift-click the stats frame to post your stats in chat
• Paperdoll Integration — Optional stats display in your character sheet
• Resizable Frame — Adjust window size to fit your UI
• Screen Clamping — Prevents the frame from going off-screen

⚡ Performance

• Efficient updates with smart caching and throttling
• Event coalescing for smooth performance
• Minimal memory footprint
• Optimized for low-end systems

Version-Specific Features

📊 Retail (Midnight / Midnight Prepatch)

• Modern stat system with tertiary stats (Leech, Avoidance, Speed)
• Stagger percentage for Brewmaster Monks
• Paperdoll integration displays stats in your character sheet

⚔️ Classic (Mists of Pandaria)

• Classic-era stats including Hit, Expertise, Spirit, and Defense
• Separate tracking for Attack Power, Spell Power, and Ranged Attack Power
• PvP Power and PvP Resilience stats
• Includes a new stat frame in the Paperdoll for easy viewing in your character sheet

Stats automatically hide when their value is 0. Primary stat detection updates based on your class and specialization.

Getting Started

1. Type /cs to open the options panel
2. Adjust size, fonts, colors, stat filters, and border options
3. Drag the frame to position it where you like
4. Save your settings as a profile for each spec

Slash Commands

• /cs /charstats /cstats — Toggle stats frame
• /cs config /cs options — Open options panel
• /cs show — Show the stats frame
• /cs hide — Hide the stats frame
• /cs reset — Reset frame position
• /cs resetminimap — Reset minimap button position
• /cs help — Display all available commands

Configuration

Stat Selection

Enable or disable individual stats and customize their display order with drag-and-drop reordering.

Display Options

• Percentage or Rating — Toggle between percentage and raw rating values
• Short or Full Names — Use abbreviated (Str, Agi, Crit) or full names (Strength, Agility, Critical Strike)
• Decimal Precision — Control decimal places for stat values

Visual Options

• Label Colors — Customize stat name colors
• Value Colors — Customize stat value colors
• Individual Stat Colors — Override colors for specific stats
• Themes — Choose from default or class-themed color schemes
• Borders — Adjust border style, color, and opacity

Compatibility

This addon includes all required libraries and has no hard dependencies.

Support & Community

Need help, found a bug, or have a feature request?

CharacterStats is released under the MIT License