Worldsoul-Searching Achievements Check

Track Worldsoul-Searching progress with a bilingual WoW addon featuring criteria details, planner tools, guide notes, filters, exports, custom lists, optional waypoints, and a Midnight/Xal'atath-inspired UI.

File Details
DownloadInstall

WorldsoulSearchingAchievementsCheck_v1.5.1.zip

Byomfgnick
  • R
  • Jun 5, 2026
  • 73.10 KB
  • 0
  • 12.0.5
  • Retail

File Name

WorldsoulSearchingAchievementsCheck_v1.5.1.zip

Supported Versions

  • 12.0.5
# [v1.5.1] — 2026-06-05

### Fixed
- Fixed scrolling in the addon’s main panels.
- Enabled mouse wheel scrolling in the list, details, summary, coverage, settings, and export popup panels.
- Added mouse wheel handling both to `ScrollFrame` widgets and their respective content children.
- Added dynamic height adjustments for long content to prevent text from being clipped inside scrollable areas.
- Fixed scroll clamping/recalculation after text, size, or content updates.
- Adjusted text widths to follow the real panel width, improving line wrapping.
- Increased normal-mode list row height to reduce clipping of metadata and hints.
- Kept compact mode available, but made it less aggressive to avoid clipped text.

### Validated
- Lua syntax validated with `texlua loadfile`.
- XML validated with a Python parser.
- Top-level addon loading validated with basic WoW API stubs.
- Offline validator ran successfully.
- Data coverage preserved: 84 default achievements, 84/84 with fixed IDs.

---

## [v1.5.0] — 2026-06-05

### Added
- Zone filters.
- Achievement type filters.
- `/wsac zone <name>` command to apply a zone filter.
- `/wsac type <name>` command to apply a type filter.
- `/wsac clearfilters` command to clear search, zone, and type filters.
- New **Coverage** tab to identify achievements missing helpers, routes, or criterion data.
- **Next best action** block in the planner.
- Daily/weekly planning summary.
- Addon-owned World Map markers for pending/filtered achievements with waypoint or route data.
- `WorldsoulSearchingAchievementsCheckMapPins.xml` XML template for map pins.
- `/wsac markers` command to refresh WSAC markers on the map.
- **Markers** button in the details panel.
- Local per-achievement controls:
  - **Mark local complete**;
  - **Hide**;
  - **Reset local**.
- Configuration export/import through the addon UI.
- **AddOn Compartment** support.
- `IconTexture` metadata in the `.toc` file.
- Offline validator at `tools/validate_wsac.py`.
- Release report file: `RELEASE_REPORT.md`.

### Changed
- Expanded planner logic to consider next action and daily/weekly planning.
- Achievement status now also considers local overrides, in addition to current-character and Warband/other-character status.
- READMEs updated with new commands, filters, markers, import/export, and notes.
- Release checklist expanded.
- `.toc` metadata updated to version 1.5.0 and AddOn Compartment support.

### Fallbacks and compatibility
- Addon-owned markers depend on the client’s World Map APIs.
- TomTom, the default WoW map pin, and `/way` export remain available as fallbacks if custom markers are unavailable.

### Validated
- Lua syntax validated with `texlua loadfile`.
- XML validated with a Python parser.
- Top-level addon loading validated with basic WoW API stubs.
- Offline validator ran successfully.
- Version data coverage:
  - 84 default achievements;
  - 84/84 with fixed IDs;
  - 40/84 with `ENTRY_HELPERS`;
  - 12/84 with `ENTRY_ROUTE_OVERRIDES`;
  - 17/84 with `CRITERION_HELPERS`;
  - 7/84 with `CRITERION_ROUTE_OVERRIDES`.

---

## [v1.4.2 fixed] — 2026-06-05

### Fixed
- Fixed forward declarations for `getGroupHelper`.
- Fixed forward declarations for `getCriterionRoutingRule`.
- Fixed a potential runtime error in waypoint/route buttons caused by local functions being used before their declarations.
- Separated internal group keys from localized UI group names.
- Fixed the risk of routes/helpers breaking on enUS clients because localized group names were being used as internal keys.
- Moved `Treasures of Hallowfall` to the correct **Hallowfall** group.
- Synchronized version numbers across `.toc`, Lua, and README files.
- Renamed the bilingual helper function `L()` to avoid conflicting with the locale table.
- Fixed the route button message to use the proper TomTom/map route strings.

### Added
- **Copy route / Copiar rota** button to export `/way` commands even without TomTom.
- Automatic refresh on achievement/criterion-related events.
- `/wsac debug` command with copyable diagnostics.
- `RELEASE_CHECKLIST.md`.
- Sanity/coverage diagnostics including version, locale, fixed IDs, helpers, routes, and group keys.

### Changed
- ptBR/enUS READMEs updated to reflect the real version and existing features.
- `.toc` updated with more accurate notes about `/way` export and diagnostics.
- Default list kept at 84 unique achievements.

### Validated
- `AchievementListData.lua`: syntax OK.
- `WorldsoulSearchingAchievementsCheck.lua`: syntax OK.
- Final ZIP extracted and revalidated.
- Top-level addon loading validated with basic WoW API stubs.
- Verified that `Treasures of Hallowfall` is under `Hallowfall`.
- Verified that `PLANNER_GROUP_DEFAULTS`, `GROUP_HELPERS`, and `GROUP_ROUTE_OVERRIDES` keys match the default groups.

---

## [Initial base / original ZIP] — initially submitted

### Initial observed state
- Addon with a Worldsoul / The War Within achievement checklist.
- Automatic UI localization for enUS and ptBR clients.
- Search and scope filters.
- Clickable rows with a side details panel.
- Criterion display when the client API provides criterion data.
- Guide notes for larger meta achievements and long-term blockers.
- Distinction between current-character and Warband/other-character status when available.
- TXT and CSV export of the filtered view.
- Custom list support through SavedVariables.
- Midnight / Xal'atath visual theme.
- Planner tab.
- Waypoint button using TomTom or the default map pin fallback.
- Route button.
- Row tooltips.
- Minimap button.
- Saved window position.
- Persistent settings.

### Issues identified in the base
- Inconsistent versions:
  - `.toc`: 1.4.2;
  - Lua: 1.4.0;
  - README: 1.0.2.
- `getGroupHelper` was used before the correct local declaration.
- `getCriterionRoutingRule` was used before the correct local declaration.
- Risk of helper/route failures on enUS clients because localized group names were used as internal keys.
- `Treasures of Hallowfall` was listed under The Ringing Deeps.
- The name `L` was used for two different purposes: the locale table and a bilingual helper function.
- Main file was very large and mixed UI, data, routes, helpers, criteria, SavedVariables, export logic, and events.
- Helper/route coverage was still uneven.

---

## Current main commands

- `/wsac` — opens/closes the main window.
- `/worldsoul` — alias to open the addon.
- `/wscheck` — alias to open the addon.
- `/wsac refresh` — forces a fresh read/cache update.
- `/wsac debug` — opens copyable diagnostics.
- `/wsac markers` — refreshes WSAC markers on the map.
- `/wsac zone <name>` — applies a zone filter.
- `/wsac type <name>` — applies a type filter.
- `/wsac clearfilters` — clears search, zone, and type filters.