Vesper's Compatibility Compendium
Modded Minecraft is a beautiful chaos. You stack dozens of mods together, each one promising new particles, new mechanics, or a smoother experience, and then something breaks. A ripple effect renders wrong, a memory leak drags your framerate into the dirt, or two cosmetic mods simply refuse to play nice. That is exactly the problem Vesper's Compatibility Compendium was built to solve. This lightweight compatibility layer sits quietly between your other mods, patching conflicts, blending visual effects, and cleaning up the messes that nobody else wants to touch.
If you have ever watched a boat glide across warm ocean water and thought the particles looked out of place, or noticed your game stuttering after hours of exploration, this mod is aimed squarely at you. It is a work in progress, but even in its current state it delivers tangible improvements for players who care about both performance and polish.
What Vesper's Compatibility Compendium Actually Does
At its core, this is an integration and bug-fix mod. It does not add flashy new biomes or weapons. Instead, it reaches into the seams between existing mods and makes them cooperate. The work falls into three broad categories: compatibility and integration, tweaks, and bug fixes. Every cosmetic feature is toggleable, so you can disable anything that does not suit your pack without losing the underlying fixes.
Compatibility and Integration
The integration features focus on making water and particle mods share a visual language. For example, Effective's droplet particles can be added to Wakes' boat particles, so wakes left behind by boats match the droplets you see elsewhere. Effectual and Effective are also bridged together: underwater pot bubbles, player breath bubbles, chest bubbles, and the mouth steam particle all get unified under Effective's particle set when conditions are met. There is also an Effective and Particle Rain integration that swaps non-glowing ripples for Particle Rain's version, keeping your rain effects consistent across the board.
Tweaks
One standout tweak involves Wakes and Wakes Reforged. At night in warm oceans, some of Wakes' effects are modified to mimic Effective's glowing plankton effect. It is a small change, but it makes nighttime ocean travel feel far more cohesive, as if the two mods were designed together from the start.
Bug Fixes and Memory Leak Mitigations
This is where the mod earns its keep for long-play sessions. Several well-known memory leaks are addressed across multiple mods. EMI's history is cleared on respawn, Entity Texture Features clears its player texture map on respawn, and Iceberg clears renderers on world unload. The mod also clears wrapped levels maps and entity caches on world unload, wipes Jade's hideModName cache, resets JEI's grindstone menu on respawn, and runs several cache-clearing methods for Supplementaries on server close. On newer versions, Minecraft's own EntityTickLists passive map is cleared as well. These fixes are based on the work of the All The Mods team's All The Leaks, adapted and expanded here.
Supported Minecraft Versions and Loaders
Version support varies by feature, so it pays to check what applies to your setup. The 1.20.1 release covers the widest range, with integrations, tweaks, and leak fixes all present. The 1.21.1 release adds the same integration set plus an extra Minecraft-level leak fix. The 1.21.11 and 26.2 releases currently focus on the Wakes glowing plankton tweak and memory leak mitigations, with integration features still to come.
Loader support is split between Fabric and NeoForge depending on the version and feature. Fabric is the most consistently supported loader across all releases, while NeoForge appears on select 1.21.1 and 26.2 entries. Legacy Forge support shows up only for the 1.20.1 Wakes tweak. If you are unsure which build matches your pack, the version list on the project page breaks everything down clearly.
How to Install Vesper's Compatibility Compendium
Installation is straightforward, but the exact steps depend on your loader. Before you begin, confirm your Minecraft version and whether you run Fabric or NeoForge, since the wrong build simply will not load.
- Install the correct loader for your Minecraft version first.
- Place the matching Vesper's Compatibility Compendium jar file into your mods folder.
- Make sure any mods it integrates with, such as Effective, Wakes, Effectual, Particle Rain, EMI, JEI, Jade, Iceberg, ETF, or Supplementaries, are present and on compatible versions.
- Launch the game and check the mod list to confirm it loaded without errors.
- Adjust any cosmetic toggles you want to disable through the mod's config.
If you would rather skip the manual file juggling, the foxygame.net launcher handles it for you: it lists Vesper's Compatibility Compendium in its add-on catalog and installs it with a single click, matching the right build to your selected Minecraft version automatically. That takes the guesswork out of loader and version pairings.
When you download Vesper's Compatibility Compendium, always grab it from the official project page rather than a random mirror. That way you get the latest fixes and can report issues where the developer will actually see them. Bug reports and feature requests are welcome on the GitHub Issues page, and community support is available through the Fluxer server.
Final Thoughts
Vesper's Compatibility Compendium for Minecraft is not trying to be the star of your modpack. It is the quiet fixer in the background, smoothing over particle mismatches, patching leaks that would otherwise creep up after hours of play, and giving you toggles so nothing is forced on you. If you run a cosmetic-heavy pack with water effects, or you are tired of watching your memory usage climb, this mod is well worth adding. Just check the version and loader notes first, install it alongside its supported mods, and let it do the unglamorous work that keeps everything running smoothly.