ItemMagnet

Tiered item magnets with redstone fuel, smart filters, visible pull physics, and claim-aware protection.

Pull dropped loot toward you with magnets that feel physical — items slide around corners and stop at walls. Charge them with redstone, respect Lands and WorldGuard claims, filter what you collect, and tune everything from an admin GUI or config.yml.

Website: theryn.org/itemmagnet · GitHub: MCTheryn/item-magent

Why ItemMagnet?

Most magnet plugins teleport items through blocks or ignore land claims. ItemMagnet is built for survival SMPs that care about fairness and polish:

Visible physics — step-based pull with line-of-sight; no phasing through walls
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; blocks trigger a radius boost
Admin-friendly — /itemmagnet config GUI, presets, hot reload, LuckPerms-ready permissions, audit log
Production storage — player filters in YAML, SQLite, or MySQL

Gameplay

Three tiers — Fragment, Survey, Anchor
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
Vertical reach — pull items above/below you within tier radius

Filters

Server material + tag blacklist — config and admin GUI
Personal filter GUI — /itemmagnet filter
Built-in presets with merge preview/confirm
YAML, SQLite, or MySQL player filter storage

For server owners

/itemmagnet config — in-game editor
Server presets — theryn, skyblock, vanilla-survival, hub-spawn, testing
Anti-AFK, unlock gates, proximity lore, config audit log
Update checker — console banner on boot + clickable in-game download link

Integrations (all optional)

Lands, WorldGuard, Towny, GriefPrevention, Residence, PlotSquared, SuperiorSkyblock2, CMI, LuckPerms, mcMMO, Quests, PlaceholderAPI. Developer API included.

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

Quick start

Download ItemMagnet-1.6.6.jar from GitHub Releases
Place the JAR in plugins/ and restart
/itemmagnet give YourName fragment 500
Hold the magnet; sneak + right-click with redstone to fuel
Drop items nearby — they pull toward you with visible motion

Privacy & external services

ItemMagnet is transparent about outbound network usage. Server owners can disable or limit each feature in config.yml.

bStats (optional telemetry)

When metrics.bstats-enabled is true, ItemMagnet sends anonymous aggregate statistics to bStats. Reports include config toggles (integrations enabled, hold mode, filter storage backend, tier count, etc.) and session-level blocked-pull reason totals. No player names, UUIDs, locations, or chat are sent. Disable with metrics.bstats-enabled: false or globally in plugins/bStats/config.yml.

Update checker (optional)

When metrics.update-check is not DISABLED, ItemMagnet makes a read-only HTTPS request to the GitHub Releases API to compare your installed version against the latest tag. Requests run asynchronously with 5-second connect/read timeouts, send only a plugin version in the User-Agent, and parse only the release tag. Update messages appear in the console and to players with itemmagnet.updates (default: op). Disable with metrics.update-check: DISABLED.

Security practices

Permission-gated commands — admin, give, config, import, and debug require explicit permissions
Granular config GUI access — optional itemmagnet.config.* nodes; help/tab completion filtered by permission
Claim & region respect — optional protection hooks; bypass permissions default to false
Fair pull physics — line-of-sight movement; no teleport-through-blocks
Config audit log — admin changes logged to plugins/ItemMagnet/config-audit.log
SQL filter storage — parameterized queries for SQLite/MySQL backends
Optional integrations only — soft dependencies; runs standalone on Paper

Links

MIT License.

ItemMagnets

1.6.6

1.6.1

1.2.1