Dawnsorrow/Fractured-Distro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 42 Wiki Activity

42 Releases 43 Tags

RSS Feed
  • v0.7.57-client-vfx-hotfix 9e3711bc7b
    Compare

    Fractured v0.7.57-client-vfx-hotfix Stable

    Dawnsorrow released this 2026-06-16 23:31:29 +00:00 | 0 commits to main since this release

    Client-only hotfix. No server update required.

    What happened

    v0.7.56-item-forge-ilvl-names was the first release that shipped rebuilt
    patch-enUS-A/B/C.MPQ asset shards from the decomposed loose src/ trees (instead
    of carrying the old opaque ~74 MB MPQs from v0.7.54).

    Those shard trees accidentally contained Git LFS pointer text (~129 bytes per
    file) for 230 assets — literal version https://git-lfs.github.com/spec/v1 stubs,
    not real .blp/.m2 data. The build packed them verbatim into the MPQs.

    WoW loads patches in order 4 → … → A → B → C → D. For dozens of spell/world
    paths, a pointer stub in A/B/C overrode the real asset already present in
    patch-enUS-4.MPQ (MPQ paths are case-insensitive). The client tried to render
    pointer text as textures/models → green missing-texture VFX (including login
    screen effects).

    This was not caused by patch-5 (FrameXML), item ilvl renames (server-side),
    or a partial launcher sync. The launcher correctly downloaded and verified the
    broken release bytes. The release itself was wrong.

    What we fixed (Fractured-Client-Patches)

    • Materialized all LFS pointer stubs from .git/lfs/objects into real binaries.
    • Removed ~3k duplicate paths from A/B/C that already ship from patch-4 (shards
      must not override patch-4 on the same archive path).
    • Added tools/fix_lfs_pointer_src.py and a build guard (guard_no_lfs_pointers.py)
      so build_all.py fails if pointer stubs reappear.

    Players

    1. Fully exit WoW.
    2. Launcher Update (or replace all patch MPQs from this release).
    3. Confirm shard sizes are roughly A ~24 MB, B ~33 MB, C ~31 MB (not the
      old ~47–54 MB pointer-inflated layout from v0.7.56).
    4. Cache/WDB are cleared automatically by the launcher.

    No change to patch-enUS-D.MPQ gameplay vs v0.7.56 (ItemForge ilvl UI unchanged).

    Operators

    No VPS reboot needed unless you are deploying unrelated server work.

    Maintainers

    FCP_REF=<patches-repo-commit> bash tools/fractured-client-patch-workspace/scripts/publish-client-release.sh \
  v0.7.57-client-vfx-hotfix v0.7.56-item-forge-ilvl-names

    Record the Fractured-Client-Patches commit hash from the publish output in this
    file after the release is cut.

    Fractured-Client-Patches commit: 7ee5986a1f12dc051555a7b45cb038173e4cf567

    Downloads