Skip to content

feat(ltk_overlay): route non-audio overrides out of localized champio… - #177

Open
moonshadow565 wants to merge 1 commit into
mainfrom
localized_routing
Open

feat(ltk_overlay): route non-audio overrides out of localized champio…#177
moonshadow565 wants to merge 1 commit into
mainfrom
localized_routing

Conversation

@moonshadow565

Copy link
Copy Markdown
Contributor

Clanker-writen, will go thru it eventually.

…n WADs

Original localized champion WADs (X.<locale>.wad.client) only ever hold
locale-tagged VO audio, yet mods routinely pack their entire content
into one (46 of 2309 mods in the reference corpus). New chunks declared
there previously stayed in the localized WAD: invisible to players on
any other locale, and unresolvable for the closed-world base-skin
verification, which fails the whole overlay at injection.

Pass 1 now re-homes the fallback target per chunk: an override declared
under a localized champion WAD whose bytes are not a Wwise audio
container (same LeagueFileKind detection the WAD writer uses for
compression) falls back to the champion's real WAD instead. Audio keeps
the declared target — genuine localized content is exactly VO — and
non-champion localized WADs (Localized/ string tables) are untouched.
Known chunks also stop being cross-copied into the localized WAD, since
the delocalized fallback is already among their index matches.

Cache invalidation: routing decisions from earlier builds must not
survive this change.
- meta_cache CACHE_VERSION 5 -> 6: the per-mod metadata cache persists
  each override's fallback_wad, so cached entries carry
  pre-delocalization targets; the bump discards them and forces pass-1
  re-collection on the next build.
- OverlayState CURRENT_VERSION 5 -> 6: overlay WADs on disk were built
  under the old routing and no longer match what a fresh build would
  produce; the version mismatch forces one full rebuild and disables
  the exact-match skip and incremental reuse for pre-upgrade state.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Crauzer

Crauzer commented Aug 29, 2026

Copy link
Copy Markdown
Member

This needs to get rebased. Also feel free to take a look at the LTK Manager overlay builder wrapper routine which handles this downstream.

@Crauzer Crauzer added ltk_overlay bug Something isn't working labels Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working ltk_overlay

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants