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

Quick start

1. Download ItemMagnet-1.6.6.jar from GitHub Releases
2. Place the JAR in plugins/ and restart
3. /itemmagnet give YourName fragment 500
4. Hold the magnet; sneak + right-click with redstone to fuel
5. 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

• Product page
• GitHub Releases
• Documentation
• Report a bug

MIT License.