[hr][/hr]
ItemMagnet is a Paper plugin built for survival SMPs. Pull dropped loot with line-of-sight physics — items slide around corners and stop at walls instead of phasing through blocks. Fuel resonators with redstone, respect land claims, and tune everything from an in-game config GUI or YAML.
[hr][/hr]
Why ItemMagnet?

• Visible physics — step-based pull with line-of-sight; no wall clipping
• Claim-aware — Lands, WorldGuard, Towny, GriefPrevention, Residence, PlotSquared, SuperiorSkyblock2
• Smart filters — server + personal blacklists, Minecraft tag rules, tier whitelists, presets with preview/confirm
• Redstone fuel loop — dust and blocks recharge the magnet; redstone blocks trigger a radius boost
• Admin-friendly — /itemmagnet config GUI, hot reload, presets, LuckPerms-ready permissions
• Production storage — player filters in YAML, SQLite, or MySQL

Gameplay

• Three configurable tiers (Fragment, Survey, Anchor) with recipes and unlock gates
• Hold modes: main hand, hotbar, or inventory
• Optional XP orb pulling
• Live lore: charge, boost, and current pull radius
• Sneak + right-click fuel or auto-absorb redstone drops

Filters

• Server material + tag blacklist (config + admin GUI)
• Personal filter GUI — /itemmagnet filter
• Built-in presets (mining, farming, mob-drops, keep-valuables) with merge preview
• /itemmagnet filter clear and import commands
• YAML, SQLite, or MySQL storage for player filter data

Integrations (optional)
Lands · WorldGuard · Towny · GriefPrevention · Residence · PlotSquared · SuperiorSkyblock2 · CMI · LuckPerms · mcMMO · Quests · PlaceholderAPI · Developer API
[hr][/hr]
Requirements

• Paper 1.21.1+ (Java 21+)
• Tested on Paper 1.21.1, 1.21.4, 26.1
• Not supported: Spigot, CraftBukkit, Folia

Quick start

1. Drop the JAR in plugins/ and restart
2. /itemmagnet give <player> fragment 500
3. Hold the magnet, sneak + right-click with redstone dust to fuel
4. Drop items nearby — they pull toward you with visible motion

[hr][/hr]
Website · GitHub & docs · Hangar
License: MIT