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 pinned to paper if you want to keep a record of 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.
Flower Pollination
Butterflies will occasionally fly toward and pollinate flowers. This will spawn flower buds that will eventually bloom into full flowers.
Mud Puddling
In order to gain nutrients, butterflies will swarm around mud puddles. This will extend their lifespan meaning they won’t die as quickly. To create a mud puddle just place a Mud Block next to a Water Source (use Clay Blocks in versions of Minecraft without mud).
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 Lepidopterist’s Book.
Silk
Some Moth cocoons will drop Silk, which can be crafted into string or paper. Unfortunately, this kills the Moth.
Scrolls, Microscopes, and Books
Scrolls can be examined using the Butterfly Microscope, so you can learn more about the various species. You can also use the Microscope to place the Scrolls in a Lepidopterist’s Book, allowing the player to collect all the information in one place.
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.
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 and Wandering Trader
This new Villager will provide players with Butterfly-related trades. The Wandering Trader has also been updated to offer new trades as well.
New Cosmetic Items
Butterfly Banners and Butterfly Origami add some flavour for builders and collectors.
Peacemaker Butterflies
These creatures look like Butterflies, but are actually aliens intent on taking over your Minecraft world. Be wary if you encounter them.
If you are wanting a more peaceful experience, such as in cottagecore mod packs, these mobs can be disabled in the configs (see below).
Secrets
There are a few secret features in the mod. Books with ancient poetry, strange Moths from hell, and Butterfly-related structures. Can you discover them all?
Latest Release
Development Diary
Source Code
Download Locations
Contributors
Although this mod is a passion project of mine, that doesn’t mean I’ve done all of this alone. Others have helped by contributing code, reporting bugs, and making suggestions. The following is an incomplete list of users that have helped with the project.
Pull Requests Created
- Andepthy (2)
- BonsUnleashed (1)
- Spagles (1)
Issues Created
- mxnmnm (4)
- FunkyPig112 (2)
- katubug (2)
- ZLLZTMNB (2)
- al-wei (1)
- dandalous (1)
- IMS212 (1)
- Sandiozo (1)
- SociallyAwkrd (1)
- tayvill (1)
- Zelioth (2)
General Advice
- Zelioth (2)
Common Config Options
You can customize Butterfly behaviors by editing the config file located in your installation folder under:
/mods/Butterflies-common.toml
| Option | Description | Default |
|---|---|---|
double_Egg_chance | Chance a Butterfly lays double Eggs (range 0 to 1). | 0.0625 |
Egg_limit | Maximum Eggs a Butterfly can lay (range 0 to 1024). | 1 |
max_density | Maximum Butterflies per 32x32x32 block area before breeding is disabled; 0 to disable limit. | 16 |
enable_lifespan | If true, Butterflies will have natural lifespans and can die. | true |
enable_pollination | If true, Butterflies will pollinate flowers, helping them spread. | true |
enable_hostile_butterflies | If true, Peacemaker Butterflies will spawn in your world. | true |
villager_possession_chance | Chance out of 1000 that Villagers are spawned with Peacemaker Butterflies. Requires hostile butterflies enabled. | 17 |
wandering_trader_possession_chance | Chance out of 1000 that Wandering Traders are spawned with Peacemaker Butterflies. Requires hostile butterflies enabled. | 35 |
illager_possession_chance | Chance out of 1000 that Illagers/Witches are spawned with Peacemaker Butterflies. Requires hostile butterflies enabled. | 50 |
butterfly_golem_spawn_chance | Chance out of 1000 that a Butterfly Golem will spawn instead of an Iron Golem. | 4 |
Server Config Options
You can enable debug information by editing the config file located in your save folder under:
/serverconfig/Butterflies-server.toml.
| Option | Description | Default |
|---|---|---|
debug_info | If set to true, debug information will be rendered | false |
One of 16 different varieties.
