• Added 10 new Emotes. (Mind Blown, Facepalm, Jackpot, Error 404, Star Struck, Vanish, X-Ray, Melting, Bubblegum, Overcaffeinated)
• Added 32 new Animated Hats. (Spinning Globe, Campfire, Aquarium, Buffering, Thunder Cloud, Black ****, Mimic Chest, Galaxy, Lava Lamp, Rubik's Cube, Volcano, Fireworks, Cuckoo Clock, Aurora, Matrix Rain, Snow Globe, Disco Ball, Pufferfish, Magic 8-Ball, Hourglass, Aqua Orb, Ender Pulse, Evil Eye, Fire Demon, Ice Mage, Golem, Basketball, Robo Bird, Fox Spirit, Derpy Eyes, Demon Eyes, Bauble)
• Added 19 new Cloaks. (Rainy Day, Acid Rain, Bone Wings, Melon, Clover, Strawberry, Snow Globe, Popcorn, Bubble Tea, Mushroom, Ghost, Avocado, Donut, Bee, Jellyfish, Rainbow, Rocket, Diamond, Gift Box, Crown, Pumpkin, Burger)
• Custom Cloaks
  • Added the PICTURE animation mode, which draws a picture flat on the player's back using the same renderer as the built-in picture cloaks, so a configured cloak can now reproduce any of them.
  • Shapes can now be drawn as character art against a Palette that maps one character to one colour, instead of comma separated hex per cell. The built-in Clover shape is roughly 4,200 characters in the old format and 525 as character art.
  • Added an optional Rotation to PICTURE layers, which turns the picture in its own plane the way the Clover and Bubble Tea cloaks are turned.
  • Removed the COLOR_GRID animation mode. It drew the same thing PICTURE draws with clumsier controls. A layer still set to COLOR_GRID is skipped and the console names the keys to change. See the Custom Cloaks documentation for the conversion steps.
• Grappling Hook Gadget is now available in 1.8 and above servers. (Previously only available in 1.13 and above)
• Fixed ISSUES-1039 - Moved menu item updates to the primary thread for safer and more reliable execution.
• Fixed ISSUES-1040 - Optimized particle effects to improve summon performance and overall efficiency.
• Fixed ISSUES-1041 - Optimized the `/gmenu about -diagnose` HTTP request to prevent main-thread blocking and added a connection timeout.
• Fixed ISSUES-1043 - Fixed an issue where the Scarecrow Gadget permanently destroys the real helmet of the player when the gadget is activated.
• Fixed ISSUES-1045 - Optimized music gadget loading by parsing song files only once during initialization, reducing subsequent loading time.

Click to expand...

• Added 5 new Cloaks. (Rainy Day Cloak, Acid Rain Cloak, Bone Wings Cloak, Easter Egg Cloak, Monarch Wings Cloak)
• Added the Flammable Grappling Hook Gadget.
• The Grappling Hook Gadget now pulls the player higher on both launch and arrival, so grappling up onto a ledge clears it far more reliably.
• Added support for the four copper Note Block instruments introduced in Minecraft 26.1 (Trumpet, Exposed Trumpet, Weathered Trumpet and Oxidized Trumpet).
• Updated the .nbs song reader to the latest Note Block Studio format (version 5). Songs may now declare up to 240 custom instruments and place their custom sounds in sub folders, and the loop settings, layer locks, original author and time signature of a song are now read.

Click to expand...

Changes

• Added Custom Cloaks. You can now create your own cloaks using the 6 animation modes (GRID, COLOR_GRID, ORBIT, SPIRAL, SCATTER, SPHERE), multiple animation layers per cloak, per-layer particles and colour cycling.
• Custom Cloaks ships with seven showcase examples, one per animation type (Infernal Wings, Phoenix Wings, Astral Helix, Aurora Scanner, Nebula Storm, Arcane Sphere and the three-layer Seraph Aegis), all disabled by default.
• Dropped v1_21_R5 (1.21.6, 1.21.7, 1.21.8) support. (Still support version 1.21.9, 1.21.10, 1.21.11)
• Fixed ISSUES-1031 - Fixed a rare issue where equipped cosmetics were not restored when a player joined, causing the saved cosmetic selection to be cleared from the database.

• Fixed ISSUES-1028 - Fixed a ClassNotFoundException (PacketPlayOutMount) affecting the Cowboy Gadget on Paper 26.1/26.2.

Click to expand...

• Revamp and improve Railgun Gadget animation.
• Fixed ISSUES-1033 - Fixed an issue with async player inventory updates causing potential ConcurrentModificationException.
• Fixed ISSUES-1034 - Fixed an issue with scheduled async inventory checks causing potential inventory desync and exceptions.
• Fixed ISSUES-1035 - Fixed an issue where async animated hat updates caused synchronous event exceptions when players switched worlds.
• Fixed ISSUES-1036 - Fixed an issue where equipping a cosmetic with "Equip-Cosmetic-Item-To-Slot" set to REPLACE or DROP could destroy or drop the wrong item. The displaced item is now safely returned to the player's inventory.
• Fixed ISSUES-1037 - Fixed an issue where paying Mystery Dust to offline players failed due to async event execution.
• Fixed ISSUES-1038 - Fixed an issue where Mystery Dust balances could be incorrectly overwritten or become negative during database errors. At the same time, we also did some optimizations to database CRUD operations.

Click to expand...

Changes

• Fixed ISSUES-1032 - Fixed an issue where players could obtain Gifted Mystery Boxes for free.
• Fixed an issue that might throws IllegalAccessError error in paper server.

Click to expand...

Changes

• Added a set of new Bukkit events to the developer public API: ItemPurchaseEvent, CosmeticEquipEvent, CosmeticUnequipEvent, CosmeticUnlockEvent, MysteryBoxCraftEvent, MysteryBoxRewardEvent, GadgetActivateEvent and EmoteActivateEvent. Developers can now listen to (and cancel) cosmetic purchases, equips, unlocks, mystery box crafting/rewards and gadget/emote activations.
• Fixed ISSUES-1028 - Dismounting a pet no longer throws `ClassNotFoundException` (PacketPlayOutMount) on Paper 26.1/26.2.

Developer API — New Events

This release adds a set of new Bukkit events to the public API under com.yapzhenyie.GadgetsMenu.api.event, giving developers hooks into the most common cosmetic actions. All events follow the standard Bukkit pattern (getHandlerList() / @EventHandler).

Cosmetics

ItemPurchaseEvent		A player purchases a cosmetic with mystery dust. Exposes a PurchaseStatus (SUCCESS / FAILED) — SUCCESS fires after the dust is deducted but before the cosmetic is granted, and cancelling it refunds the dust automatically.
CosmeticEquipEvent		A player equips any cosmetic (all categories). Cancel to block equipping in arenas, combat, etc.
CosmeticUnequipEvent		A player unequips a cosmetic. Informational.
CosmeticUnlockEvent		A cosmetic becomes owned by a player — from a dust purchase, mystery box loot, or an admin/API grant.

[td]

Event​

[/td][td]

Cancellable​

[/td][td]

Fired when​

[/td]​

Equip, unequip and unlock events expose the cosmetic as a CosmeticType object (getCosmeticType()), giving access to its name, display name, permission, rarity and mystery dust price. Suits fire one event per armour piece.

Click to expand...

Mystery Boxes

MysteryBoxCraftEvent		A player crafts a mystery box with mystery dust.
MysteryBoxRewardEvent		A player receives a reward from opening a mystery box. isDuplicate() tells you if the reward was already owned.

[td]

Event​

[/td][td]

Cancellable​

[/td][td]

Fired when​

[/td]​

Gadgets & Emotes

GadgetActivateEvent		A player activates a gadget. isLeftClick() distinguishes the click type.
EmoteActivateEvent		A player activates an emote.

[td]

Event​

[/td][td]

Cancellable​

[/td][td]

Fired when​

[/td]​

Example

Code (Java):

@EventHandler
public void onEquip(CosmeticEquipEvent event) {
if (isInArena(event.getPlayer())) {
event.setCancelled(true); // block cosmetics inside arenas
}
}

More details, please refer github.

Click to expand...

• Fixed ISSUES-1030 - Rideable horse-family pets (horse, donkey, mule, llama, camel, skeleton/zombie horse) no longer spam `ClassCastException` while being ridden on Minecraft 26.2.

Click to expand...

Changes

• Cooldown notification can now be shown as a boss bar, not just the action bar.
• Fixed ISSUES-1029 - Tic Tac Toe Gadget no longer crashes on Minecraft 1.21.6+ / 26.x when a message field is empty.

New feature: Boss bar cooldown notification
Cosmetics with a cooldown (gadgets, morphs, etc.) can now display their remaining cooldown as a boss bar at the top of the screen that empties as the cooldown runs down. The original action bar style is still the default, so nothing changes unless you opt in.

All settings live in messages.yml under Cooldown-Notification. After updating to this version, start the server once so the new keys are written, then edit:
Code (YAML):
Cooldown-Notification:
Enabled: true
# Where the cooldown is shown: ACTION_BAR or BOSS_BAR
Display-Type: ACTION_BAR

# Used only when Display-Type is ACTION_BAR
Action-Bar:
Cooldown-Block:
Remain: '&c|' # a block still on cooldown
Retain: '&a|' # a block already recovered
Amount-Of-Blocks: 100 # how many blocks make up the bar
Cooldown-Message: '{NAME} &f{COOLDOWN_BLOCK} &f{TIME_LEFT}s'

# Used only when Display-Type is BOSS_BAR
Boss-Bar:
Color: PURPLE # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
Style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
Cooldown-Message: '{NAME} &f{TIME_LEFT}s'
To switch to the boss bar: set Display-Type: BOSS_BAR, then tune Boss-Bar.Color, Boss-Bar.Style, and Boss-Bar.Cooldown-Message.

Placeholders

1. {NAME} The cosmetic's display name Action bar & boss bar
2. {TIME_LEFT} Seconds remaining on the cooldown Action bar & boss bar
3. {COOLDOWN_BLOCK} The rendered Remain/Retain block bar Action bar only

What to take note of

1. 1.8 servers: Boss bars don't exist on 1.8. If you set BOSS_BAR there, it falls back to the action bar automatically.
2. Invalid values fall back safely. A typo in Display-Type, Color, or Style won't error—it uses the default (ACTION_BAR / PURPLE / SOLID).
3. {COOLDOWN_BLOCK} only works in the action bar. The boss bar uses its own fill instead, so leave it out of Boss-Bar.Cooldown-Message.
4. Set Enabled: false to turn the whole cooldown notification off regardless of display type.

Click to expand...

• Fixed an issue where pets were not working on Paper 26.2 servers.

Click to expand...