Bok's Banging Butterflies

Changelog

7.10.5 (2026/08/14)

• Butterfly entities will no longer die when on solid blocks.

7.10.4 (2026/08/08)

• Separated goals for pollination and feeding.

7.10.3 (2026/08/07)

• Extra Landing Blocks can now be set using Resource Locations or Block Tags.

7.10.2 (2026/08/06)

• Separated foodSource into foodBlock and `foodItem

7.10.1 (2026/08/02)

• Write agedVariant in ClientBoundButterflyDataPacket to prevent network error.
• Thanks to Spagles for this fix

7.10.0 (2026/08/01)

• Added the Orizaba Silkmoth.

7.9.3 (2026-07-26)

• Fixed incorrect Lifespan data being sent over network.

7.9.2 (2026-07-26)

• Fixed Obsidian Butterfly having invalid speed.

7.9.1 (2026-07-26)

• Fixed code generation.

7.9.0 (2026-07-26)

• Added the Fireproof Butterfly Net.

7.8.2 (2026-07-24)

• Added Peacemaker Advancements.

7.8.1 (2026-07-23)

• Add an advancement for catching the Obsidian Butterfly.

7.8.0 (2026-07-19)

• Added the Obsidian Butterfly.

7.7.5 (2026-07-17)

• Fixed translation strings for caterpillar items.
• Fixed missing texture for Peacemaker Butterfly Spawn Egg.

7.7.4 (2026-07-11)

• Some models weren't generating properly leading to incorrect rendering.

7.7.3 (2026-07-11)

• Fixed bottled butterflies/caterpillars always dropping Peacemaker Butterflies.

7.7.2 (2026-06-28)

• No longer a need to commit generated resources.

7.7.1 (2026-06-28)

• Fixed Bottled Peacemaker Butterflies not actually being bottled.

7.7.0 (2026-06-19)

• Mod now uses data generation properly.

7.6.0 (2026-06-04)

• Added the Smile Butterfly.

7.5.0 (2026-05-22)

• Added the Peacemaker Lair.

7.4.0 (2026-05-17)

• Added the Peacemaker Cow.

7.3.10 (2026-05-11)

• Added sync code to Butterfly Scroll that was accidentally removed.

7.3.9 (2026-05-11)

• Refactored registries so they are now singletons.

7.3.8 (2026-05-09)

• Peacemaker possession code will now only run if the entity isn't already possessed.
• Removed unused imports.
• Added @NotNull to DirectionalCreature.finalizeSpawn().
• Casting issues in ButterflyBookScreen removed.

7.3.8 (2026-04-30)

• Removed more unused imports.
• Suppressed an unneeded warning.
• Updated workflow so it checks for version change before publish.

7.3.7 (2026-04-30)

• Removed more unused imports.
• Fixed some nullability issues.
• Added finalizeConvert() to reduce duplicate code.

7.3.4 (2026-04-23)

• Added @NotNull to finalizeSpawn() in DirectionalCreature.
• Removed more unused imports.

7.3.3 (2026-04-22)

• Removed redundant Chinese character strings.
• Removed unused imports.
• Tidied up level access.
• Added DirectionalBaseRenderer for common code.
• Removed unnecessary drop code from Microscope Block.
• Added a finalizePossess() method to reduce duplicate code.

7.3.2 (2026-04-10)

• Fixed Peacemaker mobs crash-on-spawn.

7.3.0 (2026-02-16)

• Added Peacemaker Honey Bottles.

7.2.2 (2026-02-24)

• Moved zombie villager texture to its proper place.

7.2.1 (2026-02-18)

• Butterflies, Moths, and Peacemaker Butterflies now move smoothly.

7.2.0 (2026-02-07)

• Peacemaker butterflies can now be caught and released like normal butterflies.

7.1.3 (2026-02-02)

• Peacemaker butterflies won't attempt to spawn in already possessed entities.
• Peacemaker butterflies won't spawn in naturally born baby villagers.

7.1.2 (2026-02-02)

• Butterfly nets can only catch butterflies when empty.

7.1.1 (2026-02-02)

• Added localization strings for Peacemaker villagers with jobs.

7.1.0 (2026-01-10)

• Peacemaker Butterflies can now infest Wandering Traders.

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.1 (2025-06-16)

• Regenerated butterfly data.

6.2.0 (2025-06-12)

• Added the mimic butterfly.

6.1.13 (2025-06-06)

• Backported advancement fixes from 1.21.4.

6.1.12 (2025-06-06)

• Backported trade fixes from 1.21.4.

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.8 (2025-05-29)

• Fixed villager trades not having correct data.

6.1.7 (2025-05-29)

• Fixed translation strings for butterfly origami.

6.1.6 (2025-05-22)

• Fixed enum extensions for new spawn category.

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 behavior.

6.1.3 (2025-03-17)

• Increased size of butterfly entities.

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 entityId is 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.2 (2024-09-16)

• Fixed infested apples dropping for any broken block.

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 HUGE butterflies.

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 fertilizing butterflies with zero eggs.

4.11.2 (2024-08-03)

• Fixed missing spongymale textures 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 localization strings needed.
• Can now generate localization 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 optimization 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.3 (2024-01-05)

• Updated data pack format to 18 (correct version for 1.20.2).

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.1 (2023-12-15)

• Updated to Forge v48.1.0 (Minecraft v1.20.2)

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 of AmbientCreatures.

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.