HealBot SavedVariables Parser

A tool for parsing World of Warcraft addon configuration files and generating comprehensive HTML reports. Currently supports:

• HealBot: Click-casting configurations and keybindings
• BetterWardrobe: Transmog outfit collections

Note: This app and documentation were exclusively vibe coded, but tested and works for my setup.

What It Does

This parser analyzes your addon SavedVariables files to extract and organize your configurations. It automatically searches your World of Warcraft installation directory and generates beautiful, interactive HTML reports.

HealBot Report

• All your characters across different accounts and servers
• Multiple HealBot files per character (HealBot.lua and HealBot_Data.lua)
• Click-casting bindings organized by mouse button and modifier keys
• Spell/action details with Wowhead links for easy reference

BetterWardrobe Report

• Saved transmog outfits for all characters
• Complete outfit details with all 12 equipment slots (Head, Shoulder, Chest, etc.)
• WowHead integration with item links and tooltips
• Item ID resolution using appearance database (155K+ mappings)
• Export formats including Blizzard-compatible strings and WowHead Dressing Room links

Features

• 📊 Comprehensive Reports: View all your addon configurations in one place
• 🎯 Multi-Character Support: Handles multiple accounts, servers, and characters
• 📁 Multiple Addons: Processes HealBot and BetterWardrobe SavedVariables
• 🔍 Interactive Tables: Sortable tables with filtering capabilities
• 🌐 Wowhead Integration: Direct links to spell and item information with tooltips
• 💎 Transmog Outfits: View all saved BetterWardrobe outfits with complete gear details
• 🔗 Export Options: Blizzard-compatible export strings and WowHead Dressing Room links
• 📱 Responsive Design: Works on desktop and mobile devices
• ⚡ Fast Native Version: Available as a native executable for Windows

Installation

Option 1: JAR File (Recommended for most users)

1. Download the latest healbot-parser-0.1.0-SNAPSHOT.jar from the Releases page
2. Ensure you have Java 17 or later installed
3. Run the JAR file as described in the Usage section below

Option 2: Native Executable (Windows only)

1. Download the latest healbot-parser.exe from the Releases page
2. No additional dependencies required - it's a standalone executable
3. Run the EXE file as described in the Usage section below

Option 3: Build from Source

If you want to build from source:

# Clone the repository
git clone https://github.com/choss/healbot-parser.git
cd healbot-parser

# Build with Maven (requires Java 17+ and Maven)
mvn clean package

# The JAR file will be in target/healbot-parser-0.1.0-SNAPSHOT.jar

Usage

Basic Usage

JAR Version

java -jar healbot-parser-0.1.0-SNAPSHOT.jar [wow-directory] [output-file]

Native Executable (Windows)

healbot-parser.exe [wow-directory] [output-file]

Parameters

• wow-directory: Path to your World of Warcraft installation directory (optional)
  • If not provided:
    • JAR version: Shows a file chooser dialog
    • Native version: Automatically searches for your World of Warcraft installation, or uses the current directory if not found
• output-file: Name of the output HTML file (optional, defaults to healbot-report.html)

Note: The parser generates two separate reports:

• healbot-report.html - HealBot click-casting configurations
• betterwardrobe-report.html - BetterWardrobe transmog outfits

Both HTML reports are generated in the same directory as the executable or JAR file.

Examples

Example 1: Using JAR with file chooser (recommended for beginners)

java -jar healbot-parser-0.1.0-SNAPSHOT.jar

This will open a file browser where you can select your World of Warcraft folder.

Example 2: Using JAR with specific path

java -jar healbot-parser-0.1.0-SNAPSHOT.jar "C:\Program Files (x86)\World of Warcraft"

Example 3: Using JAR with custom output file

java -jar healbot-parser-0.1.0-SNAPSHOT.jar "C:\Program Files (x86)\World of Warcraft" my-report.html

Example 4: Using native executable (automatic detection)

healbot-parser.exe

This will automatically find your World of Warcraft installation and generate healbot-report.html and betterwardrobe-report.html in the same directory as the executable.

Example 5: Using native executable with specific path

healbot-parser.exe "C:\Program Files (x86)\World of Warcraft"

Finding Your World of Warcraft Directory

Your World of Warcraft directory typically contains folders like _retail_, _classic_, etc. The parser will automatically find addon SavedVariables files in:

World of Warcraft/
├── WTF/
│   └── Account/
│       └── [Account Name]/
│           ├── SavedVariables/
│           │   └── BetterWardrobe.lua
│           └── [Server Name]/
│               └── [Character Name]/
│                   └── SavedVariables/
│                       ├── HealBot.lua
│                       └── HealBot_Data.lua

Output

