🧲 MineShield Magnet

I noticed that no one is making free plugins with MineShield.

So I decided to make a plugin that everyone really wants, and it's a magnet plugin from the popular MineShield 4 Season server. If you have any questions or find bugs, write in the Discord channel Discord

---

📖 About

A free plugin for Minecraft servers on Paper or Spigot that adds magnets — points in the world that pull items, players, and entities toward them. Inspired by the popular MineShield 4 Season server.

✨ Key features

• Create magnets anywhere with /magnetset
• Automatic core generation from built structures (Magnetite + Iron Bars / Oxidized Copper Grate)
• Pull or push items, players, minecarts, and armor stands
• GUI for magnetic items — 5 pages, up to 225 items, drag and drop
• Broken cores saved in config.yml between server restarts
• Separate toggles for small and large core creation in config
• Unique visual effects for pull and push modes (particles + sounds)

---

📝 Changelog

🆕 New

• Push mode — magnets and cores can now push objects instead of pulling them. Mode is saved in config.yml.
• Switch core mode without commands — hold Shift + Right Click on any block of the core structure to toggle between pull and push. Requires permission magnet.core.toggle.
• Different visual effects:
  • Push: fire (FLAME) and smoke (SMOKE)
  • Pull: electric sparks (ELECTRIC_SPARK) and ender rods (END_ROD)
• Broken cores saved — the broken-magnets list is now written to config.yml and does not reset after restart.
• Core creation toggle — in config you can separately enable/disable small (structures.small.enabled) and large (structures.big.enabled) core creation.
• New commands: /magnetall (pull for all players) and /magnetplayer (pull for a specific player).

🐞 Fixes

• Fixed block placement being blocked when clicking core structures (you can build normally now).
• Fixed compatibility with Paper 26.x and Java 25.
• Fixed outdated API methods that prevented compilation on newer versions.

---

🎮 Commands

Command	Alias	Description	Permission
/magnetreload	/mreload	Reload plugin config	magnet.admin
/magnetset	/mset	Create a magnet at your location	magnet.admin
/magnetdel	/mdel	Delete a magnet by name	magnet.admin
/magnetlist	/mlist	Show all installed magnets	magnet.admin
/magnetitems	/mitems	Open GUI to manage magnetic items	magnet.admin
/magnetpage	/mpage	Open GUI page (1–5)	magnet.admin
/magnettoggle	/mtoggle	Toggle pull for yourself	magnet.admin
/magnetplayer	/mplayer	Toggle pull for another player	magnet.admin
/magnetall	/mall	Toggle pull for all players	magnet.admin

---

🔐 Permissions

Permission	Description	Default
magnet.admin	Access to all commands	Operators only
magnet.core.toggle	Toggle core mode with Shift + Right Click	Operators only

---

⚙️ Configuration (config.yml)

Section	Description
magnet-items	List of materials that count as magnetic items
defaults.radius	Default pull radius
defaults.height	Default pull height
defaults.speed	Default pull speed
defaults.mode	Default mode (inventory — only with item, all — for everyone)
defaults.repelled	Push by default (true/false)
structures.small.enabled	Allow creating small cores from structures
structures.big.enabled	Allow creating large cores from structures
broken-magnets	List of broken cores (saved automatically)
sound	Sound settings when pulling (enabled, type, volume, pitch)
collision.enabled	Deal damage when hitting walls

Example config.yml

magnet-items:
  - IRON_INGOT
  - GOLD_INGOT
  - DIAMOND

defaults:
  radius: 10.0
  height: 5.0
  speed: 0.5
  mode: inventory
  repelled: false

structures:
  enabled: true
  small:
    enabled: true
    radius: 25
    height: 25
    speed: 0.1
    mode: inventory
  big:
    enabled: true
    radius: 100
    height: 100
    speed: 0.1
    mode: inventory

sound:
  enabled: true
  type: BLOCK_BEACON_AMBIENT
  volume: 1.0
  pitch: 1.0

collision:
  enabled: true

---

🧱 How to create a core

Small core

1. Place a Magnetite block (Lodestone).
2. Surround it with Iron Bars in three layers (bottom, sides, top) in a 3×3 pattern.
3. The core will create automatically.

Large core

1. Place a Magnetite block.
2. Surround it with Oxidized Copper Grate and Iron Bars in a three-layer 3×3 pattern.

Once built, the core will start pulling (or pushing) items and players!
To change the mode, approach any block of the core structure, hold Shift, and press Right Click.

---

If you find a bug or have a suggestion, write in Discord.