Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to this versioning scheme.

[26.1-7.0.0.0] - 2026-03-28

Added

• color of dyed hats can be removed by using the cauldron (can be disabled by changing the item tag "minecraft:cauldron_can_remove_dye")
• re-added Curios support (NeoForge)

Changed

• updated to Minecraft 26.1 (Fabric 0.144.3+26.1, NeoForge 26.1.0.7-beta, Forge 62.0.4)
• updated Cloth Config support (26.1.154) (Fabric/Quilt)
• updated ModMenu support (18.0.0-alpha.8) (Fabric/Quilt)
• temporary removed Accessories support until it is ported to 26.1 (Fabric/Quilt, NeoForge)

Known Issues

• Forge: items are not rendered with colors until this issue is fixed: https://github.com/MinecraftForge/MinecraftForge/issues/10799

[1.21.11-6.12.0.0] - 2026-02-03

Changed

• updated to Minecraft 1.21.11 (Fabric 0.141.2+1.21.11, NeoForge 21.11.37-beta, Forge 61.0.8)
• updated Cloth Config support (21.11.153) (Fabric/Quilt)
• updated ModMenu support (17.0.0-beta.2) (Fabric/Quilt)
• temporary removed Accessories support until it is ported to 1.21.11 (Fabric/Quilt, NeoForge)

[1.21.10-6.11.1.0] - 2025-10-19

Changed

• re-added Accessories support (1.4.0-beta) (Fabric/Quilt, NeoForge)

[1.21.10-6.11.0.0] - 2025-10-14

Changed

• updated to Minecraft 1.21.10 (Fabric 0.135.0+1.21.10, NeoForge 21.10.16-beta, Forge 60.0.5)
• updated Cloth Config support (20.0.148) (Fabric/Quilt)
• updated ModMenu support (16.0.0-rc.1) (Fabric/Quilt)
• temporary removed Accessories support until it is ported to 1.21.10 (Fabric/Quilt, NeoForge)

[1.21.8-6.10.0.0] - 2025-10-13

Changed

• updated to Minecraft 1.21.8 (Fabric 0.134.0+1.21.8, NeoForge 21.8.47, Forge 58.1.0)
• updated Cloth Config support (19.0.147) (Fabric/Quilt)
• updated ModMenu support (15.0.0) (Fabric/Quilt)
• re-added Accessories support (1.3.8-beta) (Fabric/Quilt, NeoForge)

[1.21.6-6.9.1.0] - 2025-10-13

Added

• added config options for disabling Eat Boost or Jump Boost of Bunny Ears (thanks to Ameizo for the idea) #77

Fixed

• location of Ender Helmet was not saved persistently (thanks to Gunman1313 for the report) #76

[1.21.6-6.9.0.0] - 2025-06-19

Changed

• Updated to Minecraft 1.21.6 (Fabric 0.127.1+1.21.6, NeoForge 21.6.6-beta, Forge 56.0.3)
• Updated Cloth Config support (19.0.147) (Fabric/Quilt)
• Updated ModMenu support (15.0.0-beta.2) (Fabric/Quilt)

[1.21.5-6.8.0.1] - 2025-05-10

• Updated Forge to 55.0.11 to fix startup issue

[1.21.5-6.8.0.0] - 2025-04-25

Changed

• Updated to Minecraft 1.21.5 (Fabric 0.120.0+1.21.5, NeoForge 21.5.47-beta, Forge 55.0.9)
• Updated Cloth Config support (18.0.145) (Fabric/Quilt)
• Updated ModMenu support (14.0.0-rc.2) (Fabric/Quilt)
• temporary removed Accessories support until it is ported to 1.21.5 (Fabric/Quilt, NeoForge)

Known Issues

• Forge does not start until this issue is fixed: https://github.com/MinecraftForge/MinecraftForge/issues/10524

[1.21.4-6.7.0.0] - 2025-04-25

Changed

