BenthKese

# BenthKese (https://img.shields.io/badge/Version-1.0.1-blue.svg)]() (https://img.shields.io/badge/Spigot/Paper-1.13.x%20--%201.21.x-orange.svg)](https://www.spigotmc.org/) (https://img.shields.io/badge/Dependency-Vault-blue)](https://www.spigotmc.org/resources/vault.34315/) (https://img.shields.io/badge/Optional-PlaceHolderAPI-yellow)](https://www.spigotmc.org/resources/placeholderapi.6245/) (https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) **Advanced Virtual Pouch & Economy System** BenthKese is a modern Spigot plugin that allows players to deposit and withdraw valuable items (like Gold Ingots, by default) into a virtual pouch, converting them to a digital currency. Going beyond a simple item-to-money converter, it adds layers of depth and control to your server's economy with fully configurable systems. With its user-friendly menus, powerful admin tools, transparent transaction history, and extensive PlaceHolderAPI support, BenthKese is the perfect addition to any server economy. <details> <summary>Screenshots</summary> **Main Menu** !(https://i.imgur.com/obgJArW.gif) **Time Deposit Account** !(https://i.imgur.com/XacXLlH.gif) **Quick Deposit** !(https://i.imgur.com/r6PaM2u.gif) **Withdraw Money** !(https://i.imgur.com/p1LULk5.gif) **Transaction History** !(https://i.imgur.com/JGib1dj.gif) </details> ## ✨ Key Features ### 💎 Player-Focused Features * **Modern GUI:** An interactive and stylish main menu, accessed with `/kese`, where all transactions can be handled with ease. * **Flexible Depositing:** Deposit a specific amount (`/kese deposit 64`), all items in your hand (`/kese deposit hand`), or all items in your inventory (`/kese deposit inventory`) with a single command. * **Smart Withdrawing:** If your inventory is full when withdrawing, the plugin gives you the maximum amount you can carry and notifies you. * **Transaction History:** Players can view their last 50 financial transactions (sending, receiving, level-ups, etc.) transparently through the GUI. * **Safe Transactions:** A confirmation menu for high-cost actions (like upgrading limits or breaking a time deposit) prevents accidental clicks. * **Instant Feedback & Dynamic GUI:** * After a transfer, players receive an instant update on their current limit status via the **Action Bar**. * The remaining time for time deposits in the interest menu updates dynamically every second, allowing players to track their investments without refreshing the menu. ### 🏦 Advanced Systems * **Level-Based Limit System:** * Create fully customizable limit levels in `limits.yml`. * Each level can have its own name, cost, and daily sending/receiving limits. * Players can upgrade their limit levels in-game by paying the configured cost. * **Time Deposit (Interest) System:** * Players can lock their money for a specific duration (`1d`, `7d`, etc.) to earn interest based on rates defined in `config.yml`. * All time deposit accounts are easily managed through a dedicated GUI. * **Dynamic Buttons:** * Buttons in the GUI change dynamically based on the player's status. For example, if a player doesn't have enough money to upgrade their limit, the button turns red and explains why. ### ⚙️ Admin & Server Features * **Powerful Admin Commands (`/keseadmin`):** * **Reload:** Instantly refresh all configuration files without a server restart. * **Balance Management:** Add, remove, or set a player's Vault balance directly. * **Limit Management:** Instantly change a player's limit level. * **Flexible Data Storage:** * Choose between **YAML**, **SQLite** (default), or **MySQL** storage to fit your server's needs. MySQL is supported with the high-performance `HikariCP` connection pool. * **Fully Translatable:** Customize every single message in the plugin via `messages.yml`, complete with color codes and variables. * **Fully Customizable Menus (`menus.yml`):** * In addition to `messages.yml` and `limits.yml`, you can now fully control the appearance and layout of **all menus** in the plugin through the `menus.yml` file. * Adjust menu sizes, titles, and the material, slot position, name, and lore of buttons to match your server's theme without any coding. ### 🌐 Integrations * **Vault (Required):** Works seamlessly with any economy plugin on your server. * **PlaceHolderAPI (Optional):** Extensive placeholder support for integration with scoreboards, chat formats, and other plugins. * **AnvilGUI (Embedded):** Uses modern and user-friendly interfaces to get input like amounts or player names. ## 📦 Installation 1. Download the latest version of the plugin (`BenthKese-1.0.1.jar`) from the (https://github.com/bentahsin/benthkese/releases). 2. Ensure you have **(https://www.spigo