📦 AutoBuyChest

AutoBuyChest is a high-performance, exploit-safe automation plugin designed for Paper servers. It connects your server's shop economy directly to player automation—enabling players to craft an AFK Farm Controller, select any item to restock, bind a storage chest, and automatically purchase items using live buy prices from EconomyShopGUI.

Whether you're running armadillo brush farms, auto-fertilizing bone meal setups, fuel dispensers, or potion brewing machines, AutoBuyChest handles the logistics while players are offline or AFK.

---

✨ Key Features

• 🎯 Universal Item Restocking: Choose any item material (e.g. brush, bone_meal, coal, firework_rocket) to automatically purchase and restock.
• 💰 Accurate EconomyShopGUI Integration: Hooks directly into official EconomyShopGUI APIs to read live shop buy prices (including player discounts and permissions).
• 🔒 100% Exploit & Dupe Safe: Never creates items for free. Strictly checks Vault player balances and prevents transactions if funds are insufficient or storage is full.
• 🧭 Interactive In-Game GUI & Chat Setup: Intuitive right-click menu to configure item types, bind chests, adjust radius, and view live farm stats.
• ⚡ Lightweight Chunk Loading: Keeps farm boundaries loaded using native Paper chunk tickets with configurable per-player and global limits to preserve TPS.
• 📊 Persistent SQLite Storage: Farm configurations and restock statistics persist smoothly across server restarts.
• 🔮 DecentHolograms Support: Optional floating status holograms above active controllers showing stock levels and farm state.

---

🔄 How the Flow Works

[EconomyShopGUI] ──(Vault $)──> [AutoBuyChest] ──(Restocks)──> [Target Storage Chest] │ (Hoppers) ▼ [Farm / Dispensers]

---

🛠️ Crafting Recipe

Players can craft the AFK Farm Controller in a standard workbench:

---

🚀 Quick Setup Guide

1. Craft the AFK Farm Controller block.
2. Place it down anywhere within your farm area.
3. Right-Click the controller block to open the control panel:
   • 🎯 Set Target Item: Click the target icon and type the desired item name in chat (e.g. brush or bone_meal).
   • 📦 Bind Storage Chest: Click the chest icon, then right-click your target storage container.
   • 🧭 Define Farm Radius: Configure your boundary and enable Paper chunk loading to keep it active while away.
4. Hook standard vanilla hoppers beneath the chest into your dispensers and let the farm run!

---

⚙️ Commands & Permissions

Commands

Command	Description	Permission
/autobuychest	Opens help and farm list	autobuychest.use
/autobuychest list	View all your registered controllers	autobuychest.use
/autobuychest stats	View items purchased and money spent	autobuychest.use
/autobuychest give [player]	Spawn an AFK Controller item	autobuychest.admin
/autobuychest reload	Reload configuration files	autobuychest.admin

Permissions

Permission	Default	Description
autobuychest.use	true	Allows using basic commands and GUIs
autobuychest.create	true	Allows placing/crafting farm controllers
autobuychest.admin	op	Admin management and reload commands
autobuychest.bypass	op	Bypass maximum farm limits

---

🔌 Requirements & Compatibility

• Server Software: Paper / Purpur (1.20+ / 26.x compatible)
• Java Version: Java 21+ / Java 25
• Required Plugins:
  • Vault (with a compatible economy provider like EssentialsX)
  • EconomyShopGUI
• Optional Integrations:
  • DecentHolograms (Floating display text above controllers)
  • AutoSellChests (Automatic selling of gathered farm output)