⚠️ Compatibility Note: This plugin is built for Minecraft 1.21.5 Purpur. I tested it on Purpur 1.21.5 and Spigot 1.21.1. It should work on 1.21.1-1.21.5 Spigot/Purpur/Paper/Bukkit.

If you want to report a bug or suggest a new plugin, join my Discord server.

✨ InstantPickUp

Collect. Secure. Survive.

InstantPickUp completely changes the item collection mechanic, transferring items (and XP) directly into the player's inventory instantly. It uses advanced heuristics to reliably track the culprit of drops in complex situations and offers full, per-player control over notifications.

⚡️ Key Features

• ⚡️ Instant Collection (Item & XP): All items and experience orbs (XP) are transferred directly into the player's inventory.

• Fishing: Catch fish directly to your inventory without them flying around. Supports Mending enchantment.

• Shearing: Wool appears instantly in your inventory.

• 📦 Auto-Compress: Automatically compresses 9 items into their block form upon pickup (e.g., 9 Diamonds ➝ 1 Diamond Block, 9 Coal ➝ 1 Coal Block). Saves inventory space instantly.

• 💣 Smart Drop Physics: Uses advanced heuristics to reliably attribute and collect drops:

• Realistic TNT: Features a "Vaporization" mechanic where blocks closer to the explosion center have a lower drop chance, while blocks at the edge are preserved. (Configurable: Realistic vs. Vanilla Yield).

• Falling Columns: Collects entire stacks of sand/gravel/anvils breaking on non-solid blocks.

• Smart Containers: Intelligent filtering allows you to pick up the Chest block itself while letting its contents drop naturally (if configured).

• ✨ Enhanced UX & Anti-Spam:

• Combo Counter: A built-in Combo Counter displays a running total of collected items (e.g., + 64 Stone) on the Action Bar.

• Cooldown: Inventory Full warning messages have a configurable cooldown (default 3s) to prevent chat spam.

• ⚙️ Full Player Customization: Every player has full control over their experience:

• Toggle/State: Enable or disable AutoPickUp (/ip).

• Auto-Compress: Toggle compression on/off (/ip compress).

• Warning Sound: Toggle the Inventory Full warning sound (/ip sound).

• Notification Type: Choose where to receive full inventory warnings (/ip notify fulleq <chat/title/actionbar/none>).

• Language: Instant language switching (/ip lang).

---

🛡️ Admin Control & Configuration

All global settings are available in config.yml and can be changed dynamically.

• TNT Settings: Toggle between realistic-drops (distance-based) or standard vanilla yield.
• Blacklist: Configurable list of materials (e.g., COBBLESTONE) that are ignored during collection.
• Restrictions: The Global Restriction Mode (/ip toggle) forces a required permission check for all players.

---

🚀 InstantPickUp - Commands & Permissions

Main command: /ip (or /instantpickup, /ap, /autopickup)

Command	Description	Permission	Default
--- PLAYER ---
/ip	Toggles your AutoPickUp status (ON/OFF).	instantpickup.use	✅ Everyone
/ip compress <true/false>	Toggles Auto-Compress mode.	instantpickup.use	✅ Everyone
/ip status	Displays the current state of all your settings.	instantpickup.use	✅ Everyone
/ip sound	Toggles the Inventory Full warning sound.	instantpickup.use	✅ Everyone
/ip notify <fulleq/count> ...	Manages display type (Full Inv) or state (Combo Counter).	instantpickup.notification	✅ Everyone
/ip lang <pl/en>	Change your personal interface language.	—	✅ Everyone
--- ADMIN ---
/ip toggle	Toggles the Global Restriction Mode.	instantpickup.admin	❌ OP
/ip default <true/false>	Set the default AP mode for new players.	instantpickup.admin	❌ OP
/ip reload	Reloads plugin configuration and languages.	instantpickup.reload	❌ OP

Special Permissions (Bypass):

Permission	Description	Default
instantpickup.bypass.blacklist	Allows player to collect items defined in the global blacklist.	❌ False

• Wildcard Permission: instantpickup.* (Grants full command access).

---

💾 Installation

1. Download the .jar file.
2. Place it in the /plugins/ folder of your server (Spigot/Paper/Purpur 1.21.x).
3. Restart the server.

In the future, I will make veinminer and treecapitator work with this plugin.