Frame Lucky Drop

About

A lightweight Paper plugin that adds a luck-based mechanic to Item Frames. When a player attacks an Item Frame, there is a configurable 5% chance the displayed item ejects onto the ground with double quantity, without breaking the frame. Features include per-player cooldown to prevent brute-forcing, creative mode exclusion, proper stack size handling for unstackable items, and silent failure on empty frames. Success triggers a ding sound and celebration particles. Chance percentage is configurable via ******.yml without recompiling. Uses EntityDamageByEntityEvent with cancellation to preserve the frame, ThreadLocalRandom for chance calculation, and World#dropItem for item ejection with a small random velocity pop effect.