CorgiLib Mod (1.21.11, 1.20.1) – API Foundation

CorgiLib is a library mod that provides shared utility code used across CorgiTaco's Minecraft mods, offering features like JSON5 config serialization, entity filters, and codec registries for Fabric, Forge, NeoForge, and Quilt mod loaders.

If you've ever tried launching a modded Minecraft world only to be greeted by a crash screen demanding a missing dependency, you already understand why library mods exist. CorgiLib solves that exact problem — it bundles the shared code that CorgiTaco's popular mods rely on into a single, maintainable package. Rather than duplicating utility functions across multiple projects, CorgiLib centralizes them, which means fewer conflicts, smaller file sizes, and more stable updates. With over 11 million downloads since its 2022 release, CorgiLib has become one of the most widely used library mods in the Minecraft modding ecosystem, quietly powering some of the community's favorite world generation and biome mods.

Key Features of CorgiLib

• JSON5 Config Serialization with Mojang's Codecs — This feature allows mod developers to write configuration files in the human-friendly JSON5 format, complete with comments. For players, this means config files you can actually read and edit without guessing what each value does. Commented JSON files make manual tweaking far less intimidating.
• Commented Codecs — Building on Mojang's own codec system, CorgiLib adds support for inline comments in serialized data. This makes it significantly easier for modpack creators and advanced players to understand and customize mod behavior without needing to consult external documentation.
• Trees from NBT Feature — This utility lets mods generate tree structures directly from NBT data, which is Minecraft's native data format. It gives mod developers precise control over custom tree generation, resulting in more varied and natural-looking biomes when used by world generation mods that depend on CorgiLib.
• Blending and Easing Functions Codec Registry — Easing functions control how transitions happen — think smooth terrain blending between biomes. CorgiLib provides a ready-made codec registry for these functions, allowing dependent mods to create smoother, more realistic world generation without reinventing the math each time.
• Entity Filters — Entity filters give mod developers a flexible way to target specific mobs or entities based on configurable conditions. For players, this translates to mods that can fine-tune which creatures spawn where, improving both gameplay balance and performance in heavily modded worlds.
• Villager Trade Codec Registry — This feature provides a standardized system for defining custom villager trades through codec configuration. Mods that depend on CorgiLib can easily add or modify villager trades without conflicting with each other, making modpack assembly more reliable.

How to Install CorgiLib

1. First, make sure you have a compatible mod loader installed. Choose one: Fabric, Forge, NeoForge, or Quilt — CorgiLib supports all four.
2. Download the correct version of CorgiLib for your Minecraft version and mod loader from the download section below. Double-check that the version numbers match exactly.
3. Place the downloaded .jar file into your Minecraft mods folder. On Windows, this is typically located at %appdata%\.minecraft\mods.
4. Install any mods that require CorgiLib as a dependency — the library itself adds no visible in-game content on its own.
5. Launch Minecraft through your mod loader's profile and verify there are no errors on the loading screen. If CorgiLib is installed correctly, dependent mods will load without missing-library warnings.

Requirements & Compatibility

What's New

• Version 5.0.0.9: Internal implementation changes for improved stability and code maintenance.
• Version 5.0.0.8: Fixed an issue where the Datagen class was incorrectly included in NeoForge builds, and updated the included TOML library to version 3.8.3.
• Version 5.0.0.7–5.0.0.6: Resolved Jankson library shadowing issues across Forge, NeoForge, and Fabric builds that could cause class loading conflicts.
• Version 5.0.0.4: Fixed concurrency issues with random scheduled ticks and resolved a missing annotation in the Forge network handler. Night Config dependency was also updated.
• Version 5.0.0.2: Added a new any_conditions_passes entity condition, expanding the flexibility of entity filter configurations.

Pros and Cons

Alternatives to CorgiLib

• Architectury API — A cross-platform library mod that helps developers write mods compatible with both Fabric and Forge from a single codebase, serving a similar role as a shared foundation for multi-loader projects.
• Cloth Config API — A popular configuration screen library that provides in-game config editing for Fabric and Forge mods, useful if you're looking for mods that improve the config experience.
• GeckoLib — An animation library for Minecraft modding that handles entity animations and rendering, another example of a widely-used library dependency in the modding ecosystem.

Download CorgiLib

Always download mods from official sources to stay safe.

Frequently Asked Questions

Do I need CorgiLib to play Minecraft?

No — CorgiLib is only required if you use mods developed by CorgiTaco, such as Oh The Biomes You'll Go. It is a dependency library, meaning it provides shared code that other mods need to function. If none of your installed mods list CorgiLib as a requirement, you do not need to install it.

Does CorgiLib work with Fabric and Forge at the same time?

Yes — CorgiLib is available for Fabric, Forge, NeoForge, and Quilt individually. However, you need to download the specific version built for your chosen mod loader. You cannot use a Fabric version of CorgiLib on a Forge installation, so always match the loader when downloading.

Will CorgiLib affect my game performance?

No noticeable impact is expected. CorgiLib is a library mod that only loads code when called upon by dependent mods. It appears to be lightweight by design, containing only utility functions rather than active gameplay systems that would consume resources during play.

Is CorgiLib compatible with Minecraft 1.21.11?

Yes — CorgiLib fully supports Minecraft 1.21.11 across all four mod loaders: Fabric, Forge, NeoForge, and Quilt. The latest version 5.0.0.9 was updated on March 17, 2026, confirming active compatibility with the newest Minecraft releases.

Is CorgiLib open source?

Yes — CorgiLib is released under the LGPL-3.0-only license. The full source code is publicly available on GitHub, allowing anyone to review the code, report issues, or contribute improvements to the project.

You May Also Like

LibZ Mod (1.21.11, 1.20.1) – Library for Globox_Z's Mods

1 week ago

Workshop For Handsome Adventurer Mod (1.21.11, 1.20.1) – Tool Racks

1 week ago

Snowy Spirit Mod (1.21.11, 1.20.1) – Winter Themed for Minecraft

1 week ago

Simple Voice Chat Mod (1.21.11, 1.20.6) – In-Game Voice Communication

2 weeks ago

Macaw's Paintings Mod (1.20.1) – In-game Art Gallery

3 weeks ago

Starlight (Forge) Mod (1.20.2) – Rewriting the Vanilla Light Engine

1 month ago