ItemMagnet — Tiered Item Magnets, Redstone Fuel, Claim Protection

ItemMagnet — Tiered Item Magnets, Redstone Fuel, Claim Protection -----

Pull items with visible physics. Redstone fuel, claim protection, in-game config GUI.

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]

Download ItemMagnet-1.6.6.jar from GitHub Releases
Place the JAR in your server's plugins/ folder and restart
Give yourself a magnet: /itemmagnet give YourName fragment 500
Hold the magnet; put redstone dust in your other hand; sneak + right-click to fuel
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

Code (Text):

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

Code (Text):

metrics.bstats-enabled: false

or globally in

Code (Text):

plugins/bStats/config.yml

.

[HEADING=3]Update checker (optional)[/HEADING]
When

Code (Text):

metrics.update-check

is not

Code (Text):

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

Code (Text):

itemmagnet.updates

(default: op). Disable with

Code (Text):

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

Code (Text):

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

Code (Text):

plugins/ItemMagnet/config-audit.log
SQL filter storage — parameterized queries for SQLite/MySQL backends
Optional integrations only — soft dependencies; runs standalone on Paper