Kaucja v6.0.0 — The Mega Polish Update

A massive production-quality overhaul inspired by real Polish bottle deposit systems (Lidl, Biedronka, Kaufland, Carrefour, Żabka). This update adds 22 new bottle types, 5 machine upgrades, a machine tier system, deposit streak bonuses, machine statistics, 11 new sounds, expanded configuration, and major code quality improvements.

🍾 NEW BOTTLE TYPES (22 items)

Inspired by real-life bottles found in Polish stores:

Premium Bottles (2× deposit value)

• Premium Glass Bottle — Gold-trimmed glass bottle, craftable with Empty Bottle + Gold Nugget
• Premium Plastic Bottle — Gold-trimmed plastic bottle
• Premium Aluminium Can — Gold-trimmed can

Imported Bottles (3× deposit value)

• Imported Glass Bottle — Distinctive shape, higher deposit value
• Imported Can — Foreign brand can

Collectible Bottles (5× deposit value, epic rarity)

• Collectible Gold Bottle — Solid gold bottle, extremely rare
• Collectible Crystal Bottle — Crystal-cut glass bottle
• Collectible Vintage Bottle — Aged vintage bottle with cork

Lucky Bottle (1×–10× random deposit value)

• Lucky Bottle — Rainbow shimmer bottle. Deposit value is random each time!

Broken/Crushed Bottles (0.25× deposit value)

• Broken Glass Bottle — Shattered, worth much less
• Crushed Aluminium Can — Flattened can
• Crushed Plastic Bottle — Compressed bottle

Reusable Bottles (2× deposit value)

• Reusable Glass Bottle — Sturdy, thick glass. Worth more because they're returnable
• Reusable Plastic Bottle — Heavy-duty plastic, designed for reuse

Fake/Counterfeit Bottles (0 deposit value, detection risk)

• Fake Glass Bottle — Looks like a real bottle but deposits for nothing. May be detected!
• Fake Aluminium Can — Counterfeit can. Risk of police suspicion when deposited

Beer Bottles (1.5× deposit value)

• Beer Bottle — Standard beer bottle, brown glass
• Craft Beer Bottle — Premium craft beer, worth 2× deposit

Other Returnables

• Juice Carton — Paper-based juice carton (like in real stores!)
• Returnable Milk Bottle — Glass milk bottle designed for return

Golden Bottle (10× deposit value, extremely rare)

• Golden Bottle — The ultimate collectible. Worth 10× the normal deposit!

🔧 MACHINE UPGRADE SYSTEM (5 upgrades)

Apply upgrades to deposit machines for enhanced performance:

🏗️ MACHINE TIER SYSTEM (5 tiers)

Deposit machines now come in 5 tiers (for future block variants):

📈 DEPOSIT STREAK SYSTEM

Inspired by loyalty programs at Biedronka and Lidl:

• 5 consecutive deposits (within 60s) = +5% bonus
• 10 consecutive deposits = +10% bonus
• 25 consecutive deposits = +25% bonus
• 50 consecutive deposits = +50% bonus
• 100 consecutive deposits = One-time 100% bonus (Mega Streak!)

Streak resets if no deposit is made within 60 seconds.

📊 MACHINE STATISTICS

Deposit machines now track lifetime statistics:

• Total bottles deposited
• Total money paid out
• Bottles by material (glass/aluminium/plastic/special)
• Machine jams count
• Machine cleans count
• Uptime in ticks
• Average bottles per minute
• Average income per bottle

🔊 NEW MACHINE SOUNDS (11 sounds)

Realistic RVM-inspired sound effects:

⚙️ EXPANDED CONFIGURATION

New config sections in kaucja-common.toml:

[machines]

• depositMachineCooldown — Cooldown between deposits (default: 0)
• shopCooldown — Cooldown between purchases (default: 0)
• rvmBulkBonusPercent — RVM bulk bonus (default: 5%)
• coinMintFeePercent — Coin Mint fee (default: 0%)
• composterOutputChance — Composter output chance (default: 1 in 8)
• recyclingBinEfficiencyPercent — Recycling Bin efficiency (default: 75%)

[bottle_filter]

• whitelistEnabled — Only allow whitelisted bottles to be deposited (default: false)
• whitelist — Comma-separated list of allowed item IDs
• blacklistEnabled — Block blacklisted bottles from deposit (default: false)
• blacklist — Comma-separated list of blocked item IDs

📝 CODE QUALITY IMPROVEMENTS

• Added comprehensive JavaDoc to the main Kaucja class
• Created MachineTier enum for tier-based machine logic
• Created MachineUpgrade enum for upgrade system
• Created MachineStats class for lifetime statistics tracking
• Created DepositStreak class for streak bonus logic
• Created ModBottleTypes class to centralize bottle type registration
• Created ModSoundsV6 for new sound event registration
• Added deposit multiplier system (getDepositMultiplier()) for special bottles
• Added isSpecialBottle() helper for checking depositable items

📦 DELIVERABLES

• Kaucja-6.0.0.jar (5.0 MB)
• Kaucja-6.0.0-src.zip (5.7 MB)

🔄 COMPATIBILITY

• Minecraft: 1.20.1
• Forge: 47.2.0+ (tested on 47.4.10)
• Create: Optional, 0.5.1+ through 6.0.8
• Java: 17

🎯 WHAT'S NEW SUMMARY

Enjoy the update! 🍾🇵🇱