• Updated to Minecraft 1.21.4 (Fabric 0.116.0+1.21.4, NeoForge 21.4.88-beta, Forge 54.0.26)
• Updated Cloth Config support (17.0.144) (Fabric/Quilt)
• Updated ModMenu support (13.0.1) (Fabric/Quilt)
• Updated Accessories support (1.2.19-beta) (Fabric/Quilt, NeoForge)

[1.21.3-6.6.0.0] - 2025-04-23

Changed

• Updated to Minecraft 1.21.3 (Fabric 0.107.0+1.21.3, NeoForge 21.3.56, Forge 53.0.47)
• Updated Cloth Config support (16.0.141) (Fabric/Quilt)
• Updated ModMenu support (12.0.0) (Fabric/Quilt)
• Updated Accessories support (1.2.3-beta) (Fabric/Quilt, NeoForge)
• temporary removed Trinkets support until it is ported to 1.21.3 (Fabric/Quilt, NeoForge)

Removed

• removed "miningHatMakePiglinsNeutralEnabled" option and used the new vanilla item tag "piglin_safe_armor" (all loaders)
• removed Baubles 2 support (NeoForge)
• removed Curios API Continuation support (NeoForge)

[1.21.1-6.5.1.1] - 2025-04-21

Fixed

• fixed Halo to work also in custom dimensions. Only dimensions that are ultrawarm and piglinsafe are interpreted as Nether. (all loaders) (thanks to jtrmike for the report) #71

[1.21.1-6.5.1.0] - 2024-10-15

Changed

• updated to Forge 52.0.21
• use common tags for carrots, wheat and ender pearls in advancements and recipes (all loaders)

Fixed

• fixed recipes and advancements by using the new common tags in Forge

[1.21.1-6.5.0.0] - 2024-09-28

Changed

• updated to Minecraft 1.21.1 (Fabric 0.105.0+1.21.1, NeoForge 21.1.62, Forge 52.0.16)
• updated Cloth Config support (15.0.140) (Fabric/Quilt)
• updated ModMenu support (11.0.2) (Fabric/Quilt)

Fixed

• startup error since NeoForge 21.1.62

[1.21-6.4.1.0] - 2024-08-31

Changed

• number config options are now text fields instead of sliders (Fabric)

[1.21-6.4.0.0] - 2024-07-18

Changed

• updated NeoForge to 21.0.102-beta for better model registering

Fixed

• the recipe of Postman Hat contained a wrong lapis item tag (Fabric/Quilt & Neoforge) (thanks to WhitePhant0m for the report) #66

[1.21-6.3.1.0] - 2024-07-15

Changed

• re-added Trinkets support (1.21-3.10.0) (Fabric/Quilt)

[1.21-6.3.0.0] - 2024-07-14

Changed

• updated NeoForge to 21.0.94-beta
• the config directory is used for the default configuration (NeoForge)

Fixed

• crashed on startup with NeoForge (caused by a breaking change in 21.0.82-beta) (thanks to NielsPilgaard for the report) #64

[1.21-6.2.0.0] - 2024-07-08

Changed

• updated NeoForge to 21.0.76-beta

Fixed

• game crashed when wearing a Halo and an entity is around (caused by a breaking change in Neoforge)
• speed calculation for straw hat/chopping hat/mining helmet was wrong (all loaders) (thanks to Imperial-Warlord for the report) #62
• game crashed when hovering a straw hat/chopping hat/mining helmet (Fabric/Quilt) (thanks to makumaku1974 for the report) #63

[1.21-6.1.1.0] - 2024-06-29

Added

• added Curios Continuation support (9.0.4+1.21) (NeoForge)

[1.21-6.1.0.0] - 2024-06-28

Changed

• updated NeoForge to 21.0.42-beta
• updated Accessories support (1.0.0-beta.5+1.21) (Fabric/Quilt, NeoForge)
• updated Baubles 2 support (Pre-Release 0.5) (NeoForge)

