Description
A butterfly mod for Minecraft 1.21.11, 1.21.1 and 26.3 (NeoForge), and the daytime sister of Mothlight: find twelve real butterflies at the flowers, catch them, keep them in jars, and raise them from egg to wing.
Twelve real butterflies
- Monarch, Old World Swallowtail, Blue Morpho, Peacock, Red Admiral, Painted Lady, Brimstone, Orange-tip, Glasswing, Rajah Brooke's Birdwing, Purple Emperor and Common Blue.
- Each lives in its own biomes, with its own wing shape, size, host plant and food.
- They fly by day in dry weather (a few deep wingbeats, then a glide), sit on flowers with their wings slowly opening and closing, and hide on leaves and bark at night and in rain.
- Every wing has an upperside and an underside: a Peacock shows its eyespots in flight and turns into a dead leaf when it lands. The Glasswing's wings are see-through.
- Three species ignore flowers or prefer fruit, as the real ones do.
Four originals, for other worlds (new in 0.3.0)
- Made-up butterflies for the places no real one could live: Glowberry Lady (lush caves, moss-green with glowing amber spots), Crimson Admiral (crimson forest, sheds red spores), Soulfire Swallowtail (soul sand valley, its tails trail blue flame) and Chorus Glasswing (the outer End, purple glass wings).
- They fly at any hour and feed at glow berries, crimson fungus, soul lanterns and chorus flowers. A chorus tree the Glasswing visits grows faster. The Nether ones and their caterpillars are fire-proof.
Catch and keep
- Use a Butterfly Net on a butterfly while you carry an empty Butterfly Jar. The butterfly is drawn alive inside the placed jar.
- Sneak and use the jar with an empty hand to set it free. Breaking a jar keeps the butterfly in it.
The Flower Feeder
- A dish of nectar on a post. Stand it outdoors among at least three flowers and, by day in dry weather, it draws the local butterflies in to feed.
- Use it and it tells you whether it's working and, if not, what it lacks.
The whole life cycle
- Eggs on a leaf, a caterpillar in its species' colours that grows through three moults, a chrysalis, then the adult.
- Put two jars of the same species side by side and give one its favourite food: the eggs are laid beside the species' host plant.
- The chrysalis hangs under a leaf where it can, or stands upright against a twig, as swallowtails really do.
- Wild butterflies lay eggs too, and their young grow up by themselves. Caterpillars eat nothing and damage nothing.
- New in 0.3.0: caterpillars crawl like real ones, a wave running from tail to head, at a caterpillar's pace.
The Aurelia
- Flutterlight's own companion: feed a caterpillar three Sun Nectar and its chrysalis turns gold. An Aurelia comes out, tame to you.
- Its look follows the species you raised it from: five wing patterns, five glow colours, four wing shapes (rounded, scalloped, tailed, hooked) and a size of its own. Young take after their parents.
- Give it a home flower and it keeps a garden: it copies flowers you show it, tends crops and saplings, draws wild butterflies in, lights the garden at night after a sunny day, and flashes its eyespots to send hostile mobs reeling.
- Royal Nectar grows it into a Great Aurelia with a garden twice as wide, and the Wing Mantle is a glider that takes your Aurelia's colours.
- The Seraph: a rare white-and-blue form, about 1 in 256, more often high in the mountains.
The Butterfly Journal
- A field guide with a turning 3D model and a page for every species you catch: where it lives, its host plant, its food, notes and one true fact. Species you haven't caught show as a silhouette with a hint.
- Eight advancements to earn along the way.
For server owners: a server config sets how many wild butterflies appear, the wild life cycle, feeder visitors and every Aurelia power, and permission nodes work with LuckPerms. Install Flutterlight on both the client and the server.
Sister mods: Flutterlight works alone, and sits happily next to Mothlight (moths), Scarablight (beetles), Mantislight (mantises) and Twiglight (stick and leaf insects). Their recipes differ on purpose, so they can all be installed together.
Modpacks: you're welcome to include Flutterlight in modpacks.
More pictures and how to install: apps.zombie.digital/flutterlight
Designed, directed and playtested by DreadedZombie. Code written with AI assistance (Claude). All pictures are real in-game screenshots.








