🧲 Magnet, Let me get that!

"If you can see it, you should have it."

Magnet, Let me get that! is an intrinsic extension of your will. It creates a constant, powerful vacuum that pulls items and XP orbs directly to you. No items to hold, no energy to charge — just pure convenience.

Part of the Instant Gratification Collection — mods that respect the player's time.

---

✨ Features

🌪️ The Vacuum Field

Command the materials around you with surgical precision.

• Intrinsic Magnetism: No need to craft, hold, or equip a special item. The vacuum effect is tied directly to your player.
• Phase Shifting (NoClip): Items don't get stuck on walls or under floors. They phase through terrain to reach your inventory.
• LOS Awareness: Magnetism respects Line of Sight to keep exploration challenging.
• Terminal Velocity: Items accelerate smoothly but aggressively towards you.
• XP Sync: Experience Orbs obey the same physical laws. Leave nothing behind.

🎯 Individual Player Toggles

You have full control over your personal vacuum field.

• Dedicated Hotkey: Press \ (backslash) to instantly toggle your magnet on or off in-game. Fully rebindable via the standard Minecraft Controls menu.
• Chat Command: You can also use the /magnet toggle or /ig_magnet toggle command to switch your status.
• Save State Persistence: Your preference is saved directly to your player NBT save file (level.dat). It persists through deaths, dimension travel (Nether/End), and server restarts.
• Login Auto-Sync: The server automatically synchronizes your toggle status to your client upon joining, keeping HUD overlays in perfect sync.

⚙️ Pure GameRules Control

Configure every aspect of the vacuum field via the vanilla Edit Game Rules screen or commands.

• Radius Control: Adjust the pull distance (Default: 12 blocks).
• Instant Warp Mode: Toggle between smooth flight or instant teleportation to inventory.
• Visual Trails & Source Throttling: Optional cosmetic particles to track magnetized items, capped per-tick to eliminate lag on high-item drops.
• Occlusion Settings: Configure whether the magnet is blocked by transparent blocks, flora, or interactive furniture.

---

⚙️ Configuration (Native Game Rules)

[!IMPORTANT] Config vs. In-Game GameRules: The global configuration file (ig_magnet.json) only defines default values for new worlds at creation time. If you have already created/opened a world, changing the config file will have no effect. You must change the settings in-game using the Edit Game Rules UI screen or the /gamerule command.

No messy config files. The mod uses the Native Minecraft Game Rules system. All mod parameters are grouped into a dedicated "Magnet" category in the official UI.

📋 Quick Commands

/gamerule ig:magnet_range 24         → Double the range
/gamerule ig:magnet_instant true     → Warp items directly to inventory
/gamerule ig:magnet_los_only true    → Require line-of-sight
/gamerule ig:magnet_affects_xp false → Disable XP magnetism
/magnet toggle                       → Toggle personal magnet field (or press '\')
/magnet debug                        → View player UUID, GameRules, and LOS check details
/magnet debug log                    → Toggle persistent log files in logs/ig_magnet_debug.log

---

💻 Server-Side Optional & Client Gating

• Server-Side Optional: "Magnet, Let me get that!" is fully compatible with vanilla clients! Vanilla clients can connect to servers running the mod without installing it.
• Dedicated Server Support: Client-only rendering logic is isolated to prevent classloading crashes on headless dedicated servers.
• Performance Hardened: Scan algorithms are highly optimized. Heavy spatial queries are cached to ensure zero TPS impact.

---

☕ Support

If you enjoy the Instant Gratification collection, consider fueling the next update!

[!NOTE] Indonesian Users: SocioBuzz and Saweria support local payment methods (Gopay, OVO, Dana, etc.) if you want to support me without using PayPal/Ko-fi!

---

[!IMPORTANT] 📦 Modpack Permissions & Distribution: You are free to include this mod in any modpack on any platform. However, the mod itself must be downloaded from its official distribution pages on Modrinth or CurseForge. Re-uploading or redistributing the mod jar file to third-party sites is strictly prohibited unless explicitly permitted by the creator.

License & Forks: Since the source code is licensed under GNU GPLv3, you are fully permitted to fork the repository, make modifications, build your own versions, and distribute them under the terms of the GPLv3. The prohibition on third-party redistribution applies exclusively to the official compiled releases/jars published by the original creator (Dasik/Rifaditya). Forks must be published as distinct projects, not direct re-uploads of official builds.

---

📜 Credits

Role	Author
Creator	Dasik (Rifaditya)
Collection	Instant Gratification
License	GPLv3

---