Complementary Shaders ZIP File: What to Check Before Installing

A Complementary Shaders download is a single small ZIP file, and that file is where most installation problems begin. Wrong name, wrong size, extracted contents, or a file from a dubious source will each stop the pack from working in a different way. This guide gives you a short, reliable checking routine for the Complementary Shaders ZIP file before you install it.

What the genuine file looks like

The version number in the filename will change as new releases appear, the pattern is what matters: style name, underscore, release number, .zip. The current release for both styles is r5.9.3; see the latest version page for the history.

Check 1: The filename

The filename tells you the style and the version at a glance. Watch for these warning signs:

• An .exe, .msi, .bat or .jar extension, the genuine pack is never an executable. Delete the file and download again from a proper source.
• "(1)" or "copy" suffixes, usually just a duplicate download, but rename duplicates deliberately if you keep several versions; the loader lists packs by filename.
• Extra words like "crack", "premium" or a site's name inserted into the filename, a sign the file has been repacked by a third party.

Check 2: The size

A shader pack is mostly text-based graphics code, so the genuine ZIP is small, roughly half a megabyte for current releases. Treat these as red flags:

• Several megabytes or more: something extra has been bundled in.
• Only a few kilobytes: you probably downloaded a shortcut, a torrent stub or an incomplete file.
• Zero bytes: the download failed. Try again, the buttons on this site's homepage request the file fresh each time.

Check 3: Do not unzip it

This is the check that surprises people: the ZIP must stay zipped. Iris and OptiFine read the pack directly from the archive, and the official installation instructions say so explicitly, download the pack and put it in the shaderpacks folder, "please don't unzip the file". If you extracted it and copied a folder instead, the pack may not appear in the shader list at all; our fix guide for shaders not showing up starts with exactly this mistake.

You may open the ZIP to look inside, viewing does no harm. A genuine pack contains shader code folders and files (names like shaders content, .glsl and .properties files). What it should never contain is an installer program or unrelated software.

Check 4: One ZIP, not a ZIP inside a ZIP

Some distribution mistakes wrap the real pack in a second archive. If opening your download reveals another ZIP inside, the inner file is the pack, move that one to the shaderpacks folder. A nested archive is the second most common reason a pack is missing from the list, right after unzipping. Similarly, if your file sits inside an extra folder after extraction by an over-helpful archiving tool, find the actual ZIP file itself.

Check 5: The source

The genuine pack is published through the project's official listings (Modrinth and CurseForge) and the developers' own site and installer. This website's download buttons fetch the current release file from the project's Modrinth distribution at click time, the download information page explains the process in full. If a file arrived from anywhere else, a video description, a file-sharing link, a "shader pack bundle", compare it against every check above, and when in doubt, replace it with a fresh download from a source you trust.

The 30-second routine

1. Read the filename: right style, plausible version, ends in .zip.
2. Check the size: roughly half a megabyte.
3. Confirm it is still a ZIP, not extracted, not an executable.
4. Look inside if unsure: shader files, no programs, no second archive (or use the inner ZIP if there is one).
5. Install: place the ZIP in the shaderpacks folder as-is, folder locations here.

Check 6: The companion settings file

There is one more file worth knowing about, although it appears only after the pack has run: when you change any of the pack's options, your settings are saved into a small text file stored beside the ZIP in the shaderpacks folder, named after the ZIP itself, ComplementaryUnbound_r5.9.3.txt next to ComplementaryUnbound_r5.9.3.zip. That naming link is itself a check. If several shader ZIPs share your folder, the settings file's name tells you unambiguously which release your tuned options belong to. If a settings file exists whose name matches no ZIP in the folder, it is a leftover from a pack that was removed or renamed, harmless, but a sign the folder needs a tidy. And if you rename a ZIP yourself, expect the pairing to break: the renamed pack will start from default settings under its new name, while your old settings stay behind in the file named after the original.

Why source discipline matters: the pack's licence

The insistence on official sources in Check 5 is not just caution, it reflects how the pack is licensed. Complementary Shaders is distributed under a custom licence, and the developers do not permit redistribution or mirroring of the ZIP files. That is why genuine copies flow through a short list of channels: the project's official listings, the developers' own installer, and mechanisms like this site's buttons, which fetch the current release file from the project's Modrinth distribution at click time rather than hosting a copy. A website that stores and serves its own repackaged copies is operating outside that licence, and repackaging is exactly where the anomalies in the earlier checks come from, inserted names, bundled extras, wrong sizes. Viewed that way, the filename and size checks are not pedantry: they are how you detect, in seconds, that a file passed through hands it should never have passed through. Replacing a doubtful file costs one small download; trusting one can cost far more time in troubleshooting.

Frequently asked questions