Fixed

• getting enchantment values caused lags in tooltips and when wearing useful hats (thanks to Anselfx and Smokey for the report) #61

[1.21-6.0.2.0] - 2024-06-26

Added

• added Accessories (1.0.0-beta.2+1.21) support (Neoforge) #59

Fixed

• dependency issue with Baubles 2 was fixed (Neoforge)

[1.21-6.0.1.0] - 2024-06-26

Added

• added Accessories (1.0.0-beta.2+1.21) support (Fabric) #59
• added Baubles 2 rendering support (Neoforge)

[1.21-6.0.0.0] - 2024-06-26

Added

• added Baubles 2 support (Pre-Release 0.4) (without rendering) (Neoforge)

Changed

• updated to Minecraft 1.21 (Fabric 0.100.3+1.21, Neoforge 21.0.37-beta, Forge 51.0.18)
• updated Cloth Config support (15.0.127) (Fabric/Quilt)
• updated ModMenu support (11.0.1) (Fabric/Quilt)
• temporary removed Trinkets support until it is ported to 1.21 (Fabric/Quilt)
• Lucent support is still temporary removed until it is ported to 1.21 (Neoforge)

Fixed

• Mushroom Hat could not be repaired with mushroom cap blocks (Neoforge)

Removed

• removed Curios support, because the mod will not be ported to 1.21 (Neoforge/Forge)

[1.20.6-5.2.0.0] - 2024-05-28

Changed

• updated to Minecraft 1.20.6 (Fabric 0.99.0+1.20.6, Neoforge 20.6.83-beta, Forge 50.0.31)
• updated Cloth Config support (14.0.126) (Fabric/Quilt)
• updated ModMenu support (10.0.0-beta.1) (Fabric/Quilt)
• updated Trinkets support (1.20.6-3.9.0) (Fabric/Quilt)
• updated Curios support (1.20.6-8.0.0-beta.4) (Neoforge/Forge)
• temporary removed Lucent support until it is ported to 1.20.6 (Neoforge)
• changed advancements & recipes to match the reworked conventional tags (Fabric/Quilt & Neoforge)
• changed the enchantments of Aquanaut Helmet from Respiration to Efficiency
• changed the enchantments of Lucky Hat from Luck of the Sea/Looting to Efficiency
• changed Lucky Hat to give Luck effect everytime without holding special items
• changed rendering that all useful hats are using the same model

Removed

• removed ability to enchant the useful hats with Thorns, Aqua Affinity, Respiration
• "isCuriosEnabled" option was removed. One head slot is automatically added if Curios is installed (NeoForge/Forge)

[1.20.4-5.1.3.0] - 2024-05-20

Added

• added support for diving in modded fluids with Aquanaut Helmet (Neoforge, Forge)
• Wing Helmet effect considers modded fluids (Neoforge, Forge)

Changed

• generalized some internal methods so that they can also be used by LivingEntities

Fixed

• Game crashed when breaking a block with a non-fitting tool when wearing Chopping Hat, Mining Helmet or Straw Hat. (all loaders)

[1.20.4-5.1.2.0] - 2024-05-14

Changed

• Bunny Ears only get damage when jumping or when food is eaten
• reduced Bunny Ears default durability from 600 to 450

Fixed

• Game crashed when using non-edible items (bow, ...) with Bunny Ears equipped

[1.20.4-5.1.1.1] - 2024-05-11

Fixed

• Respiration effect of Aquanaut Helmet was removed when getting underwater (all loaders)
• Mixin warning at startup (Fabric/Quilt)

[1.20.4-5.1.1.0] - 2024-05-06

Added

• added Trinkets 3.8.1 mod support (Fabric, Quilt)

Changed

• optimized event handling for better performance (all loaders)
• some items are now damaged by time instead of a random factor (all loaders)
• internal rendering overhaul (all loaders)

Fixed

