Compatibility
Minecraft: Java Edition
1.21.4
1.21.1
1.20.4
1.20.1–1.20.2
1.19.2
1.18.2
Platforms
Supported environments
Links
Creators
Details
Licensed MIT
Published 2 years ago
Updated 22 hours ago
Changelog
Changelog
7.0.1 (2026-02-02)
- Fixed Peacemaker Butterflies constantly spawning in villagers.
7.0.0 (2026-01-03)
- Added Peacemaker Butterflies.
6.8.0 (2025-12-09)
- Added Aged Peacock Pansy variant.
6.7.0 (2025-12-05)
- Added Cold Common Yellow Grass variant.
6.6.7
- Added an effect when butterflies mud puddle.
6.6.6 (2025-10-08)
- Fixed config showing unnecessary values.
- Fixed stale butterfly data remaining when loading a new level.
- Improved comments in image generation pipeline
- Fixed allium not having a stage 7 model
- Fixed advancements not using correct item
6.6.5 (2025-09-18)
- Register spawn rules for Butterfly Golem.
6.6.4 (2025-09-18)
- Hummingbird Moth textures now generate and look nice.
6.6.3 (2025-09-16)
- Fixed loot tables for bottled butterflies not generating.
6.6.2 (2025-09-05)
- Added image generation for most textures to the pipeline.
6.6.1 (2025-08-28)
- Backported improved pipeline scripts.
6.6.0 (2025-08-27)
- Add spawn eggs with textures for all custom mobs.
6.5.6 (2025-08-27)
- Stopped ALL bottled butterflies from glowing.
6.5.5 (2025-08-26)
- Renamed 'male' to 'variant' for consistency.
6.5.4
- Removed the search bar from the butterfly creative mode tab.
6.5.3 (2025-08-07)
- Moved all butterfly items to their own creative tab.
6.5.2 (2025-08-02)
- Moved settings to the common config so they can be set by mod pack creators.
6.5.1 (2025-07-29)
- Tweaked the landing/movement code, so it's more robust.
6.5.0 (2025-07-18)
- Added the Peacock Pansy Butterfly.
6.4.5 (2025-07-11)
- Implemented mud puddling behaviour.
6.4.4 (2025-07-03)
- Butterflies can now land on any surface.
6.4.3 (2025-07-03)
- Created hummingbird moth landing animations.
6.4.2 (2025-06-30)
- Fixed Butterfly Scroll entities changing between versions.
6.4.1 (2025-06-29)
- Renamed items to take into account moths.
6.4.0 (2025-06-25)
- Added Hummingbird Moth variants.
6.3.1 (2025-06-24)
- Fixed items not dropping from Butterfly Scrolls after reload.
6.3.0 (2025-06-20)
- Added the crow butterfly.
6.2.0 (2025-06-12)
- Added the mimic butterfly.
6.1.11 (2025-06-06)
- Deleted Cherry Grove biome modifier template.
6.1.10 (2025-06-06)
- Increase Lepidopterist house spawn rates.
6.1.9 (2025-06-06)
- Added missing recipes for moth scrolls.
6.1.5 (2025-05-20)
- Moved butterflies to their own spawn pool.
6.1.4 (2025-03-17)
- Fixed scale methods accidentally overriding base entity behaviour.
6.1.2 (2025-03-09)
- Increased butterfly spawn rates.
6.1.1 (2025-03-04)
- Fixed a crash caused by using the wrong exception.
6.1.0 (2025-02-09)
- Added the butterfly microscope.
6.0.2 (2025-02-02)
- Fixed butterfly data not syncing correctly.
6.0.1 (2025-02-26)
- Fixed ClientEventListener being loaded on server distributions.
6.0.0 (2025-01-19)
- Villager Release
5.14.1 (2025-01-05)
- Christmas butterflies enjoy fruit.
5.14.0 (2024-12-29)
- Added the Christmas Butterfly.
5.13.6 (2024-12-11)
- Fixed caterpillars getting stuck on the edge of blocks.
5.13.5 (2024-12-11)
- Improved log output for butterfly goals.
5.13.4 (2024-12-11)
- Added debug information for butterfly states.
- Tweaked landing mechanics so they're more reliable.
5.13.3 (2024-12-04)
- Removed logspam caused by flower bud blockstates.
5.13.2 (2024-12-04)
- Hummingbird Moths will now have ambient sound.
5.13.1 (2024-12-04)
- Fixed hummingbird wing animations.
5.13.0 (2024-12-04)
- Added the hummingbird moth.
5.12.2 (2024-11-26)
- Generator will now ensure
entityIdis correct.
5.12.1 (2024-11-26)
- Added a check for duplicate entity IDs or indexes.
5.12.0 (2024-11-18)
- Added the Case Bearing Moth and the Oak Silk Moth.
5.11.0 (2024-11-13)
- Added the Green Skirt Baron.
- Improved error handling for invalid data
5.10.2 (2024-11-10)
- The grave now has two bottled Féileacáin.
5.10.1 (2024-11-10)
- The grave now shows both lover's names and will spawn Féileacáin.
5.10.0 (2024-11-10)
- Added Liang Shanbo's grave.
5.9.1 (2024-11-07)
- Improved Féileacáin texture.
5.9.0 (2024-11-07)
- Added the Féileacáin.
5.8.2 (2024-10-31)
- Added idle animations to the Butterfly Golem.
5.8.1 (2024-10-31)
- Added loot table and spawn rules to Butterfly Golem.
5.8.0 (2024-10-31)
- Added the butterfly golem.
5.7.1 (2024-10-22)
- Added missing translation strings for egg entities.
5.7.0 (2024-10-22)
- Added Butterfly Origami.
5.6.0 (2024-09-27)
- Added the Butterfly Banner Pattern.
5.5.1 (2024-09-25)
- Wandering Traders now offer uncommon butterflies as generic trades, replacing the rare trades.
5.5.0 (2024-09-18)
- Added the Butterfly Pottery Sherd.
5.4.1 (2024-09-17)
- Reduced drop rate of infested apples.
5.4.0 (2024-09-16)
- Added wandering villager trades.
5.3.1 (2024-09-10)
- Fixed missing entities from NBT files.
5.3.0 (2024-09-10)
- Added the Lepidopterist House.
5.2.2 (2024-09-10)
- Added Hero of the Village rewards to the lepidopterist.
5.2.1 (2024-09-10)
- Changed Lepidopterist job sound to planting flowers.
5.2.0 (2024-08-26)
- Added the lepidopterist.
5.1.1 (2024-08-20)
- Butterfly data is now the source of truth for data generation.
5.1.0 (2024-08-20)
- Added the butterfly feeder.
5.0.7 (2024-08-18)
- More refactoring to remove static registry references.
5.0.6 (2024-08-18)
- Refactored code to rely less on static variables.
5.0.5 (2024-08-18)
- Fix plateau and plain biome modifiers being confused.
5.0.4 (2024-08-18)
- Biome modifiers can now be generated.
5.0.3 (2024-09-16)
- Increased Client Tracking Range for butterflies.
5.0.1 (2024-08-14)
- Fixed incorrect syncing from client to server.
5.0.0 (2024-08-11)
- Release v5.0.0
4.19.0 (2024-08-11)
- Added the Blue Moon Butterfly.
4.18.0 (2024-08-10)
- Added the Common Birdwing Butterfly.
- Added support for
HUGEbutterflies.
4.17.0 (2024-08-10)
- Added the Commander Butterfly.
4.16.0 (2024-08-09)
- Added the Common Grass Yellow Butterfly.
4.15.3 (2024-08-05)
- Peacock butterflies can pollinate sweet berry bushes.
4.15.2 (2024-08-05)
- Monarch Caterpillars can be brewed into poison.
4.15.1 (2024-08-05)
- Heath butterflies now use
MothWanderGoal.
4.15.0 (2024-08-05)
- Cats and forester butterflies are no longer enemies.
4.14.1 (2024-08-05)
- Emperor and Hairstreak butterflies can now use wood blocks.
4.14.0 (2024-08-05)
- Added Clipper Butterfly variants.
4.13.3 (2024-08-05)
- Cabbage butterflies are now fast.
4.13.2 (2024-08-05)
- Buckeye butterflies can now use melon and pumpkin blocks.
4.13.1 (2024-08-05)
- Admiral butterflies are now crepuscular.
4.13.0 (2024-08-05)
- Added butterfly breeding.
4.12.0 (2024-08-03)
- Added the Diamondback Moth.
4.11.3 (2024-08-03)
- Fixed mating goal fertilising butterflies with zero eggs.
4.11.2 (2024-08-03)
- Fixed missing
spongymaletextures and models.
4.11.1 (2024-08-03)
- Added Infested Apples.
4.11.0 (2024-08-03)
- Added the Codling Moth.
4.10.0 (2024-08-02)
- Added the Atlas and Carpet Moths.
4.9.0 (2024-07-29)
- Added support for dimorphic species.
- Added the Spongy Moth.
4.8.0 (2024-07-28)
- Added the Indian Meal Moth.
- New goal for butterflies/moths that eat plants.
- Hay bales are now an option for butterflies to use as landing blocks.
- Fixed the spawn code so it takes advantage of
extraLandingBlocks.
4.7.0 (2024-07-25)
- Added the Peppered Moth.
4.6.0 (2024-07-25)
- Added the Domestic Silk Moth.
4.5.4 (2024-07-23)
- Some minor adjustments to butterfly animations when landed.
4.5.3 (2024-07-21)
- Fixed butterfly landing state not being saved correctly.
4.5.2 (2024-07-20)
- Fixed directional creatures not getting their spawn block properly.
4.5.1 (2024-07-17)
- Fixed some advancement related bugs.
4.5.0 (2024-07-15)
- Added the Clothes Moth.
4.4.0 (2024-07-14)
- Added silk.
4.3.0 (2024-07-11)
- Moths will spread their wings when they land rather than hold them straight up.
4.2.0 (2024-07-11)
- Moths will now be drawn to brighter areas.
4.1.0 (2024-07-02)
- Added diurnality to butterflies.
4.0.1 (2024-07-05)
- Fixed bounding box for butterflies, so they won't escape bottles.
4.0.0 (2024-07-01)
- Pollination Release of Bok's Banging Butterflies.
3.6.0 (2024-07-01)
- Added the Ice Butterfly.
3.5.2 (2024-06-28)
- Improved butterfly data reading.
3.5.1 (2024-06-28)
- Fixed butterflies colliding with the ground too often.
3.5.0 (2024-06-28)
- Butterflies will now avoid other entities.
3.4.12 (2024-06-28)
- Butterflies now mate using a goal rather than by pure chance.
3.4.11 (2024-06-21)
- Torchflowers will now use the vanilla crops and require farmland to spread.
- Config option to disable the pollination entirely.
- Added preferred flowers to butterfly book descriptions.
3.4.10 (2024-06-18)
- Butterflies will pollinate flowers and cause new ones to grow.
- Flower crops will bloom into flowers.
- Some fixes for butterfly bounding boxes.
- Fixed goals not having access to butterfly data when created.
3.4.9 (2024-06-11)
- Added new AI goals for butterfly landings.
3.4.8 (2024-06-03)
- Fixed species extraction for butterfly entities.
3.4.7 (2024-06-03)
- Butterfly registration now happens automatically.
3.4.6 (2024-05-31)
- Butterfly based advancements can now be generated.
3.4.5 (2024-05-26)
- Reduced number of localisation strings needed.
- Can now generate localisation strings.
3.4.4 (2024-05-26)
- Texture locations for butterfly scrolls are automatically generated.
3.4.3 (2024-05-26)
- Frog food JSON data can now be generated.
3.4.2 (2024-05-25)
- Fixed the Butterfly Book challenge.
3.4.1 (2024-05-23)
- Added the Peacock Butterfly.
3.4.0 (2024-04-06)
- Compatibility Release.
3.3.3 (2024-04-01)
- Fixed butterfly tag code that was accidentally removed.
3.3.2 (2024-03-20)
- Added tooltips to butterfly items.
3.3.1 (2024-03-20)
- Butterflies now release heart particles when they become fertile.
3.3.0 (2024-03-08)
- Reworked biome modifiers, so butterflies can spawn in other mod's biomes.
3.2.2 (2024-03-14)
- Advancements now work with new items.
3.2.1 (2024-03-12)
- Rewrote butterfly items and recipes, so they don't rely on NBT data to work.
3.2.0 (2024-03-08)
- Butterfly eggs now spawn as entities.
3.1.1 (2024-03-19)
- Fixed server crash when destroying bottled butterflies.
3.1.0 (2024-03-02)
- Butterflies now need to 'mate' before they can lay eggs.
- Butterfly movement now allows more freedom.
- Frogs will now eat butterflies.
- Butterflies have more predators in general.
- Butterflies now have a limited number of eggs.
- Butterfly breeding will be disabled in areas where they are too dense.
- Added server config options to help manage butterfly growth.
3.0.3 (2024-02-29)
- Caterpillar items now get added to the inventory on the server side.
3.0.2 (2024-02-16)
- Caterpillars remembered how to fall.
3.0.1 (2024-02-16)
- Fixed Butterfly Data not being synced with clients correctly.
3.0.0 (2024-02-15)
- Caterpillar Release.
2.4.0 (2024-02-12)
- Caterpillars can now be stored in jars.
2.3.0 (2024-02-08)
- Caterpillars and Chrysalises will now spawn naturally.
2.2.2 (2024-02-04)
- Advancements for collecting caterpillars.
2.2.1 (2024-02-04)
- Caterpillars that end up on non-leaf blocks will starve to death instead of creating a chrysalis.
2.2.0 (2024-02-04)
- Caterpillars can be picked up and moved by players.
2.1.1 (2024-02-07)
- Expanded culling boxes for butterfly entities for compatibility with optimisation mods.
2.1.0 (2024-01-28)
- Butterfly data can now be edited via JSON files.
2.0.9 (2024-01-26)
- Fixed butterfly net achievements not working.
2.0.8 (2024-01-14)
- Redesigned the buckeye butterfly texture.
- Tweaked cabbage and forester textures.
2.0.7 (2024-01-13)
- Butterfly eggs are now smaller.
2.0.6 (2024-01-05)
- Fixed shift-clicking recipes.
2.0.5 (2024-01-05)
- Added a secret goal.
2.0.4 (2024-01-05)
- Mobs spawned using spawn eggs will now be persistent.
2.0.2 (2024-01-04)
- Fix butterfly azalea leaves not having a model.
2.0.1 (2023-12-17)
- Fix crash when launching server.
2.0.0 (2023-12-15)
- Second release of the mod.
1.5.0 (2023-12-15)
- Zhuangzi
1.4.0 (2023-12-15)
- Added the butterfly book
1.3.1 (2023-12-08)
- Fixed rendering of butterfly scrolls
1.3.0 (2023-12-08)
- Modified sizes of butterflies so they're closer to reality
- Some butterflies will now move faster
- Butterflies now have varying rarities
- Caterpillars, chrysalises, and butterflies now have varying lifespans
1.2.0 (2023-11-30)
- Snow.
1.1.4 (2023-11-30)
- Butterflies can now spawn in cherry groves.
1.1.3 (2023-11-30)
- Caterpillar and chrysalis size is now affected by species and age.
1.1.2 (2023-11-30)
- Use ResourceLocations instead of strings for spawning butterfly entities.
1.1.1 (2023-11-12)
- Butterfly scrolls can now be placed around the world.
1.1.0 (2023-11-05)
- Added butterfly scrolls.
1.0.4 (2023-11-23)
- Fixed crash when hovering over full butterfly net.
1.0.3 (2023-11-22)
- Fixed caterpillar and chrysalis aging.
1.0.2 (2023-11-06)
- Added names to the entities to better support mod packs.
1.0.1 (2023-10-29)
- Updated Forge to current recommended version (47.2.0).
1.0.0 (2023-10-28)
- First release of the butterfly mod.
0.8.5 (2023-10-28)
- Chrysalises will now spawn in the correct position.
0.8.4 (2023-10-15)
- Moved butterfly eggs to Spawn Eggs section of creative inventory.
0.8.3 (2023-10-15)
- Made butterfly egg-laying 16 times rarer.
0.8.2 (2023-10-15)
- Fixed emperor chrysalis texture.
0.8.1 (2023-10-15)
- Butterflies et al. are now
Animals instead ofAmbientCreatures.
0.8.0 (2023-09-30)
- Cats now attack butterflies.
0.7.1 (2023-09-30)
- Created textures for chrysalises.
0.7.0 (2023-09-25)
- First pass Chrysalis implementation
0.6.6 (2023-09-15)
- Caterpillars can now crawl on surfaces in all directions.
0.6.5 (2023-09-13)
- Fixed mangrove and cherry leaf blocks not spawning caterpillars.
0.6.4 (2023-09-09)
- Fixed immortal butterflies being spawned if a bottled butterfly is destroyed by lava.
0.6.3 (2023-09-09)
- Added multiple textures for bottled butterflies.
0.6.2 (2023-09-08)
- Added advancements for collecting butterfly eggs.
0.6.1 (2023-09-08)
- Fixed JSON format of achievements.
0.6.0 (2023-09-08)
- Added caterpillars.
0.5.0 (2023-08-19)
- Added butterfly eggs.
0.4.2 (2023-08-16)
- Bottled butterfly recipe now unlocks if a player has both glass bottle(s) and a butterfly net in their inventory.
0.4.1 (2023-08-11)
- Nets and bottles will now describe if they are empty.
0.4.0 (2023-08-09)
- Added bottled butterflies
0.3.1 (2023-07-24)
- Updated Forge to version 47.1.42 (supports Minecraft 1.20.1)
0.3.0 (2023-07-19)
- Updated Forge to version 47.0.35 (supports Minecraft 1.20.1)
0.2.1 (2023-07-19)
- Fixed butterfly release code.
- Reduced butterfly speed to make them easier to catch.
- Made fishing rod recipe a bit more readable.
0.1.12 (2023-07-17)
- Added the butterfly net.
0.1.11 (2023-06-02)
- Added the Clipper and Buckeye Butterflies.
0.1.10 (2023-05-31)
- Added the Longwing Butterfly.
0.1.9 (2023-05-31)
- Added the Admiral Butterfly.
0.1.8 (2023-05-06)
- Butterfly bodies now face the right way.
0.1.7 (2023-05-06)
- Replaced Common Butterfly with Birdwing Butterfly.
0.1.6 (2023-05-05)
- Added the Cabbage Butterfly.
0.1.5 (2023-05-05)
- Added the Monarch Butterfly.
0.1.4 (2023-05-05)
- Butterflies will now spawn in different biomes depending on type.
0.1.3 (2023-05-05)
- Renamed method in ItemRegistry to be more descriptive.
0.1.2 (2023-05-05)
- Butterflies can now spawn on leaves.
0.1.1 (2023-05-03)
- Update to Forge 1.19.4.
0.1.0 (2023-05-02)
- Created butterfly entities that can spawn in the world.
0.0.0 (2023-02-01)
- Basic configuration and setup for the mod.
Files
Metadata
Release channel
ReleaseVersion number
7.0.1Loaders
Game versions
1.18.2Environment
Client and server, required on both
Downloads
2Publication date
February 2, 2026 at 12:08 AMPublisher

DocBok
Owner


