More Consumables - Eat Everything v1.0

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The Problem Limiting Your Server's Potential

Every Minecraft server uses the same food system. Bread, steak, golden apples. Players know exactly what to expect because they've eaten the same items on every server for years. Your custom RPG progression, economy balancing, or survival mechanics all hit the same wall: vanilla food limitations.

You need items that do more than restore hunger. You need consumables that integrate with your economy, grant temporary powers, cost money to use, or unlock based on player progression. You need items that feel unique to your server.

The System That Breaks Those Limits

MoreConsumables transforms any Minecraft material into a consumable item with completely custom effects. Turn diamonds into healing items that cost $500 and grant Resistance. Make bamboo a speed boost consumable locked behind VIP permissions. Create mushrooms that give night vision with a 5-minute cooldown.

This isn't a food replacement plugin. It's a consumption mechanics framework that gives you full control over what players can eat, when they can eat it, what it costs, and what effects it provides.




━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Features That Create New Gameplay

Universal Item Consumption
Any Minecraft material becomes consumable. Diamonds, iron, bamboo, concrete, flowers, prismarine. No limitations. If it's in the Material enum, you can make it edible.
Business value: Zero artificial restrictions on your creative vision for custom content.

Advanced Effect Stacking System
Each consumable supports unlimited potion effects with:

• Individual duration and amplifier control
• Probability-based effect application (30% chance for Regeneration, 100% for Speed)
• Effect stacking and conflict resolution
• Custom particles and sounds per item

Business value: Create complex consumables that behave differently each time, increasing replayability.

Economy Integration That Works
Vault integration isn't optional. Each consumable can cost money to use. Players see the price before consuming, transaction happens atomically, and insufficient funds prevents consumption with custom error messages.
Business value: Instant monetization mechanism for consumables. "Premium healing items" become a natural money sink.

Per-Item Cooldown System
Independent cooldowns for each consumable type:

• Cooldowns persist across server restarts
• Real-time countdown display in GUI
• Configurable cleanup intervals for performance
• Bypass permissions for VIP ranks

Business value: Prevents consumable spam while allowing strategic timing decisions. Players value items more when they can't spam them.

Interactive Browse GUI
Players don't memorize consumable IDs. They open a clean inventory menu that shows:

• All available consumables with custom icons
• Effect descriptions and durations
• Current cooldown status
• Economy cost display
• One-click consumption
• Permission-filtered display (players only see what they can use)

Business value: Discovery mechanism. Players find consumables they didn't know existed, increasing usage.

Granular Permission Control
Per-consumable permissions with inheritance support:

• moreconsumables.consume.DIAMOND = access to diamond consumable
• moreconsumables.consume.* = access to all
• moreconsumables.bypass.cooldown = ignore cooldowns
• Permission-based economy cost multipliers

Business value: VIP consumables become a sellable perk. Rank progression unlocks new food types.

World & Region Restrictions
WorldGuard integration for spatial control:

• Per-world blacklist/whitelist
• Region-based disable zones
• Combat prevention in safe zones
• Custom restriction messages

Business value: Prevents consumable abuse in PvP arenas, spawn protection, or event areas.

XP Level Requirements
Consumables can require minimum XP levels:

• Players below level requirement see error message
• Encourages grinding before accessing powerful consumables
• Configurable per-item
• Bypass permissions for donors

Business value: Progression gating. End-game consumables feel earned, not purchased.

NBT Custom Item Support
Works with items that have custom NBT data:

• Strict NBT matching mode for exact item checks
• Loose matching for base material consumption
• Custom model data support
• Glowing effect toggle

Business value: Integrates with custom item plugins. Your resource pack items become consumables.

Statistics & Analytics
Track consumable usage per player:

• Total consumptions per type
• Most used consumables
• Player-specific consumption history
• Leaderboard support via PlaceholderAPI

Business value: Data-driven balancing. See which consumables are overpowered or underused.

Multi-Language Architecture
Built-in Polish and English with YAML-based language system. Every message is translatable. Add custom languages by creating new .yml files in lang/ folder.
Business value: One plugin for international networks. No English-only limitation.

Performance Optimization
Built for scale:

• Consumable data caching (5-minute expiry)
• Cooldown cleanup intervals (configurable)
• Async economy transactions
• Lazy loading of GUI components
• No memory leaks on player disconnect

Business value: Works smoothly on 200+ player servers without lag spikes.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why This Beats Custom Coding

1. Production-Ready Architecture
While building this yourself means weeks of debugging edge cases, MoreConsumables ships with:

• ConsumableItem model with validation
• ConsumptionHandler with safety checks
• CooldownManager with persistence
• StatisticsManager with async storage
• ConfigManager with error reporting
• GUI framework with update loops

This is enterprise-grade code, not a hobby script.

2. Configuration Without Code Changes
Every consumable is defined in YAML. Want to add 50 new items? Edit one file, reload, done. No recompilation, no Git commits, no deployment pipeline.

3. Integration Layer Included
Vault, PlaceholderAPI, WorldGuard integrations are already written, tested, and maintained. You don't hunt down API changes or fix compatibility breaks.

4. Full Documentation Included
README with examples, config templates, permission list, command reference. EXAMPLES.md with 10+ pre-built consumable configurations. DEVELOPER.md for extending the plugin.

5. Active Maintenance
Paper API updates? Handled. Minecraft version compatibility? Maintained. Bug reports? Fixed. You buy a plugin that stays current.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Who Needs MoreConsumables

RPG/Fantasy Servers
Potions from alchemy ingredients. Mana drinks from lapis. Health elixirs from diamonds. Each consumable type represents a crafted resource in your custom economy.

Prison/Economy Servers
Temporary buff items sold in shops. Speed boosts for 5 minutes = $500. Haste II for mining rushes = $1000. Consumables become premium purchases.

Survival/Hardcore Servers
Rare mushroom types with unique effects. Custom food that restores more hunger but costs XP. End-game consumables that require level 50 to use.

Skyblock/Custom Progression
Unlock new consumable types as islands expand. Early-game bamboo for weak effects, late-game nether stars for powerful buffs. Consumption tied to progression milestones.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Requirements

• Minecraft: 1.21.1+ (Paper/Spigot/Purpur)
• Java: 21+
• Optional: Vault (economy), PlaceholderAPI (stats), WorldGuard (regions)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━