• fixed the ModMenu screen in Fabric / Quilt
• fixed startup crash on dedicated servers (Forge, Neoforge)
• enchanted glint shimmering was not rendered in Curios slots (Forge, Neoforge)

[1.20.4-5.1.0.0] - 2024-05-05

Added

• add Fabric (>=0.96.11+1.20.4) support (Fabric, Quilt)

Fixed

• fixed startup crash if optional Curios mod is missing in Neoforge
• removed Log-Spam in Neoforge

[1.20.4-5.0.0.0] - 2024-03-15

Changed

• updated to Minecraft 1.20.4 (Forge 49.0.31, Neoforge 20.4.200)
• updated compat with Curios to 1.20.4-7.3.0+ (Forge & Neoforge)
• updated compat with Lucent to 1.20.4-1.6.0+ (Neoforge)

Removed

• config option "isCuriosEnabled" (always enabled)

[1.20.1-4.2.0.0] - 2023-08-20

Changed

• Re-added Lucent 1.20.1-1.5.3 support #50

[1.20.1-4.1.0.0] - 2023-08-09

Changed

• Changed Forge to NeoForge 1.20.1-47.1.54 (compatible with Forge 47.1.0)

[1.20.1-4.0.0.0] - 2023-06-14

Changed

• Update mod to Forge 1.20.1-47.0.1 #49
• Update compat with Curios to 1.20.1-5.2.0-beta.3 #49
• Temporary deactivate Lucent support until it is ported to 1.20

[1.19.4-3.2.0.0] - 2023-03-25

Changed

• Update mod to Forge 1.19.4-45.0.24
• Update compat with Curios to 1.19.4-5.1.4.2 and Lucent to 1.19.4-v1.5.2

[1.19.3-3.1.0.0] - 2022-12-31

Changed

• Update mod to Forge 1.19.3-44.0.41
• Changed recipes to use more forge tags
• Update compat with Curios to 1.19.3-5.1.1.2 and Lucent to 1.19.3-v1.5.0

[1.19.2-3.0.2.0] - 2022-10-05

Added

• Lucent mod support for Mining Hat (if Lucent is installed, the night vision effect is replaced by the Lucent light effect)

Changed

• optimize Mining Hat damaging to be more precisely

[1.19.2-3.0.1.0] - 2022-09-13

Changed

• Update mod to Forge 1.19.2-43.1.23
• Make Halo related to the new boss tag of Forge
• optimize Halo damaging to be more precise

Removed

• removed Halo detecting range config option, because it is not needed any longer

[1.19-3.0.0.0] - 2022-07-18

Changed

• Update mod to Forge 1.19-41.0.96

Removed

• Support for Baubles Reborn mod (seems to be discontinued)

[1.18.2-2.0.2.0] - 2022-03-03

Changed

• Update mod to Forge 1.18.2-40.0.2

[1.18.1-2.0.1.0] - 2021-12-24

Changed

• Update mod to Forge 1.18.1-39.0.0
• Moved curiosAddHeadSlot option to common config file to fix #43 (thanks to ImKatsun)

[1.18-2.0.0.0] - 2021-12-10

Changed

• Update mod to Forge 1.18-38.0.17 (fix Log4J security issue)
• Moved mod settings file to server (defaultconfigs directory or serverconfig directory of savegame)
• removed settings to enable/disable single hats, because it does not work with server config (could be done by datapack or CraftTweaker)

[1.17.1-1.10.0.1] - 2021-12-07

Fixed

• Curios rendering fixed
• Ender Helmet couldn't be placed in curio slot

[1.17.1-1.10.0.0] - 2021-12-07

Changed

• Update mod to Forge 1.17.1-37.0.48

[1.16.5-1.10.0.0] - 2021-09-03

Added

• Russian and Ukrainian translation (thanks to vstannumdum aka DMHYT) #42

Changed

