ModsFinder

Butterfly API

by Moth_SKW

Butterfly API is a helper library for Fabric mod developers, providing shared systems for registering content and building visual features.

FabricClient and serverMIT LicenseOpen source1.20.1 – 26.3

What it does

Butterfly API bundles helper systems that cover common content work: registration of items, blocks, sounds, entities, particles, enchantments, recipes and status effects, along with creative tabs and basic gameplay and math utilities. Developers who would otherwise write a lot of boilerplate for these tasks can call the library instead, which leaves their own code more compact.

Beyond registration, the library includes a text system with control over colors, gradients, rotations and mirroring, a tooltip system for expanding item tooltips, and an outline system that extends the vanilla glowing effect so it can be applied to nearly anything. A shared plush system adds small placeable plush blocks with options such as facing direction and waterlogging, plus optional honk sounds and squish behavior that use GeckoLib animations.

Butterfly API is open source under the MIT License and runs on client and server, so the library must be present on both sides for mods that depend on it. It is published for Fabric only, with builds covering 1.20.1 – 26.3. Its GitHub page holds setup notes and usage examples for developers who want to build on the same helpers.

Key features

  1. Registration helpers

    Shortcuts for registering items, blocks, entities, enchantments, recipes and status effects replace long setup code.

  2. Text styling

    Text supports extra color control, gradients, rotations and mirroring, plus a tooltip system for expanded item descriptions.

  3. Outline effects

    The outline system extends the vanilla glowing effect so it can be applied to almost any entity or block.

  4. Plush blocks

    A shared plush system adds small placeable blocks with direction and waterlogging options, optionally with honk and squish sounds through GeckoLib.

Compatibility

Latest build for each game version and loader.

26.31.4.0+26.3
26.21.4.0+26.2
26.11.4.0+26.1
1.21.111.4.0+1.21.11
1.21.11.4.0+1.21.1
1.20.11.1.2
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Required by 4 mods

Use cases

Mod development

Developers building Fabric content use the registration and math helpers instead of writing those systems from scratch.

Shared helpers across mods

Mods such as Maisonnette, Tempestra, Celestara and Crimson require the library, so it is shared between several projects.

Who it’s for: Developers writing Fabric content who prefer ready helpers to custom setup code, and players who install mods that depend on the library.

Questions

Does Butterfly API need to be installed on both sides?

Yes. Servers that run it need every player to install it too.

Which loader does Butterfly API support?

Only Fabric. Files are published for 1.20.1, 1.21.1, 1.21.11, 26.1, 26.2 and 26.3.

Which mods require Butterfly API?

Four catalog mods require it, including Maisonnette, Tempestra, Celestara and Crimson.

In the catalog

Butterfly API is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 8,071 mods support Minecraft 26.3.

More from Moth_SKW

All projects

Similar mods

What the author says

Butterfly API is a simple helper API for my Fabric mods. It mostly exists to make things easier for me and allow things that would normally take a lot of code in my projects to be more compact by leaving it to Butterfly API to handle instead.
Moth_SKW, on the Modrinth page

Official listing

Owner
Moth_SKW
Published
2026-05-07
Updated on Modrinth
2026-10-14
Facts verified
2026-10-15

Tags