Item Crusher + v1.3

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

The Problem That's Costing You Players

Your players accumulate tons of damaged tools, unwanted armor, and useless items. They have no efficient way to process them. Either they sell everything at fixed prices to NPCs, or they simply throw it into lava. The result? Blocked resource circulation, lack of immersion, player frustration.

Competing servers already give players control over recycling. You're losing competitive advantage every day without this system.

The Premium-Class Solution

PuffCrusher isn't another "basic recycling plugin". It's a comprehensive economic system designed by a developer with experience building premium servers. Two operating modes (materials or money), intelligent bonus system, bulk processing with queue, and advanced performance architecture.

This is a plugin that increases player retention by giving them real control over the value of their items.



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

Features That Build Value

Bulk Processing Queue System
Players can queue up to 100 items for bulk processing. System processes 5-64 items per second with progress bar, sounds, and particle effects. This isn't instant recycling. This is an immersive process that gives players a sense of value.
Business value: Increases engagement through long-term resource planning.

Intelligent Bonus System
Not fixed values, but a dynamic calculator:

• Pristine Bonus: +15% for items in 100% condition
• Full Set Bonus: +25% for processing complete armor set
• Rare Enchant Bonus: 2x reward for Mending, Unbreaking III+
• Enchantment Scaling: Intelligent valuation of each enchant (Protection IV = more than 4x Protection I)
• Durability Impact: Damaged items yield proportionally fewer resources

Business value: Players maximize processing strategy instead of mindlessly clicking. This builds long-term engagement.

Dual Mode Economy Integration
Two operating modes in one plugin:

• Materials Mode: Recover raw materials (diamonds, iron, netherite) with enchantment bonuses
• Money Mode: Direct sale for cash via Vault (configurable prices per material)

Switch modes in GUI. One item, two applications. Zero friction for the player.
Business value: Economic flexibility. Survival/SMP uses materials, economy servers use money mode.

Advanced VIP Cooldown System
Full control over recycling monetization:

• Default: 3 seconds cooldown
• VIP1/VIP2/VIP3: configurable (default 120s/60s/30s)
• MVP/MVP+: premium tiers (15s/10s)
• Admin bypass: zero cooldown
• Unlimited custom tiers via permissions

Each tier has its own permission node. Adding another VIP rank? One line in config.yml.
Business value: Instant upsell mechanism. Players see the difference between free and VIP in real-time.

Special Items Processing
Not just armor and tools:

• Enchanted Books: Break down into paper + XP bottles (proportional to enchant level)
• Potions: Return glass bottle + 30% chance for ingredient return
• Bundles: Return contents + 80% chance for rabbit hide

Every item in the game has recycling value. Zero dead-end inventory clutter.
Business value: Increases perceived value of the entire loot system on your server.

Netherite Rebalancing
Individually scaled values for each netherite piece (helmet 900$, chestplate 1200$, sword 850$) instead of one fixed price. Precise reflection of crafting costs.
Business value: Economic balance at end-game content level.

Performance Architecture
Built-in performance safety:

• Enchantment calculation cache (1000 entries, 30min expire)
• Max 3 players processing simultaneously (configurable)
• Chunk processing (16 items per batch)
• Auto-save queue every 30s
• Queue timeout for stale items (1h)

Zero lag even with 100+ players online.
Business value: You don't risk your server's stability.

Multi-Language Support
Built-in: Polish, English. Custom language files via .yml in lang/ folder. All messages, GUI titles, lore fully configurable.
Business value: One plugin for international networks or local communities.

Visual & Audio Feedback
Not a silent backend system. Every processing has:

• 2-second animation (configurable)
• ANVIL sound every 0.5s during processing
• SMOKE_LARGE particles
• Progress bar for bulk processing
• PLING sound per progress update
• HAPPY_VILLAGER particles on completion

Business value: Immersion = retention. Players feel the value of every action.

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

Why This Works Better Than Competition

1. Enterprise-Grade Architecture
While other plugins use simple if/else blocks, PuffCrusher has:

• AdvancedBonusCalculator with multi-condition stacking
• EnchantmentValueCalculator with intelligent scaling
• PersistentQueueManager with auto-save and crash recovery
• ConfigValidationManager with startup validation
• CooldownManager with priority-based permission selection

This isn't a hobby project. This is production code built according to Paper API best practices.

2. Zero Manual Balancing
Every value is configurable, but defaults are already balanced based on vanilla crafting recipes and economy simulations. Install, maybe edit 3 values in config.yml and it works out-of-the-box.

3. Built for Scale
Cache system, concurrent processing limits, chunk-based batch processing. This plugin is tested on 100+ player servers. You won't find memory leaks, deadlocks, or lag spikes.

4. Premium Documentation
Every feature explained in README.md. Every config key has a comment. Language files with examples. This isn't "check the source code". This is "everything is clear in 5 minutes".

5. Vault Optional, Not Required
Want to use only materials mode? Vault isn't needed. Plugin detects availability and disables money mode automatically. Zero dependency errors.

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

Who Is PuffCrusher For

Survival/SMP Server Owners
Give players control over recycling their worn tools and armor. Increase immersion through a realistic item value system.

Economy/Skyblock Networks
Vault integration enables instant monetization of recycling. VIP tiers with cooldown reduction = natural upsell funnel.

RPG/Custom Content Servers
Configurable material values and bonuses allow you to match recycling to custom economy balance. Special items processing works with modded items.

Network Owners Seeking Competitive Advantage
If your competitor has basic recycling and you have PuffCrusher with bulk processing and conditional bonuses, players see the quality difference from minute one.

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

Technical Requirements

• Minecraft: Paper 1.21.4+ (no Spigot support)
• Java: 21+
• Optional: Vault (for money mode)
• Soft-depend: PlugMan (hot reload support)

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


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