zAutoPickup

Smart Auto-Pickup • Filters • Auto-Smelt • Auto-Sell • Vacuum Mode

A lightweight, modern and highly optimized auto-pickup plugin for Paper & Folia servers.

zAutoPickup provides a smooth and intelligent pickup experience with advanced systems like item filters, vacuum collection, auto-smelting, auto-selling and detailed player statistics — all designed with performance and usability in mind.

Perfect for Survival, SMP, Skyblock, Prison and Economy servers.

---

✨ Features

🧲 Automatic Item Pickup

Automatically collect:

• Block drops
• Mob drops
• Player death items

Directly into the player's inventory.

---

🎯 Smart Filter GUI

Modern inventory-based GUI that allows players to choose exactly which items they want to collect.

Easy to use and fully customizable.

---

🔥 Auto-Smelt System

Automatically smelt supported items on pickup.

Supports:

• Ores
• Food
• Logs
• Custom mappings

---

💰 Auto-Sell

Automatically sell items using configurable interactions.

Supports:

• Right click
• Left click
• Sneaking actions
• Economy integration

---

🌪 Vacuum Mode

Pull nearby items directly toward the player using a configurable vacuum radius.

Ideal for:

• Farms
• Grinders
• Fast-paced gameplay

---

📊 Statistics System

Track detailed player progress including:

• Blocks mined
• Items collected
• Mobs killed
• XP earned
• Money earned

---

🔔 Inventory Full Notifications

Notify players when inventories are full using:

• Chat messages
• Actionbars
• Titles
• Sounds

---

🌍 World Control

Enable or disable features per-world using whitelist or blacklist modes.

---

🚫 Global Blacklist

Prevent specific items from being:

• Picked up
• Smelted
• Sold

---

🛡 Performance & Safety

Built with performance and stability as a priority.

Includes:

• Rate limiting
• Distance validation
• Safe processing
• Folia optimized handling

---

🔌 PlaceholderAPI Support

Display plugin statistics anywhere using PlaceholderAPI placeholders.

---

⚡ Compatibility

Software	Version
Paper	1.21+
Folia	1.21+
Java	21+

Optional dependency:

• PlaceholderAPI

---

🧩 Commands

Command	Description
/zautopickup toggle	Toggle auto-pickup
/zautopickup filter	Open filter GUI
/zautopickup vacuum	Toggle vacuum mode
/zautopickup smelt	Toggle auto-smelt
/zautopickup sell	Toggle auto-sell
/zautopickup stats	View statistics
/zautopickup help	Open help menu
/zautopickup reload	Reload configuration

---

🔑 Permissions

Permission	Description
zautopickup.toggle	Use toggle command
zautopickup.filter	Open filter GUI
zautopickup.vacuum	Use vacuum mode
zautopickup.smelt	Use auto-smelt
zautopickup.sell	Use auto-sell
zautopickup.stats	View statistics
zautopickup.use	Base plugin usage
zautopickup.admin.reload	Reload plugin

---

⚙ Configuration

zAutoPickup includes a clean and highly customizable configuration system.

Included options:

• Multi-language support
• English & Spanish translations
• Custom smelting recipes
• Configurable sell triggers
• Vacuum radius & speed
• Notification settings
• World management
• Blacklists
• Performance settings

---

🚀 Designed For Modern Servers

zAutoPickup was carefully designed for modern server infrastructures with performance, stability and player experience in mind.

Whether you're running a small SMP or a large network, the plugin remains lightweight, responsive and highly scalable.

---

❤️ Support

If you find any bugs or have suggestions, feel free to open an issue or leave feedback.

Thank you for using zAutoPickup.