ItemMagnet — Tiered Item Magnets, Redstone Fuel, Claim Prote

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

[HEADING=2]Why ItemMagnet?[/HEADING]
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

[HEADING=2]Gameplay[/HEADING]

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

[HEADING=2]Filters[/HEADING]

• 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

[HEADING=2]For server owners[/HEADING]

• /itemmagnet config — in-game editor for settings, tiers, fuel, integrations, item filter, and proximity lore
• Server presets — theryn, skyblock, vanilla-survival, hub-spawn, testing, or custom
• Anti-AFK movement check with one-time notify
• Unlock gates — permission, advancement, CMI stat/rank, LuckPerms group, mcMMO skill, Quests, or admin command
• Update checker — console banner on boot, clickable in-game download link for admins

[HEADING=2]Integrations (all optional)[/HEADING]
Lands, WorldGuard, Towny, GriefPrevention, Residence, PlotSquared, SuperiorSkyblock2, CMI, LuckPerms, mcMMO, Quests, PlaceholderAPI. Developer API included.

[HEADING=2]Compatibility[/HEADING]

• 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

[HEADING=2]Quick start[/HEADING]

1. Download ItemMagnet-1.6.6.jar from GitHub Releases
2. Place the JAR in your server's plugins/ folder and restart
3. Give yourself a magnet: /itemmagnet give YourName fragment 500
4. Hold the magnet; put redstone dust in your other hand; sneak + right-click to fuel
5. Drop items nearby — they pull toward you with visible motion

[HEADING=2]Privacy & external services[/HEADING]
ItemMagnet is transparent about outbound network usage. Server owners can disable or limit each feature in config.yml.

[HEADING=3]bStats (optional telemetry)[/HEADING]
When

metrics.bstats-enabled

is true, ItemMagnet sends anonymous aggregate statistics to bStats — the standard metrics service used by many Paper plugins. 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

.

[HEADING=3]Update checker (optional)[/HEADING]
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 server console and to players with

itemmagnet.updates

(default: op). Disable with

metrics.update-check: DISABLED

.

[HEADING=3]Security practices[/HEADING]

• 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

[HEADING=2]Links[/HEADING]

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

MIT License.