MoreConsumables v1.1.0
Changelog
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What's New
◆ Real Vanilla Eat & Drink Animations
This is the big one. When a player right-clicks any configured item, they now see the actual Minecraft eating or drinking animation - complete with food crumbs, potion swirls, and the hand movement you know from vanilla. Diamonds crunch. Potions gulp. Bamboo... well, bamboo does whatever bamboo does.
This is not a fake animation or a resource pack trick. The plugin uses Paper's DataComponent API to give the item real CONSUMABLE and FOOD data, the same way vanilla food works. Your players' clients render the animation natively because the item genuinely becomes edible.
◆ Multiple Consumables on the Same Material
You can now create several different consumable entries that all use the same Minecraft item. Want three different POTION types? Done. One gives speed and jump boost, another gives fire resistance and strength, a third gives invisibility, strength, jump boost, and regeneration - all four at once. They are distinguished by NBT tags, so the plugin knows exactly which one the player is holding.
The default config ships with three POTION variants to show you how it works.
◆ Custom Model Data Support
Custom items can now carry a Custom Model Data value. If you have a resource pack with custom textures, set custom-model-data in your consumable entry and the item will render with that texture. The default config includes examples: Potion of Fire uses CMD 1001, Potion of Ultimate uses CMD 1002.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What Changed
◆ Full Balance Rework
All 12 default consumables have been rebalanced from the ground up. Key changes:
The goal: rare items feel powerful but not game-breaking. Common items give a small boost without replacing real food.
- Every item now has a cooldown - no more infinite eating
- Diamond cooldown: 90 seconds (down from "none" - it was way too strong)
- Nether Wart cooldown: 120 seconds (it gives four effects)
- Gold Ingot cooldown: 45 seconds
- All effect levels reduced to I (from II and III in some cases)
- Effect durations roughly halved across the board
◆ Sound Design Standardized
All EAT-type items now use ENTITY_GENERIC_EAT for the eating sound and ENTITY_PLAYER_BURP for the burp. All DRINK-type items use ENTITY_GENERIC_DRINK and the same burp. No more glass breaking sounds when you eat a diamond or beacon noises when you consume glowstone. Clean, consistent, vanilla-like.
◆ Paper 1.21.4+ Required
The plugin now requires Paper 1.21.4 or newer. This was necessary to use the DataComponent API for real animations. Older versions (1.21-1.21.3) are no longer supported. Java 21 is required.
◆ Under the Hood
- Rewrote the animation system from NMS reflection to the clean Paper DataComponent API - more reliable, no version-dependent hacks
- Added a 1-tick delay before starting the animation to guarantee the client receives the item data before the animation begins - fixes the "no animation" bug
- Consumption completion is now scheduled and forced if the vanilla timer misbehaves - fixes the "effects don't apply" bug
- Prevents duplicate consumption tasks when players hold right-click
- Debug mode now shows whether the CONSUMABLE component is visible to the client
- Config backup system added - automatic backup on every reload
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
New Config Fields
These fields were added to consumables.yml. Old configs will still work - all new fields are optional.
Field What It Does material Lets you specify the Minecraft item separately from the config name. Use this to create multiple entries for the same material. custom-model-data Sets a Custom Model Data value on the item, so resource packs can apply custom textures.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Upgrading from v1.0
- Server: You must be running Paper 1.21.4 or newer with Java 21.
- Config: Your existing consumables.yml will still load. The new material and custom-model-data fields are optional - nothing breaks if you do not add them.
- Balance: If you were using the default consumables, the cooldowns and effect levels have changed significantly. Review the new defaults and adjust to your server's needs.
- Sounds: Eat and burp sounds have been standardized. If you had custom sounds you liked, they will still be there - only the default examples changed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Enjoy! Your players are about to start eating diamonds.
Questions or suggestions? Reach out on our support channels.
