[MGG] Magnetic

Choose how items are collected, customize pickup behavior, and keep your inventory organized without constantly chasing scattered drops.

No client mods or resource packs required.

Features

• Magnetic Enchantment — Automatically attracts nearby dropped items and experience while using an enchanted tool.
• Sneaky Magnetic Enchantment — Collects nearby drops only while crouching with an enchanted tool.
• Automatic Item Collection — Collect items from mining, broken blocks, and defeated mobs.
• Experience Collection — Attract nearby experience orbs alongside dropped items.
• Customizable Activation — Choose between Always, Enchantment, Permission, or Sneak activation conditions.
• Combined Activation Rules — Use AND/OR conditions to customize when Magnetic activates.
• Smooth Item Attraction — Animate dropped items moving toward players with configurable movement speed.
• Inventory Protection — Handle collected items through an inventory buffer and provide configurable full-inventory alerts.
• Customizable Alerts — Enable sound, chat, or title notifications with individual cooldowns.
• Item & Entity Filters — Exclude specific blocks, entities, or tags from Magnetic collection.
• Enchanted Book Integration — Optionally include Magnetic enchanted books in loot tables and villager trades.
• In-Game Help Guide — Access a native Minecraft dialogue explaining the enchantments and their usage.
• Multilingual Support — Includes English, German, Spanish, French, Brazilian Portuguese, Polish, Russian, and Simplified Chinese.
• Customizable Configuration — Adjust collection behavior, activation conditions, notifications, and enchantment availability.

Commands

• /magnetic — Opens the Magnetic help dialogue.
• /magnetic help — Displays the in-game guide explaining both enchantments.
• /magnetic reload — Reloads the plugin configuration (operator only).
• /magnetize magnetic — Applies Magnetic to a compatible held tool.
• /magnetize sneaky — Applies Sneaky Magnetic to a compatible held tool.

The /magnetize commands are intended for administrators or players with the required permission.

Permissions

Normal Magnetic functionality is available through enchanted tools by default.

Administrators can configure additional access using:

• mgg.magnetic.use — Allows Magnetic collection when permission-based activation is enabled.
• mgg.magnetic.magnetize — Allows authorized players to apply Magnetic enchantments using /magnetize.

Configuration reloading requires operator access.

Installation

1. Place MGG-Magnetic-1.0.0.jar inside your Minecraft server's plugins folder.
2. Start or restart the server.
3. The plugin automatically generates its configuration and translations under plugins/MGG Magnetic/.
4. Obtain or apply a Magnetic enchantment to a compatible tool and begin collecting nearby drops.

Compatibility

• Minecraft Java Edition — Paper 26.2
• Server-side plugin
• No client installation required
• No resource pack required

Important Notes

• Magnetic attracts nearby items and experience according to the server's configured settings.
• Sneaky Magnetic requires crouching to activate its collection behavior.
• Enchantment-based activation is enabled by default.
• Inventory alerts, item attraction animations, and collection filters can be adjusted through the configuration.
• Magnetic enchanted books can be enabled or disabled separately for loot tables and villager trading.
• Changes to enchanted book availability require a server restart.
• Translation files can be customized independently without editing the plugin.
• Server administrators can configure alternative activation requirements without changing the enchantments themselves.

Support & Usage

If you encounter problems with item collection, enchantment behavior, inventory alerts, or compatibility with another plugin, please report your Minecraft/Paper version and include the relevant server log.

💚 Consider following MrGreenGames if you enjoy this plugin!

🟢 Feel free to use this plugin on your servers, in modpacks, and in videos!

If you feature the plugin in a video or showcase, linking back to the original plugin page is greatly appreciated, but not required.

🔴 Please do not redistribute or repurpose the plugin.

You may not reupload the plugin to other websites, launchers, or platforms, nor reuse its assets or code in separate projects without permission.

Do not place the plugin behind ad-based redirect services or include it in paid modpacks or server packages.

💚 This plugin is intended to remain free and accessible to everyone.