Item Magnet

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 (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 (vertical-reach-blocks, vertical-pull-mode)
• Per-fuel recharge sounds; pull, depleted, and denied cues

Filters

• 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

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)
• Config audit log — plugins/ItemMagnet/config-audit.log
• Update checker — console banner on boot, clickable in-game download link for admins

Integrations (all optional)

Developer API — grantUnlock, giveMagnet, pull/blocked events, hook status.

Compatibility

Paper is required — the plugin uses the Paper API and modern interact handling for fuel transfer.

Quick start

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

Optional: /itemmagnet filter for personal filters, /itemmagnet config for admin tuning.

Commands

Aliases: /im, /magnet

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 — 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.

Update checker (optional)

When metrics.update-check is not DISABLED, ItemMagnet makes a read-only HTTPS request to the GitHub Releases API (api.github.com/repos/MCTheryn/item-magent/releases/latest) 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 from the response. Update messages appear in the server 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 actions require explicit LuckPerms/Bukkit permissions
• Granular config GUI access — optional itemmagnet.config.* nodes per section and field; help and tab completion hide commands you cannot use
• Claim & region respect — optional Lands, WorldGuard, Towny, and other protection hooks; bypass permissions default to false
• Fair pull physics — line-of-sight step movement; items do not teleport through walls
• Config audit log — admin config and filter changes are appended to plugins/ItemMagnet/config-audit.log
• SQL filter storage — SQLite/MySQL backends use parameterized queries (no string-concatenated SQL)
• Optional integrations only — protection and progression plugins are soft dependencies; ItemMagnet runs standalone without them

More detail: bStats setup · metrics config

Links

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

MIT License.