📦 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
