[HEADING=2]1.6.6 — 2026-06-15[/HEADING]
[HEADING=3]Added[/HEADING]

• Update checker improvements — prominent console banner on boot when a newer GitHub release exists; notifies online admins when the async check completes
• Clickable update link — in-game [Download] opens configured URL (default GitHub releases)
• /itemmagnet version — shows pending update and download link for admins
• metrics.update-download-url — configurable download link

[HEADING=3]Changed[/HEADING]

• Semver comparison — correct version ordering (e.g. 1.6.10 > 1.6.9)
• Hot reload — update-check settings apply on /itemmagnet reload
• URLs — GitHub repo moved to MCTheryn/item-magent; product page theryn.org/itemmagnet

[HEADING=3]Fixed (since 1.6.0)[/HEADING]

• Stuck items near ledges and items stopping short of the player
• Vertical Y-level pull (vertical-reach-blocks, vertical-pull-mode)
• WorldGuard region blacklist iteration crash
• /itemmagnet reload scheduler crash
• WorldGuard ITEM_PICKUP reflection errors
• Smaller release JAR (~330 KB) via Paper libraries for JDBC

Full changelog on GitHub

ItemMagnet v1.6.1
2026-06-15

Added

• /itemmagnet filter clear — removes all personal filter materials and tags (preserves first-hint metadata)
• Admin tag blacklist GUI — edit settings.item-blacklist-tags from the Item Filter config menu (Materials | Tags toggle, chat add)
• Preset preview + confirm — preset picker shows merge preview (new materials/tags, server-skipped count) before applying
• Player filter storage backends — player-filter.storage: YAML (default), SQLITE, or MYSQL; one-time YAML → SQL import on first enable
• bStats session charts — top block reason, per-reason activity flags, storage backend, inventory-full behavior, default preset, hold mode, pull experience
• Pull-blocked bridges — config-driven Quests and CMI progress rules on ItemMagnetPullBlockedEvent

Changed

• Personal filter data can be stored in SQLite (player-filters.db) or MySQL instead of player-filters.yml

[hr][/hr]

ItemMagnet v1.5.0

• Shared filter core with tag-based rules and PullEligibilityService
• Player filter GUI with presets and read-only server rules section
• ItemMagnetPullBlockedEvent, import commands, server presets (skyblock, vanilla-survival, hub-spawn)
• PlaceholderAPI filter placeholders, config audit log, inventory-full behavior

ItemMagnet v1.4.0

• Personal filter GUI (/itemmagnet filter)
• Server item blacklist in config + admin GUI
• Granular itemmagnet.config.* permissions

Full changelog on GitHub

[hr][/hr]
ItemMagnet is a Paper plugin built for survival SMPs. Pull dropped loot with line-of-sight physics — items slide around corners and stop at walls instead of phasing through blocks. Fuel resonators with redstone, respect land claims, and tune everything from an in-game config GUI or YAML.
[hr][/hr]
Why ItemMagnet?

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

Gameplay

• Three configurable tiers (Fragment, Survey, Anchor) with recipes and unlock gates
• Hold modes: main hand, hotbar, or inventory
• Optional XP orb pulling
• Live lore: charge, boost, and current pull radius
• Sneak + right-click fuel or auto-absorb redstone drops

Filters

• Server material + tag blacklist (config + admin GUI)
• Personal filter GUI — /itemmagnet filter
• Built-in presets (mining, farming, mob-drops, keep-valuables) with merge preview
• /itemmagnet filter clear and import commands
• YAML, SQLite, or MySQL storage for player filter data

Integrations (optional)
Lands · WorldGuard · Towny · GriefPrevention · Residence · PlotSquared · SuperiorSkyblock2 · CMI · LuckPerms · mcMMO · Quests · PlaceholderAPI · Developer API
[hr][/hr]
Requirements

• Paper 1.21.1+ (Java 21+)
• Tested on Paper 1.21.1, 1.21.4, 26.1
• Not supported: Spigot, CraftBukkit, Folia

Quick start

1. Drop the JAR in plugins/ and restart
2. /itemmagnet give <player> fragment 500
3. Hold the magnet, sneak + right-click with redstone dust to fuel
4. Drop items nearby — they pull toward you with visible motion

[hr][/hr]
Website · GitHub & docs · Hangar
License: MIT

ItemMagnet v1.2.4 — Paper 26.x & protection hook fixes


[HR]

What changed since v1.2.2

• Paper 26.x recipe compatibility — skip durability-style charge bars on stackable tier materials (e.g. recovery compass) so crafted magnets stay valid and no longer break other plugins that scan recipes at startup
• Lands 7.26 — updated hook to use
  Code (Text):

  getArea(Location)
  instead of the removed
  Code (Text):

  getLand(Location)
  API
• WorldGuard 7.0.17 — updated hook to use
  Code (Text):

  RegionQuery.testState(Location, …)
  instead of the removed
  Code (Text):

  ApplicableRegionSet.testState(LocalPlayer, …)
  API
• Lands & WorldGuard reflection — additional signature fixes for current RoleFlag typing and WorldGuard varargs
  Code (Text):

  StateFlag
  queries (v1.2.4)
• AFK notify-once on login — fresh logins no longer trigger idle warnings before movement tracking starts
• Fuel sound — default recharge sound updated; legacy
  Code (Text):

  BLOCK_REDSTONE_BLOCK_CLICK
  aliases to
  Code (Text):

  BLOCK_NOTE_BLOCK_BIT

