Skip to content

zwinout/CharExporter

Repository files navigation

CharExporter

A World of Warcraft addon that exports your character's stats, gear, talents, and currencies into a clean, copyable format. Designed specifically to quickly feed your character data into external tools, chatbots, or spreadsheets.

Features

  • Multiple Output Formats: Toggle between CSV (Comma Separated Values) for spreadsheets or JSON for developers and automated scripts.
  • Comprehensive Data Categories:
    • Basic Info (Name, Realm, Class, Spec, Item Level, Race, Faction, XP, Max XP, Rested XP)
    • Primary & Secondary Stats
    • Equipped Gear (Item names, iLvls, enchants, and gems)
    • Active Talents (Smartly filters unpurchased nodes and includes Hero Talents)
    • Spellbook (Active spells and passives)
    • Currencies (Auto-detects and deduplicates every currency you own, including Gold)
    • Progression (Mythic+ Dungeon Score, per-dungeon scores, raid encounter completions per instance)
    • Professions (Profession names, skill levels, specialization trees, knowledge points, concentration)
    • PvP (Honor level, Conquest, rated ratings, War Mode status)
    • Reputation (Faction standings, Renown levels, Paragon progress)
    • Collections (Mounts, Pets, Toys, Transmog appearances — collected vs total)
    • Guild (Name, rank)
    • Weekly Vault (Activity progress for M+, Raid, PvP, World)
    • Achievements (Total achievement points)
    • Play Time (Total played and at-level time)
    • Delves (Season, highest unlocked tier)
  • Interactive UI & Help: Easily customize your export by toggling specific data categories using checkboxes. Includes an in-game "Help" button for quick documentation.
  • Auto-Save on Logout: Check this option to silently save your exported character data to the addon's SavedVariables file every time you log out, allowing external tools to read your data automatically without manual copy-pasting.
  • Refresh button: Re-gather your character data without reopening the UI.

Usage

  1. Type /charexport in the in-game chat to open the CharExporter window.
  2. Use the Categories checkboxes on the left to select exactly what data you want to export.
  3. Use the Format button to switch between CSV and JSON formats.
  4. Click inside the text box on the right and press Ctrl+C to copy your data to the clipboard.
  5. Alternatively, check the Auto-save on Logout box to automatically write the current data to World of Warcraft\_retail_\WTF\Account\<YOUR_ACCOUNT_NAME>\SavedVariables\CharExporter.lua upon logout.

Installation

Extract the CharExporter folder into your World of Warcraft/_retail_/Interface/AddOns/ directory.

Known Issues / API Notes

Due to combat-lockdown rules, this addon blocks itself from running while in combat to prevent LUA errors. Please ensure you are out of combat when using the /charexport command.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

Changelog

v4.0.0

  • War Mode status: PvP data now includes whether War Mode is enabled.
  • Experience data: Basic Info now includes current XP, max XP, and rested XP.
  • Guild data trimmed: Removed MOTD and Members Online (guild name and rank preserved).

v3.0.0

  • Error resilience: All data collection functions now use pcall wrappers to prevent crashes from unexpected API failures.
  • CSV escaping: Embedded double-quotes in values are now properly escaped per CSV standards.
  • Locale-agnostic: Upgrade track detection (Adventurer/Veteran/Champion/etc.) now works on non-English clients.
  • Item caching fallback: When item info is uncached, the name is parsed directly from the hyperlink text instead of showing a bare link.
  • UI performance: Data is gathered once on open; checkbox toggles only reformat cached data. Added a Refresh button to manually re-gather.
  • Auto-save reliability: Added InCombatLockdown() check and pcall safety net for PLAYER_LOGOUT auto-save.
  • New data fields: Basic info now includes race and faction; progression adds raid encounter completions.
  • Format button UX: Now shows current format ("Format: CSV") instead of the target.
  • Internal cleanup: Removed unused variable, localized global functions, fixed addon table initialization.

Feedback and Bug Reports

If you encounter any issues, missing currencies, or have feature requests, please open an issue on GitHub or leave a comment on the Curseforge project page.


Search Tags: Export, Character Export, CSV Export, JSON Export, Data Dump, Gear Export, Talents Export, Spreadsheet, Utility, SavedVariables

About

World of Warcraft addon that exports character data (stats, gear, talents, currencies) to CSV/JSON.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages