Files
ascension-char-exporter/AscensionExporter/README.md
T
2025-12-08 13:45:59 +01:00

55 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
AscensionExporter
=================
Export the following from your Ascension (WotLK 3.3.5) client:
- Active talents (current spec only)
- Worn items (equipped gear only), including base enchant text and gems
- Active Mystic/Mythic Enchants (derived from equipped item tooltips)
Installation (Linux path provided by you)
- Copy the `AscensionExporter` folder to:
`/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter`
- Ensure the structure is:
`/srv/add01/wow-ascension/Interface/AddOns/AscensionExporter/AscensionExporter.toc`
Usage
- In-game, type:
- `/ascx export all` — talents + gear + mystic enchants
- `/ascx export talents` — only active spec selected talents
- `/ascx export gear` — only equipped gear
- `/ascx export enchants` — only mystic enchants
- `/ascx export mdgear` — equipped gear as a Markdown table (for guides)
- A copyable JSON window will open. Press Ctrl+C to copy.
Export window button
- The export window now has a "MD Gear" button. Click it to populate the window with a Markdown gear table matching the guide format:
- Columns: `Slot | Item | Location | Enchant | Alternative`
- `Item` links to db.ascension.gg when the itemId is known.
- `Enchant` includes base enchant text and any active Mystic/Mythic enchant (e.g., `... / Mystic: Rune of Power`).
- `Location` and `Alternative` are placeholders (`-`) since those are guide-specific.
SavedVariables (optional)
- Disabled by default. Toggle with:
- `/ascx sv on` — enable saving last export to SavedVariables
- `/ascx sv off` — disable
- Saved in: `AscensionExporterSaved` table (path depends on your client setup).
JSON schema (v1)
- Top-level fields:
- `schemaVersion` (number)
- `exportedAt` (ISO UTC string)
- `client` (interface/build info)
- `character` (name, realm, level, class, race, faction)
- `talents``{ activeTalentGroup, selected[] }` for current spec only
- `gear``{ slots[] }` equipped items with parsed IDs, names, enchant text, gems
- `mysticEnchants``{ perSlot[], active[] }` from equipped item tooltips
Notes & limits
- Mystic vs Mythic wording varies; detection is case-insensitive for lines containing both `mystic|mythic` and `enchant|rune`.
- Profession-only enchants (e.g., Enchanting ring enchants) are not included in `mysticEnchants`; base enchant text is placed under `gear.slots[].enchant`.
- Some item info may be `nil` if not cached; reopen the character pane or shift-hover items to cache if needed.
Troubleshooting
- If `/ascx` doesnt respond, verify the addon is enabled on the character select screen.
- If the export window is empty, try `/reload` and re-run the command out of combat.