The parser generates two separate HTML reports in the same directory as the executable or JAR file:

HealBot Report (healbot-report.html)

Table of Contents

• Collapsible navigation showing all accounts, servers, and characters
• Character counts for each server
• Quick navigation to any character's configuration

Character Reports

For each character, you'll see separate tables for each HealBot file:

• File Header: Shows which configuration file the bindings come from
• Sortable Table: Click column headers to sort by Button, Modifier, or Spell
• Global Sort: Buttons to sort all tables on the page simultaneously
• Spell Links: Click spell names to view details on Wowhead

Sample Output Structure

Account/Server/Character
├── HealBot.lua
│   ├── Left Click → Healing Wave
│   ├── Right Click → Lesser Healing Wave
│   └── Middle Click → Mana Tide Totem
└── HealBot_Data.lua
    ├── Shift+Left → Chain Heal
    └── Ctrl+Right → Water Shield

BetterWardrobe Report (betterwardrobe-report.html)

Table of Contents

• Collapsible navigation showing all accounts, realms, and characters
• Outfit counts for each character
• Quick navigation to any character's outfits

Outfit Details

For each outfit, you'll see:

• Outfit Name and Icon: Visual identification of the outfit
• Complete Gear Table: All 12 equipment slots with item details
  • Slot: Equipment slot name (Head, Shoulder, Chest, etc.)
  • Item: WowHead-linked item name with tooltip on hover
  • Source ID: Internal appearance ID from BetterWardrobe
  • All Item IDs: All items that share the same appearance
• Export Options:
  • Blizzard Format: BWO:1:sourceID,sourceID,... (copy to clipboard)
  • WowHead Dressing Room: Direct link to visualize the full outfit

Sample Outfit View

Character: Paladin-Silvermoon
Outfit: "Golden Crusader"
├── Head → Item 104604 (Helmet of Guiding Light)
├── Shoulder → Item 98734 (Pauldrons of Faith)
├── Chest → Item 99012 (Breastplate of Radiance)
└── ... (12 slots total)

Export:
- Blizzard: BWO:1:12345,67890,11223,... [Copy]
- Dressing Room: https://www.wowhead.com/dressing-room#... [View]

Troubleshooting

"No HealBot configuration data found"

• Ensure you're pointing to the correct World of Warcraft directory
• Check that you have HealBot addon installed and configured
• Verify that HealBot has saved your settings (try logging in and out of the game)

"No BetterWardrobe data found"

• Ensure you have BetterWardrobe addon installed
• Check that you've saved at least one outfit in-game
• Verify the BetterWardrobe.lua file exists in WTF/Account/[AccountName]/SavedVariables/

"Could not find or load main class" (JAR issues)

• Ensure you have Java 17 or later installed
• Try running with the full path: java -jar /full/path/to/healbot-parser.jar

Native executable won't start

• Ensure you're on Windows (native executables are Windows-only)
• Try running from Command Prompt or PowerShell as Administrator
• Check Windows Defender or antivirus isn't blocking the executable

GUI dialog doesn't appear (JAR version)

• You're likely in a headless environment (Linux server, Docker container, etc.)
• Use the command-line parameter instead: java -jar healbot-parser.jar /path/to/wow

Report shows no bindings

• Some characters might not have HealBot configured yet
• Check that the character has logged in recently with HealBot enabled
• Verify the SavedVariables files exist and contain data

Outfits show source IDs instead of item names

• This is normal behavior - BetterWardrobe stores appearance source IDs
• The parser includes a CSV database (155K+ mappings) to resolve these to actual items
• WowHead links will work correctly with the resolved item IDs

WowHead tooltips not appearing

• Ensure you have an active internet connection
• Check that JavaScript is enabled in your browser
• Try refreshing the page or clearing browser cache

Performance Issues

• Large numbers of characters may take longer to process
• The HTML report includes all data for fast browsing
• Consider processing one account at a time if you have many characters

Tips

• Regular Backups: Run this after major addon configuration changes
• Compare Configurations: Use the reports to compare setups between characters
• Share Reports: The HTML files are self-contained and can be shared with others
• Browser Compatibility: Works best in modern browsers (Chrome, Firefox, Edge)
• Outfit Management: Use the BetterWardrobe report to track transmog collections across alts
• Export to Game: Copy the Blizzard export format to quickly recreate outfits in-game
• Visualize Sets: Use WowHead Dressing Room links to preview full outfit appearances

Support

If you encounter issues:

1. Check the troubleshooting section above
2. Ensure you're using the latest version from Releases
3. Verify your World of Warcraft and HealBot versions are compatible
4. Check the GitHub Issues for similar problems

License

This project is open source. See individual file headers for license information.