[HR]

No config changes required

This is a drop-in upgrade. Proximity lore and all other settings from v1.2.2 are unchanged.

[HR]

Download & links

• GitHub Releases
• Changelog
• Product website
• Hangar
• Report bugs

[HR]

Requirements (unchanged)

• Paper 1.21.1+
• Java 21+
• Tested on Paper 1.21.1, 1.21.4, 26.1
• Not supported: Spigot, CraftBukkit, Folia

[HR]

Upgrade from v1.2.2

• Replace ItemMagnet-1.2.2.jar with ItemMagnet-1.2.4.jar in
  Code (Text):

  plugins/
• Restart the server (recommended) or
  Code (Text):

  /itemmagnet reload
• Run
  Code (Text):

  /itemmagnet version
  to confirm Lands / WorldGuard hooks are detected

[HR]

Questions? Support form or GitHub issues with Paper version, Java version, and steps to reproduce.

ItemMagnet v1.2.2 — Proximity Lore


[HR]

What is new

• Proximity lore — configure coordinate zones that send ambient chat messages when players hold an active magnet nearby. Great for quest hints, dungeon atmosphere, landmarks, or RPG flavor.
• Config GUI — new Proximity Lore section in
  Code (Text):

  /itemmagnet config
  : enable/disable, scan interval, cooldown, require-active-magnet, and a zone editor for world + coords + radius.
• Per-tier messages — optional
  Code (Text):

  tier-messages
  overrides per zone (e.g. different whispers for each magnet tier).
• Backwards compatible — absent or
  Code (Text):

  enabled: false
  = zero behavior change from v1.2.1.

[HR]

Config example

Full reference: proximity-lore.md

[HR]

Download & links

• Download v1.2.2
• Changelog
• Product website
• Hangar
• Report bugs

[HR]

Requirements (unchanged)

• Paper 1.21.1+
• Java 21+
• Not supported: Spigot, CraftBukkit, Folia

[HR]

Upgrade from v1.2.1

• Replace ItemMagnet-1.2.2.jar in
  Code (Text):

  plugins/
• Restart or
  Code (Text):

  /itemmagnet reload
• Proximity lore stays disabled until you enable it — existing servers are unaffected

[HR]

Questions? Support form or GitHub issues with Paper version and steps to reproduce.

ItemMagnet is back — rebuilt for Paper 1.21+
[HR]
It has been a while.
ItemMagnet went quiet after 2021. If you used the original plugin on older versions, thank you for your patience — this is a full revival built for modern Paper servers, not a quick port.
The core idea is the same: tiered magnet tools that pull dropped loot toward you. Everything else has been rebuilt for how survival SMPs run today.
[HR]
What is new in the 1.2.x line

• Paper 1.21.1+ and Java 21+ (tested through Paper 26.1)
• Visible pull physics — line-of-sight movement; items slide around corners instead of teleporting through walls
• Redstone fuel system — dust recharge, redstone block power surges, live charge/radius on item lore
• Claim-aware — Lands, WorldGuard, Towny, and GriefPrevention hooks
• Three tiers — Fragment, Survey, Anchor (configurable materials, recipes, unlock gates)
• Hold modes — main hand, hotbar, or anywhere in inventory
• In-game config GUI —
  Code (Text):

  /itemmagnet config
  with tier editor and hot reload
• XP orb pulling, PlaceholderAPI placeholders, and a public developer API

[HR]
Requirements (important)

• Paper 1.21.1 or newer — required (not vanilla Spigot/CraftBukkit)
• Java 21+
• Folia — not supported

Paper is a drop-in replacement on most hosts. If you ran the 2021 build on Spigot, you will need Paper for fuel transfer and modern interact handling.
[HR]
Download & links

• Product website — screenshots, docs, support form
• Download v1.2.1
• Hangar
• Full documentation
• Request support
• Report bugs

[HR]
Quick start

1. Download ItemMagnet-1.2.1.jar and place it in
   Code (Text):

   plugins/
2. Restart your Paper server
3. Code (Text):

   /itemmagnet give YourName fragment 500
4. Hold the magnet; fuel with redstone dust (sneak + right-click)
5. Drop items nearby — they pull with visible motion

Optional: to open the in-game editor.
[HR]
Migrating from the old 2021 build
Treat this as a fresh install:

• Config format, commands, and permissions have changed
• Review
  Code (Text):

  plugins/ItemMagnet/config.yml
  on first run or use
  Code (Text):

  /itemmagnet config
• Old magnet items in player inventories may need to be re-given
• Integrations (Lands, WorldGuard, etc.) are optional but recommended for SMPs

Full command and permission reference is in the resource Documentation tab and on the website.
[HR]
v1.2.1 changelog highlights

• Config GUI tier renaming (chat input from tier editor)
• Live
  Code (Text):

  {radius}
  and
  Code (Text):

  {base_radius}
  lore placeholders
• Per-fuel recharge sounds and improved fuel transfer (either hand)
• Code (Text):

  /itemmagnet giveall
  and
  Code (Text):

  /itemmagnet unlockall
• AFK
  Code (Text):

  notify-once
  , permission-filtered help, reload restart warnings

[HR]
Screenshots and a full feature breakdown are on itemmagnet.theryn.org. Questions welcome — use the support form or open a GitHub issue with your Paper version and steps to reproduce.
Welcome back.