📦 ItemDB - Item Storage

ItemDB is a simple, yet powerful in-game item storage solution. It lets players 📥 store items (preserving full NBT/meta) and retrieve them later — making server management fast, simple, and entirely in-game.

---

✨ Features

• 🏠 Main Menu: Access core functions: Save Item or Browse Items.
• 🎁 Quick Saving: Dedicated GUI: place item in the middle slot → Save / Cancel.
• 📚 Pagination: Browse stored items easily using a paginated viewer.
• 🔍 Advanced Search: Find items fast with a dedicated search GUI.
• 🔢 Flexible Retrieval: Choose to retrieve items in stacks of 1, 8, 16, 32, or 64.

---

🔎 Search System

Items can be found by matching against four key fields:

• ID: (e.g., minecraft:diamond_sword)
• Display Name: The custom name players give items.
• Material Name: The base material of the item.
• Serialized Data: Searches within the item's NBT and Lore for deep matches.

---

🎨 UI & Messaging

ItemDB uses MiniMessage for rich, modern text formatting.

Element	Style	Example Formatting
Prefix	Gradient & Gray Separator	<gradient:#00A8FF:#00E5FF><bold>ItemDB</bold></gradient> <gray>»</gray>
Buttons/Titles	Bold + Blue→Turquoise Gradient	🔹 Item Browser
Normal Text	Subtle Gray	⚪ Normal message text.
Errors	Bold Red	🔴 An error occurred!

---

💾 Database Support

ItemDB offers flexibility for both small and large servers:

Database	Use Case	Benefits
SQLite	Local, Single-Server	Zero setup, perfect for smaller communities.
MariaDB	External, Scalable	High performance, ideal for large or networked server environments.

---

⚙️ Commands & Permissions

Command	Description	Permission
/itemdb	Opens the main ItemDB menu.	itemdb.use
/itemdb reload	Reloads the plugin configuration.	itemdb.admin

---

💻 Requirements

• Server Software: Paper 1.21.8+
• Java Version: 21
• Encoding: Server set to UTF-8 encoding