MoreConsumables
Turn Any Item into Food. Vanilla Eat & Drink Animations Included.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Paper 1.21.4+ ◆ Eat & Drink Animations ◆ Unlimited Effects ◆ Custom Model Data ◆ Multi-Language
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What MoreConsumables Does
Most servers are stuck with vanilla food. Apples, steak, golden carrots. The same items everyone has used for a decade. You cannot make a diamond feel like a rare consumable. You cannot make a potion give four different effect combinations. You cannot make bamboo a viable snack.
MoreConsumables changes that. Right-click any item - bamboo, diamond, gold ingot, glowstone dust, even a glass bottle - and the player sees the native vanilla eat or drink animation. The item is consumed. Effects are applied. Sounds play. Particles spawn. All configured in a single YAML file.
This is not a workaround. It uses Paper's DataComponent API to inject the CONSUMABLE and FOOD components directly into the item stack. The client plays the real animation because it receives real, properly serialized data components. No ProtocolLib. No resource pack tricks. No fake animation packets.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Features
Core Features
◆ True Vanilla Animations
- EAT animation with food crumb particles for solid items
- DRINK animation with potion swirl particles for liquid items
- Works on any Minecraft material - diamond, gold, bamboo, glass, anything
- Uses Paper DataComponent API, not NMS reflection hacks
◆ Full YAML Configuration
- Every consumable configured in consumables.yml
- Hunger restoration, saturation, cooldown in seconds
- Eat sound, burp sound, particle type and amount
- Unlimited potion effects per item with probability support
- Economy cost (Vault), XP level requirement, permission node
- World and region restrictions (WorldGuard)
◆ Custom Items & Multiple Variants
- Create multiple consumable entries for the same material
- Three POTION variants in default config: 2-effect, 3-effect, 4-effect
- Distinguish items by NBT tag (custom-item-id)
- Custom Model Data support for resource pack textures
- Glow effect toggle for custom items
◆ Economy & Progression
- Vault economy integration: charge players per consumption
- XP level requirements to gate powerful items
- Per-item permission nodes
- World blacklist/whitelist mode
- WorldGuard region restrictions
◆ PlaceholderAPI
- %moreconsumables_total% - total consumables loaded
- %moreconsumables_cooldown_<material>% - remaining cooldown
- %moreconsumables_consumed_<material>% - times consumed
◆ GUI System
- /consumables gui opens a browsable menu of all configured items
- Click any item to see its effects, hunger, saturation, and cooldown
- Configurable rows and update interval
◆ Developer Friendly
- Reload command with automatic config backup
- Debug mode logs every injection, consumption, and event
- Clean, documented Java codebase
- Statistics tracking per player and per item
- Cooldown cleanup task prevents memory leaks
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Default Consumables
12 pre-configured items to get you started. All values are examples - change them to fit your server.
Default Consumables
12 pre-configured items to get you started. All values are examples - change them to fit your server.
| Item | Type | Effects |
| Bamboo | Eat | Speed I (4s) |
| Red Mushroom | Eat | Regeneration I (3s) |
| Brown Mushroom | Eat | Regen I (70%) or Nausea I (30%) |
| Diamond | Eat | Resistance + Regen + Absorption (10s) |
| Gold Ingot | Eat | Speed + Haste (10s) |
| Glowstone Dust | Eat | Night Vision (20s) + Glowing |
| Potion (3 effects) | Drink | Speed + Jump + Night Vision (20s) |
| Potion of Fire (CMD 1001) | Drink | Fire Resistance (20s) + Strength (15s) |
| Potion of Ultimate (CMD 1002) | Drink | Invis + Strength + Jump + Regen |
| Glass Bottle | Drink | Invisibility (15s) |
| Magma Cream | Drink | Fire Res (20s) + Strength (15s) |
| Nether Wart | Drink | Invis + Str + Jump + Regen |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Example Configuration
Example Configuration
Every value is documented. Adding a new consumable takes 30 seconds.
Code:
POTION_OF_FIRE:
material: POTION
hunger: 2
saturation: 1.5
cooldown: 30
eat-sound: "ENTITY_GENERIC_DRINK"
burp-sound: "ENTITY_PLAYER_BURP"
particle-type: "FLAME"
particle-amount: 14
economy-cost: 0.0
xp-requirement: 0
custom-item: true
custom-item-id: "potion_of_fire"
custom-model-data: 1001
consumption-type: "drink"
effects:
- type: "FIRE_RESISTANCE"
duration: 400
amplifier: 0
probability: 100.0
- type: "STRENGTH"
duration: 300
amplifier: 0
probability: 100.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands & Permissions
Commands & Permissions
| Command | Permission | Description |
| /consumables give <player> <material> [amount] | consume.give | Give a consumable to a player (preserves CMD) |
| /consumables list | consume.list | List all configured consumables |
| /consumables gui | consume.gui | Open the consumables browser GUI |
| /consumables stats | consume.stats | View your consumption statistics |
| /consumables reload | consume.reload | Reload config with automatic backup |
| /consumables help | consume.help | Show command help |
◆ Consumption Permissions
| Permission | Default | Description |
| consume.use.<material> | true | Allow consuming a specific item |
| consume.bypass.cooldown | false | Bypass all consumption cooldowns |
| consume.bypass.restrictions | false | Bypass world and region restrictions |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Technical Specs
Technical Specs
| Server | Paper 1.21.4+, Java 21 |
| Dependencies | None required. Vault, PlaceholderAPI, WorldGuard optional. |
| Languages | English, Polish. Add your own in /lang/ |
| Animation | Paper DataComponent API (CONSUMABLE + FOOD) |
| Custom Items | NBT tags, Custom Model Data, glow effect |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get MoreConsumables
Your server already has diamonds, gold, and potions.
Make them actually consumable - with real animations, configurable effects, and full balance control.
Any item. Real animation. Unlimited effects. One YAML file.
Drop it in, reload, and your players are eating diamonds.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get MoreConsumables
Your server already has diamonds, gold, and potions.
Make them actually consumable - with real animations, configurable effects, and full balance control.
Any item. Real animation. Unlimited effects. One YAML file.
Drop it in, reload, and your players are eating diamonds.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
