🧲 MagnetEnchant — Item & Block Drop Attraction Enchantment

MagnetEnchant adds a brand-new, survival-friendly custom enchantment called Magnet to Paper and Purpur servers! With Magnet equipped, dropped items and mined blocks are smoothly drawn towards the player within a configurable radius.

✨ Features

• 🧲 Custom Magnet Enchantment:
  • Magnet I: 5-block radius attraction.
  • Magnet II: 8-block radius attraction.
  • Magnet III: 12-block radius attraction.
  • Can be applied to Tools (Pickaxes, Axes, Shovels, Hoes, Swords) and/or Armor (Boots, Leggings, Chestplate, Helmet).
• 🛡️ Smart Safety Controls:
  • Inventory Space Check: Only pulls items if the player has free space for them, preventing clutter.
  • Sneak Bypass: Pauses item attraction when sneaking (Shift), allowing players to trade or toss items to friends.
  • Player Toggle: Anyone can toggle their magnet on/off anytime using /magnet toggle.
  • Instant Block Break Pickup: Optional setting to instantly transfer mined block drops into inventory.
• ✨ Smooth Visuals & Audio:
  • Items travel along a natural physics curve with zero pickup delay.
  • Optional portal/enchant particle trails and pickup sound effects.
• 🗺️ Complete Survival Integration:
  • Enchanting Table: Naturally obtainable when enchanting gear or books.
  • Villager Trades: Librarians can offer Magnet books.
  • Dungeon & Structure Loot: Found in dungeon chests, mineshafts, ancient cities, bastion remnants, etc.
  • Fishing: Rare treasure catch while fishing.
  • Piglin Bartering: Chance from trading gold ingots with Piglins in the Nether.
  • Survival Crafting Recipe: 1 Book in the center + 4 Iron Ingots + 4 Redstone = Enchanted Book (Magnet I).
  • Anvil & Grindstone: Combine books to level up (I + I = II, II + II = III) or grindstone away.

📜 Commands & Permissions

⚙️ Configuration (config.yml)

magnet:
  # Tick interval for magnet scans (20 ticks = 1 second)
  tick-interval: 3

  # Pause pulling when sneaking
  disable-while-sneaking: true

  # Only pull if inventory space is available
  only-pull-if-inventory-space: true

  # Where to check for the enchantment
  check-main-hand: true
  check-off-hand: true
  check-armor: true

  # Block break behaviors
  pull-drops-on-block-break: true
  instant-block-break-pickup: false

# Radii and attraction speeds
levels:
  1:
    radius: 5.0
    speed: 0.45
  2:
    radius: 8.0
    speed: 0.65
  3:
    radius: 12.0
    speed: 0.85

effects:
  sound:
    enabled: true
    type: "ENTITY_ITEM_PICKUP"
    volume: 0.4
    pitch: 1.3
  particles:
    enabled: true
    type: "PORTAL"

📦 Installation

1. Download MagnetEnchant-1.0.1.jar.
2. Drop it into your server's plugins/ directory.
3. Restart or reload your server (/reload confirm).