Paper plugin · v1.2.1
Pull loot with magnets that feel real
Tiered item magnets with redstone fuel, visible pull physics, and claim-aware protection. Tune tiers, fuel, and integrations from an in-game config GUI or YAML.
Paper 1.21.1+ · Java 21+
In-game
See it in action
Gameplay demos and screenshots from Paper 1.21 on the Theryn test server — pull physics, config GUI, tier lore, and commands.
Why ItemMagnet
Built for survival SMPs
Most magnet plugins teleport items through blocks or ignore land claims. ItemMagnet respects protection plugins, uses visible pull physics, and gives server owners full control without editing YAML for every tweak.
Visible physics
Items slide around corners and stop at walls — step-based pull with line-of-sight, not teleport-through-blocks.
Claim-aware
Lands, WorldGuard, Towny, and GriefPrevention hooks keep magnets fair on protected SMPs.
Redstone fuel loop
Dust and blocks recharge your resonator. Redstone blocks trigger a power surge — extra charge and temporary radius boost.
Admin-friendly
/itemmagnet config GUI, presets, hot reload, LuckPerms-ready permissions, and a developer API.
Gameplay
For players
- Three tiers — Fragment, Survey, Anchor (materials, names, radius, recipes all configurable)
- Hold modes — main hand, hotbar, or anywhere in inventory
- XP orb pulling at the same radius (optional)
- Sneak + right-click fuel (either hand) or auto-absorb redstone drops
- Power surge from redstone blocks — charge + temporary radius boost
- Live item lore — charge, boost timer, and current pull radius
- Per-fuel recharge sounds; pull, depleted, and denied cues
Administration
For server owners
- /itemmagnet config — in-game editor for settings, tiers, fuel, and integrations
- Rename tier display names from the GUI (chat input, & color codes)
- Presets — theryn, testing, or roll your own
- World blacklist/whitelist filter for hub and spawn worlds
- Anti-AFK movement check with one-time notify
- Unlock gates — permission, advancement, CMI stat/rank, or admin command
Integrations
Works with your stack
Every integration is optional. ItemMagnet runs standalone on Paper with no extra plugins required.
Lands
Wilderness, owner, member, and flag-based modes
WorldGuard
Region whitelist/blacklist and item-pickup flag
Towny
Town plot protection
GriefPrevention
Claim respect
PlaceholderAPI
Charge, radius, tier, and boost placeholders
Developer API
Cancellable pull, fuel, deplete, and XP events
Quick start
Up and running in minutes
- 1Download ItemMagnet-1.2.1.jar from GitHub Releases or Hangar
- 2Place the JAR in your server's plugins/ folder and restart
- 3Give yourself a magnet: /itemmagnet give YourName fragment 500
- 4Hold the magnet; put redstone dust in your other hand; sneak + right-click to fuel
- 5Drop items nearby — they pull toward you with visible motion
Optional: run /itemmagnet config to open the in-game editor.
Requirements
Compatibility
| Server | Paper 1.21.1 or newer (required) |
|---|---|
| Java | 21 or newer |
| Tested on | Paper 1.21.1, 1.21.4, 26.1 |
| Not supported | Spigot, CraftBukkit, Folia |
Paper is required — the plugin uses the Paper API and modern interact handling for fuel transfer. Paper is a drop-in replacement for Spigot on most hosts.
Reference
Commands
Base command: /itemmagnet — aliases /im, /magnet
| Command | Permission | Description |
|---|---|---|
| /itemmagnet | — | Show help (filtered by permission) |
| /itemmagnet reload | itemmagnet.reload | Hot-reload config and messages |
| /itemmagnet config | itemmagnet.config | Open in-game config editor |
| /itemmagnet give <player> <tier|all> [charge] | itemmagnet.give | Give a resonator |
| /itemmagnet giveall <player> [charge] | itemmagnet.give | Give all tiers at once |
| /itemmagnet unlock <player> <tier|all> | itemmagnet.unlock | Unlock a tier recipe |
| /itemmagnet debug | itemmagnet.debug | Stats for your active magnet |
| /itemmagnet version | itemmagnet.admin | Version and hook status |
LuckPerms
Key permissions
| Node | Default | Purpose |
|---|---|---|
| itemmagnet.use | true | Use magnets |
| itemmagnet.use.<tier> | true | Per-tier use (fragment, survey, anchor) |
| itemmagnet.wilderness | op | Use in Lands/Towny wilderness |
| itemmagnet.admin | op | Reload, give, unlock, config, version |
| itemmagnet.bypass.lands | false | Skip Lands checks |
| itemmagnet.bypass.regions | false | Skip WorldGuard region lists |
Get ItemMagnet
Download & documentation
ItemMagnet is free and open source under the MIT license. Grab the latest JAR, read the full docs on GitHub, or install from Hangar.
Help
Request support
Running into a bug or need help configuring ItemMagnet? Send us the details — include your Paper version and plugin version if you can. You can also open a GitHub issue.