ShatterLib | OctoLib Mod (1.21.11, 1.20.2) – Gameplay Upgrade

ShatterLib | OctoLib is a shared library mod developed by OctoStudios that provides common code and utilities required by other OctoStudios mods for Minecraft, supporting Fabric, Forge, NeoForge, and Quilt mod loaders across versions 1.18.2 through 1.21.11.

If you have ever tried installing a mod from OctoStudios only to hit a missing dependency error on launch, ShatterLib | OctoLib is the piece you were missing. Library mods like this one work behind the scenes, bundling shared code so that mod developers do not have to reinvent the wheel with every project. Players never interact with OctoLib directly, but without it, the mods that depend on it simply will not load. With over 10.5 million downloads on Modrinth, OctoLib has quietly become one of the more widely distributed library mods in the Minecraft modding ecosystem — a testament to the popularity of OctoStudios' lineup of mods that rely on it.

Key Features of ShatterLib | OctoLib

• YAML-Based Configuration System — OctoLib provides a datapack-like YAML configuration format that OctoStudios mods use under the hood. This means the mods built on top of it can offer clean, human-readable config files that are easy to edit without specialized tools. If you have ever struggled with dense JSON configs, this approach is noticeably more user-friendly.
• Auto-Validation for Config Files — The built-in validation catches configuration errors before they cause crashes. When you make a typo or enter an invalid value in a config file, OctoLib flags the problem instead of letting the game silently break. This saves time troubleshooting issues that would otherwise be difficult to trace back to a misconfigured setting.
• Deep Serialization with Safety Features — OctoLib handles the complex task of converting data structures to and from config files with built-in safety checks. For players, this translates to more stable mods that are less likely to corrupt settings or lose custom configurations between game sessions or mod updates.
• Cross-Loader Compatibility via Architectury API — Since version 1.20.1, OctoLib uses the Architectury API to work across Fabric, Forge, NeoForge, and Quilt from a single codebase. This means OctoStudios can release updates for all mod loaders simultaneously, so players on any platform get patches and new features at the same time rather than waiting for separate ports.
• Shared Codebase for OctoStudios Mods — By centralizing common functionality into one library, OctoLib keeps individual OctoStudios mods lighter and reduces the chance of code conflicts when running multiple OctoStudios mods together. You install OctoLib once and every compatible OctoStudios mod benefits from it.
• Broad Version Support (1.18.2 – 1.21.11) — OctoLib covers a wide range of Minecraft versions, from legacy 1.18.2 all the way up to the latest 1.21.11 snapshots. Players who prefer to stay on older versions for stability or modpack compatibility are not left behind, while those on the cutting edge get immediate support.

Screenshots

How to Install ShatterLib | OctoLib

1. Install a compatible mod loader for your Minecraft version. OctoLib supports Fabric, Forge, NeoForge, or Quilt.
2. If you are running Minecraft 1.20.1 or newer, download and install Architectury API — OctoLib requires it as a dependency from that version onward.
3. Download the correct OctoLib file for your Minecraft version and mod loader from the download section below.
4. Place the downloaded .jar file into your .minecraft/mods folder. If the folder does not exist, launch the game once with your mod loader selected to generate it.
5. Launch Minecraft and verify OctoLib loads by checking the mod list in your loader's mod menu. Then install the OctoStudios mod that requires it.

Requirements & Compatibility

What's New

• Fixed trail rendering when Iris Shaders is installed — resolves visual glitches that appeared with shader packs enabled.
• Continued support for Minecraft 1.21.11 on both NeoForge and Fabric loaders.
• Ongoing stability improvements to the shared library codebase.

Pros and Cons

Alternatives to ShatterLib | OctoLib

• Architectury API — A cross-platform modding framework that OctoLib itself depends on, enabling mods to run on Fabric, Forge, and NeoForge from a unified codebase.
• Cloth Config API — A widely used configuration screen library for Minecraft mods that provides in-game settings menus, serving a similar config-management role for other mod ecosystems.
• GeckoLib — A popular animation and rendering library for Minecraft mods that, like OctoLib, provides shared backend utilities other mods depend on.

Download ShatterLib | OctoLib

Always download mods from official sources to stay safe.

Frequently Asked Questions

Do I need ShatterLib | OctoLib if I don't use any OctoStudios mods?

No — OctoLib is a dependency library specifically for OctoStudios mods and serves no purpose on its own. If none of your installed mods require it, you do not need to install it. However, if you later add an OctoStudios mod, it will not launch without OctoLib present in your mods folder.

Is ShatterLib | OctoLib compatible with Minecraft 1.21.11?

Yes — OctoLib fully supports Minecraft 1.21.11 on both NeoForge and Fabric mod loaders. The mod is regularly updated to keep pace with new Minecraft releases, with the most recent update published on March 11, 2026.

Does OctoLib work with Iris Shaders?

Yes — the latest update specifically fixed a trail rendering issue that occurred when Iris Shaders was active. OctoLib should now run without visual glitches alongside Iris and popular shader packs.

Do I need Architectury API to run OctoLib?

Yes, for Minecraft 1.20.1 and newer — Architectury API is a required dependency starting from that version. For older versions like 1.19.2 and 1.18.2, OctoLib runs without Architectury API. Make sure you download the correct Architectury API version that matches both your Minecraft version and mod loader.

Can I use OctoLib as a developer for my own mods?

Technically yes, but it is not recommended by the OctoStudios team. The library's codebase may undergo significant changes between updates, which could break third-party mods that depend on it. The mod is licensed under All Rights Reserved, so review the terms before building on it. For most mod developers, established alternatives like Architectury API or Cloth Config offer more stable APIs with broader community support.

You May Also Like

Tinkers' Construct Mod (1.20.1, 1.19.2) – Modify All the Things

4 weeks ago

Cobblemon Pokemon Badges Mod (1.21.11) – All Indigo League's Badges

1 week ago

Explorer's Compass Mod (1.21.11, 1.20.6) – Locate Structures Anywhere

3 weeks ago

Deus Ex Machina Reborn Mod (1.21.1, 1.20.1) – Mechanical Automation

1 week ago

Sophisticated Core Port (1.21.1, 1.20.4) – Shared Library

4 days ago

Panda's Falling Tree's Mod (1.21.11, 1.20.1) – Realistic Tree Falling

1 week ago