Bok’s Banging Butterflies

This mod adds butterflies with a full life cycle to the world of Minecraft. It features several butterfly species as well as several moth species. Most are based on real-life butterflies but a few are pure fantasy creatures.

This latest version contains various fixes, as well as some villager related features to enhance your experience with butterflies.

Features


Butterflies and Moths

There are several species of butterfly and moths in the mod, each with their own design and behaviour. Some will be larger, some will move faster, some will live longer than others. Some are dimorphic, some love apples, some will live in wood or fruit.

Butterflies can be caught or released using a butterfly net. Once caught, they can be bottled and placed in the world as decorative objects. They can also be stored in a butterfly book where you can learn more about them.

Eggs

Butterflies will lay eggs in leaves if they get close to them. The eggs will eventually hatch into caterpillars. If a player breaks the eggs, they will drop. Players can then replant these eggs on other leaves.

Caterpillars

After living on the leaves for a short time, a caterpillar will eventually build a chrysalis. If the caterpillars end up on any other block, they will instead starve to death.

Players can pick up caterpillars and move them to other leaf blocks if they wish.

Chrysalises

Built by caterpillars, these will eventually hatch into new butterflies within the world. These cannot be moved by players and will be destroyed if they attempt to do so.

Silk

Some moth cocoons will drop silk, which can be crafted into string or paper. Unfortunately, this kills the moth.

Scrolls and Books

Butterflies can also be pinned to a piece of paper to create a scroll where you can look at the butterfly in detail. Unfortunately this kills the butterfly. These scrolls can also be placed around your world as decoration.

Scrolls can also be placed in a book, allowing the player to collect more detailed information on each butterfly species.

Jars

Butterflies and caterpillars can be placed into jars. These are decorative items that can be placed in the world. Butterflies and caterpillars placed this way will not die, lay eggs or create chrysalises.

If you want to get the butterfly or caterpillar back, they can be released by using the bottle while not highlighting a block.

Flower Pollination

Butterflies will occasionally fly toward and pollinate flowers. This will spawn flower buds that will eventually bloom into full flowers.

Breeding

Butterflies can be bred by players feeding them their favourite flower (or other plant). You will need to learn what their favourite food is by studying the butterfly book.

Butterfly Feeder

These can be filled with food to allow automated breeding of butterflies. They can only take one stack at a time though.

Lepidopterist

This new village will provide players with butterfly-related trades.

New Cosmetic Items

Butterfly banners and butterfly origami add some butterfly related flavour for builders and collectors.

Secrets

There are a few secret features in the mod. Books with ancient poetry, strange moths, and butterfly-related structures. Can you discover them all?

Server Config

There are now server config options to help manage butterfly growth. You can find them in your world folder, under /serverconfig/butterflies-server.toml.

The available options are:

double_egg_chance: Defines the chance a butterfly has double the eggs (default: 0.0625).

egg_limit: Defines how many eggs each butterfly can lay (default: 1).

max_density: Defines how many butterflies can be in a 32x32x32 region before breeding is disabled. If set to zero, this is ignored (default: 16).

enable_lifespan: If set to TRUE butterflies will die naturally (default: true).

enable_pollination: If set to TRUE butterflies will pollinate flowers and cause them to spread (default: true)

debug_info If set to TRUE debug information will be rendered (default: false)

Latest Changes

  • Biome modifiers can now be generated.
  • Fixed plains and plateau biome modifiers accidentally swapped
  • Added the butterfly feeder.
  • Made butterfly data the source of truth for generation.
  • Added the lepidopterist villager.
  • Added the Lepidopterist House.
  • Fixed butterflies not moving until you get close.
  • Add Chinese Simplified translations (thanks @Andypsl8)
  • Remove extra spaces from en_us.json (thanks @Andypsl8)
  • Reduced drop rate of infested apples.
  • Added the Butterfly Pottery Sherd. Not available in 1.19.2.
  • Wandering Traders now offer uncommon butterflies.
  • Added the butterfly banner pattern.
  • Added Butterfly Origami.
  • Added missing translation strings for egg entities.
  • Added the butterfly golem.
  • Added the Féileacáin.
  • Added Liang Shanbo’s grave.
  • Added the Green Skirt Baron.
  • Added the Case Bearing Moth and the Oak Silk Moth.
  • Added the Hummingbird Moth.
  • Improved butterfly landing logic.
  • Improved log output for butterfly goals.
  • Fixed caterpillars getting stuck on the edge of blocks.
  • Added the Christmas Butterfly.