• Update mod to Forge 1.16.5-36.1.0
• changed versioning to fit Forge Recommended Versioning

[1.9.5_1.16] - 2021-04-30

Fixed

• fixed startup issue #41 if Curios and Forge 36.1.10 (or later) are installed (thanks to azaquaz & bappitybup for the bugreport)

[1.9.4_1.16] - 2021-04-13

Changed

• change rendering of UsefulHatsModel to fix bug #40 (thanks to Yourname942 for the report)
• Hint: Aquanaut Helmet transparency effect is gone #6

[1.9.3_1.16] - 2020-12-08

Changed

• Baubles Reborn support updated (if Baubles is used, version 1.8.3 or later is required)

Hints

• Don't forget the christmas variant of the stocking cap in december! :)
• Have a wonderful and healthy christmas time!

[1.9.2_1.16] - 2020-12-01

Added

• mod specific creative tab added

[1.9.1_1.16] - 2020-11-24

Added

• Add christmas variant for stocking cap (shown in december)
• support of enchantments of other mods
• Brazilian Portuguese translation updated (thanks to Mikeliro)

Changed

• Clarify tooltip of Ender Helmet
• Unbreaking and Mending enchantments are disabled if damaging is disabled

Fixed

• Book enchanting didn't work correctly

[1.9.0_1.16] - 2020-11-10

Added

• Ender Helmet added
• you need 5 Ender Pearls to craft an Ender Helmet
• shift right click with Ender Helmet in hand to define a teleport position
• when on head with a defined position: use an Ender Pearl to teleport to the defined position
• interdimensional traveling is possible (configurable)

[1.8.5_1.16] - 2020-09-28

Changed

• Minecraft 1.16.2 or later is required
• Forge 33.0.5 or later is required

Fixed

• Aquanaut Overlay was not rendered when equipped in Curios or Baubles slot
• since Minecraft 1.16.2 the tooltips were outside the screen (thanks to Zygus42 for reporting)
• related crashes of previous version 1.8.4 are fixed
• Due to that Minecraft 1.16.1 is not supported any longer

[1.8.4_1.16] - 2020-09-23

Added

• Curios head slot can now be added with the config option "curiosAddHeadSlot" (default:disabled)

Fixed

• bugfix: since Minecraft 1.16.2 the tooltips were outside the screen (thanks to Zygus42 for reporting)
• EDIT: The bugfix causes crashes in 1.16.2+. So, it is only compatible with 1.16.1.

[1.8.3_1.16] - 2020-09-15

Added

• wearing a Mining Hat makes Piglins neutral (configurable)
• added support for Baubles Reborn

[1.8.2_1.16] - 2020-09-12

Fixed

• bugfix: Chopping Hat effect didn't work in 1.16 because of a bug in Forge - fixed with a workaround

[1.8.1_1.16] - 2020-09-10

Added

• zh_tw translation added (thanks to pancakes0228)

Changed

• Wing Helmet effect is now active only when falling (not when (elytra) flying or jumping up)
• Mining Hat, Chopping Hat, Straw Hat effects are now compatible with Silent Gear tools
• pt_br translation updated (thanks to Mikeliro)

Fixed

• bugfix: wearing more than one same hat, effects are stacking and/or damage is taken for both

[1.8.0_1.16] - 2020-09-03

Added

• Bunny Ears added - gives Jump Boost & lets you eat faster (thanks to Jonatan javier for the idea)
• Mushroom Hat added - take a bite out of this hat automatically (thanks to AbsorbingSafe11 for the idea)
• Shulker Helmet added - gives Levitation (thanks to AbsorbingSafe11 for the idea)
• Lucky Hat is higher now (like a top hat)

Changed

• Hats are now rendered when equipped in Curios slot
• Other Curios slots are supported if the hats are added to them via data packs
• Support other mods that are changing the break speed via PlayerEvent.BreakSpeed

Fixed

• Some hats had not glint effect when they were enchanted