Sky Recomp v2.2 - Game 1.0.1 & Experimental Archipelago Support

Sky Recomp v2.2 — Game Version 1.0.1 & Experimental Archipelago Support

New in 2.2

• Added recognition of prepared Skyward Sword HD v1.0.1 game files, alongside v1.0.0.
• Added early, experimental Archipelago mod support, contributed by @Wesley-Playz in #90. This is an initial compatibility step, not a claim that every seed, connection or playthrough has been tested.
• Enabled mods to supply replacement game modules through mods/<mod name>/exefs/, including the additional subsdk8 module used by the mod. The first enabled mod in the configured order wins when multiple mods replace the same module.
• Updated the game code loader and generator to use the module layout required by this integration, including code that enters a mod function partway through it and jump tables with out-of-line targets.
• Added version-specific timing locations for the existing experimental 120 FPS option. 120 FPS remains experimental.

Integration fixes

• Preserved the current generator's optimized normal path while adding the mod's alternate-entry behavior.
• Kept verified v1.0.0 gameplay patches working at the new module addresses. Address-specific v1.0.0 cheats are not applied to v1.0.1, whose corresponding locations have not been verified.
• Changed the generated-library identity so libraries from older releases are rebuilt for the new layout. Locally generated libraries also track the selected main-module build ID, the generator and enabled module overrides.
• Extended host crash-symbol lookup to include the additional mod module, and bounded alternate entry to aligned instructions in that module's text section.
• Added generator regression checks for timing locations, alternate entry, relocated patches and external jump-table targets.

Setup and updating

Back up your saves before updating and extract into a fresh folder. Supply your own prepared game files: exefs/ containing main, sdk, subsdk0, subsdk1, plus romfs.bin or romfs/. For v1.0.1, the selected update must already be applied to those prepared files; the launcher does not decrypt or apply encrypted update packages.

When using the Archipelago mod, follow the mod author's setup instructions and put its prepared replacement modules under mods/<mod name>/exefs/. Enable the mod before preparing the game code and restart after changing executable mods. Setup may rebuild the game code; do not reuse an old skygame.dll, .so or .dylib from 2.1 or earlier.

Windows downloads

• SkyRecomp-v2.2.0-Windows-4K.zip: complete Windows package with the v2.2.0 application, preparation tools, 568 4K replacement textures by Henriko Magnifico, shaders, presets and the bundled ReShade 6.8.0 runtime. No separate ReShade installation is required. The default preset is HenrikoMagnifico_Ultra_NO_MOTION_BLUR_v8.ini. Use ESC > Video > 4K Textures / ReShade to control the graphics options. If ReShade was disabled when the application started, restart the application after enabling it.
• SkyRecomp-v2.2.0-Windows.zip: smaller standard download without the optional 4K texture pack or ReShade.

Extract the chosen Windows package into a fresh folder and open skyrecomp.exe. Both downloads require your own prepared game files and contain no precompiled game code. Linux and macOS downloads retain their standard package contents. The launcher uses v2.2.0 for the requested 2.2 release.

Visual pack credits: Textures and presets by Henriko Magnifico; ReShade by Patrick Mours and contributors. Credits and the ReShade license are also included in the complete Windows ZIP.

Thanks

Thank you to Wesley-Playz for the game-version and Archipelago contribution, and to all contributors and users reporting issues and testing fixes. Existing upstream and artwork credits remain applicable.

Known limits and reporting problems

Support for v1.0.1 and Archipelago is experimental. A complete game playthrough and a live Archipelago multiworld session have not been verified for this release. Not all address-specific gameplay options have verified v1.0.1 equivalents; the v1.0.0 cheat patches are deliberately left out of that build.

Report problems through GitHub Issues. Include v2.2.0, the game version, operating system, controller, mods and their order, and steps to reproduce. On Windows, attach skyrecomp.log from beside the executable. If the game freezes, wait at least 15 seconds before copying the log, and preserve it before relaunching. On Linux/macOS, also include terminal output or the available system crash report. Never attach game executables or console keys.