Skip to content

feat(macos): Apple Silicon patcher with macOS platform WAD protection#242

Open
RealDoc06 wants to merge 3 commits into
LeagueToolkit:mainfrom
RealDoc06:main
Open

feat(macos): Apple Silicon patcher with macOS platform WAD protection#242
RealDoc06 wants to merge 3 commits into
LeagueToolkit:mainfrom
RealDoc06:main

Conversation

@RealDoc06

Copy link
Copy Markdown

Summary

  • Native ARM64 fopen hook patcher for macOS Apple Silicon, adapted from
    cslol-tools (commit 23f230858). Runs as an elevated helper process
    communicating over a Unix socket with token-based authentication.
  • Stabilized helper lifecycle: robust process supervision, Riot code
    signature validation, and session cleanup on all exit paths.
  • Auto-blocks bootstrap.macos.wad.client and shadercache.metal.wad.client
    from overlay patching on macOS. Cross-WAD hash matching was distributing
    Windows skin mod chunks into these platform-specific WADs, corrupting
    Metal shaders and macOS bootstrap assets — crashing the game at load.

Known limitations

  • Some skin mods built for Windows contain chunk hashes that don't exist
    in the macOS game WADs. The overlay builder treats these as new entries
    and injects them into the patched WAD, which can crash the macOS client
    at loading screen. This has been observed intermittently — the same mod
    sometimes loads successfully, suggesting a potential race condition or
    load-order dependency. Investigating a fix, likely an ltk_overlay
    option to skip new WAD entries on macOS. For now, users will need to
    disable the affected skin mod if it causes crashes.

RealDoc06 and others added 3 commits June 15, 2026 02:38
Skin mods designed for Windows were having their chunk hashes
cross-matched into Bootstrap.macos.wad.client and
ShaderCache.metal.wad.client via the overlay builder's cross-WAD
distribution. This corrupted macOS-specific assets (Metal shaders,
platform config) and crashed the game at loading screen.

Automatically block these platform WADs from overlay patching on macOS.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant