Paper plugin · v1.6.6
Pull loot with magnets that feel real
ItemMagnet is a Paper plugin for survival SMPs. Pull dropped loot with line-of-sight physics, fuel resonators with redstone, filter what you collect with server and personal rules, respect land claims, and tune everything from an in-game config GUI.
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, vertical reach, and horizontal-first ledge handling — not teleport-through-blocks.
Claim-aware
Lands, WorldGuard, Towny, GriefPrevention, Residence, PlotSquared, and SuperiorSkyblock hooks keep magnets fair on protected SMPs.
Smart filters
Server and personal blacklists, Minecraft tag rules, tier whitelists, built-in presets with merge preview, and YAML/SQLite/MySQL storage.
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, hot reload, update checker with in-game download link, server presets, LuckPerms-ready permissions, audit log, 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)
- Vertical reach — pull items within horizontal radius even when above or below you
- Horizontal-first pull mode — slides on X/Z before Y so ledges and floor offsets do not block pulls
- 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, integrations, item filter, and proximity lore
- Rename tier display names from the GUI (chat input, & color codes)
- Server presets — theryn, skyblock, vanilla-survival, hub-spawn, testing, or custom
- World blacklist/whitelist filter for hub and spawn worlds
- Anti-AFK movement check with one-time notify
- Unlock gates — permission, advancement, CMI stat/rank, LuckPerms group, mcMMO skill, Quests, or admin command
- Proximity lore — optional coordinate zones with ambient messages (default off)
- Update checker — console banner, online admin notify, clickable in-game download link
- Config audit log — plugins/ItemMagnet/config-audit.log
Filters
Control what your magnet pulls
Server-wide rules, personal opt-outs, Minecraft tag blacklists, and tier whitelists — with preset merge preview and YAML, SQLite, or MySQL storage for large networks.
- Server material + tag blacklist — config and admin GUI (Materials | Tags views)
- Personal filter GUI — /itemmagnet filter with server rules read-only at the top
- Built-in presets — mining, farming, mob-drops, keep-valuables with merge preview/confirm
- /itemmagnet filter clear — wipe personal rules; /itemmagnet import for bulk merge
- Player filter storage — YAML (default), SQLite, or MySQL with one-time YAML migration
- Tier whitelist/blacklist and tag rules per magnet tier
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 (7.26.x)
WorldGuard
Region whitelist/blacklist and item-pickup flag (7.0.16+)
Towny
Town plot protection (0.103.x)
GriefPrevention
Claim respect (16.18.7 Legacy)
Residence
Residence claim and itempickup flags (6.0.x)
PlotSquared
Plot membership checks (6.11.x)
SuperiorSkyblock2
Island permission hook
CMI
Stat/rank unlock gates; optional progress on blocked pulls (9.8.x)
LuckPerms
LP_GROUP unlock type for tier recipes
mcMMO
MCMMO_SKILL level unlock gates
Quests
Quest-complete tier unlocks; optional progress on blocked pulls (5.2.9)
PlaceholderAPI
Charge, radius, tier, boost, and filter count placeholders (2.12.2)
Developer API
grantUnlock, giveMagnet, pull/blocked events, hook status
Quick start
Up and running in minutes
- 1Download ItemMagnet-1.6.6.jar from GitHub Releases
- 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
- 6Optional: /itemmagnet filter for personal filters, /itemmagnet config for admin tuning
Optional: /itemmagnet filter for personal filters, /itemmagnet config for admin tuning.
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 filter | itemmagnet.filter | Personal item filter GUI |
| /itemmagnet filter clear | itemmagnet.filter | Clear personal filter rules |
| /itemmagnet give <player> <tier|all> [charge] | itemmagnet.give | Give a resonator |
| /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, hook status, and pending update info |
LuckPerms
Key permissions
| Node | Default | Purpose |
|---|---|---|
| itemmagnet.use | true | Use magnets |
| itemmagnet.filter | true | Personal filter GUI, clear, and import |
| 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 from GitHub Releases or read the full docs on GitHub.
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.