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

• Added 26.2 support (Beta)

Click to expand...

• Update CoinsEngine dependency to v2.7.0

Click to expand...