Public Access

Files

T

florian.berthold 1e3cd87943 Revamp README for improved clarity and comprehensive feature documentation

- Expanded feature descriptions to highlight JSON and Markdown export capabilities.
- Enhanced installation and usage sections with detailed instructions and examples.
- Added sections for export formats, schema, troubleshooting, and development file structure.
- Improved Markdown table and talent export documentation for guides and Wiki.js integration.

2025-12-08 18:48:09 +01:00

5.6 KiB

Raw Blame History

AscensionExporter

Export character data from your Ascension (WotLK 3.3.5) client for use in guides and documentation.

Features

Export the following from your character:

Talents: Full talent build using Ascension's native format
Gear: Equipped items with enchants and gems
Mystic Enchants: Active Mystic/Mythic enchants from equipped items

Installation

Copy the AscensionExporter folder to your AddOns directory:

/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter

Ensure the structure is:

/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter/AscensionExporter.toc

Usage

Slash Commands

In-game, type /ascx followed by:

JSON Export

/ascx export all — Export talents + gear + mystic enchants as JSON
/ascx export talents — Export only talent build
/ascx export gear — Export only equipped gear
/ascx export enchants — Export only mystic enchants

Markdown Export (for Wiki.js/guides)

/ascx export mdgear — Gear table in Markdown format
/ascx export mdtalents — Talent calculator link and embed code
/ascx export mdenchants — Mystic enchants table in Markdown

Other Commands

/ascx sv on|off — Toggle SavedVariables export (default: off)
/ascx debug — Show collector status and diagnostics
/ascx help — Show available commands

Export Window Buttons

The export window includes quick-access buttons:

All — Export everything as JSON
Talents — Export talents as JSON
Gear — Export gear as JSON
Enchants — Export mystic enchants as JSON
MD Gear — Generate Markdown gear table
MD Enchants — Generate Markdown enchants table
MD Talents — Generate Markdown talent calculator link

Markdown Export Formats

Gear Table (`mdgear`)

Generates a Markdown table with columns:

Slot | Item | Location | Enchant | Alternative
Items link to db.ascension.gg when itemId is known
Enchants show base enchant + Mystic enchant (e.g., +20 Spell Power / Mystic: Rune of Power)
Location and Alternative are placeholders (-) for manual editing

Talent Export (`mdtalents`)

Generates:

Clickable link: [View in Talent Calculator](https://exil.es/en/wow/talent-calc?build=...)
Iframe embed code for Wiki.js pages
Uses Ascension's native build format from C_CharacterAdvancement.ExportBuild()

Mystic Enchants Table (`mdenchants`)

Generates a table with:

Quality | Enchant
Quality badges: Artifact, Legendary, Epic, Rare
Enchant names with spell icons and links to db.ascension.gg
Sorted by quality tier, then by slot

JSON Export Schema (v1)

Top-level fields:

{
  "schemaVersion": 1,
  "exportedAt": "2025-12-08T17:44:25Z",
  "client": { "interface": 30300, "version": "3.3.5", "build": "12340" },
  "character": { "name": "...", "realm": "...", "level": 60, "class": "MAGE", "race": "...", "faction": "..." },
  "talents": { "buildString": "NYzZFU...", "selected": [], "hasTalents": true },
  "gear": { "slots": [...] },
  "mysticEnchants": { "perSlot": [...], "active": [...], "enchants": [...] }
}

Talents

buildString: Ascension's native talent export (URL-encoded)
selected: Legacy field for standard WoW talents (empty on Ascension)
hasTalents: Boolean indicating if talents are present

Gear

Each slot contains:

slot: Slot ID (1=head, 2=neck, etc.)
itemId: Database item ID
name: Item name
enchant: Base enchant text (e.g., "+20 Spell Power")
gems: Array of gem IDs

Mystic Enchants

perSlot: Mystic enchants by gear slot
active: All active mystic enchants
enchants: Detailed enchant data (name, spellID, icon, slot, quality)

SavedVariables (Optional)

Disabled by default. When enabled, exports are saved to AscensionExporterSaved keyed by realm:character.

Toggle with:

/ascx sv on — Enable automatic saving
/ascx sv off — Disable saving

Notes & Limitations

Mystic Enchants: Detection is case-insensitive for lines containing "mystic/mythic" and "enchant/rune"
Profession Enchants: Ring enchants (Enchanting profession) are not included in mysticEnchants
Item Cache: Some items may show as nil if not cached; open character panel or shift-hover items to cache
Talent API: Uses Ascension's C_CharacterAdvancement.ExportBuild() API (standard WoW GetTalentInfo returns incorrect data on Ascension)

Troubleshooting

Commands not working: Verify addon is enabled on character select screen
Empty export window: Try /reload and re-run command out of combat
Talents show as empty: Ascension uses a custom talent system; the addon now uses C_CharacterAdvancement.ExportBuild()
Missing mystic enchants: Only enchants on currently equipped items are detected

Development

File Structure

AscensionExporter/
├── AscensionExporter.toc
├── Core.lua                    # Main logic, slash commands, markdown generators
├── Collectors/
│   ├── Talents.lua            # Talent collector using C_CharacterAdvancement
│   ├── Gear.lua               # Gear collector
│   └── Enchants.lua           # Mystic enchant collector
├── Util/
│   ├── Json.lua               # JSON encoder
│   └── TalentEncoder.lua      # Legacy talent encoder (unused on Ascension)
└── UI/
    └── ExportFrame.lua        # Export window UI

Version History

0.1.0: Initial release with talents, gear, and mystic enchant export
0.2.0: Added Markdown export formats for Wiki.js integration
0.3.0: Fixed Ascension talent export using C_CharacterAdvancement.ExportBuild()

5.6 KiB Raw Blame History