# BenthKese
\n![Version]()
\n
\n
\n
\n<\/p>\n
**Advanced Virtual Pouch & Economy System**<\/p>\n
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.<\/p>\n
With its user-friendly menus, powerful admin tools, transparent transaction history, and extensive PlaceHolderAPI support, BenthKese is the perfect addition to any server economy.<\/p>\n **Main Menu** **Time Deposit Account** **Quick Deposit** **Withdraw Money** **Transaction History** ## \u2728 Key Features<\/p>\n ### \ud83d\udc8e Player-Focused Features ### \ud83c\udfe6 Advanced Systems ### \u2699\ufe0f Admin & Server Features ### \ud83c\udf10 Integrations ## \ud83d\udce6 Installation<\/p>\n 1. Download the latest version of the plugin (`BenthKese-1.0.1.jar`) from the Releases page. ## \ud83d\udee0\ufe0f Commands & Permissions<\/p>\n ### Player Commands (`\/kese`) ### Admin Commands (`\/keseadmin` or `\/bka`) ## \ud83d\udcca PlaceHolderAPI Placeholders<\/p>\n You can use the following placeholders in any plugin that supports PlaceHolderAPI.<\/p>\n ### Personal Balance & Limits ### Time Deposit System ### Personal Statistics ### Server Leaderboards (SQL Required) ### Server Information ## \u2699\ufe0f Configuration<\/p>\n The plugin comes with four main configuration files:<\/p>\n * **`config.yml`:** Main settings. Manage storage type, economy item, taxes, and interest rates here. **Example `limits.yml` structure:** ## \ud83e\udd1d Support & Contribution<\/p>\n If you find a bug or want to suggest a feature, please use the **Issues** tab on the project’s GitHub. Pull requests are always welcome.<\/p>\n ## \ud83d\udcdc License<\/p>\n This project is licensed under the MIT License. See the `LICENSE` file for more details.<\/p>\n","protected":false},"excerpt":{"rendered":" An advanced purse\/economy plugin that enhances the economies of Towny servers with trade limits, treasury investment (interest), and a full GUI.<\/p>\n","protected":false},"featured_media":27407,"template":"","meta":{"_minecraft_slug":"benthkese","_minecraft_project_id":"tMWPPBCX","_minecraft_author":"bentahsin","_minecraft_license":"MIT","_minecraft_downloads":73,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"benthkese.zip","_minecraft_size_bytes":21035832,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:25:48.074269Z","_minecraft_date_created":"2025-11-13T00:36:36.988211Z","_minecraft_date_modified":"2026-02-03T21:42:00.446015Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/benthkese","_minecraft_icon_attachment_id":27407,"_minecraft_imported_at":"2026-06-01T10:32:23+00:00","_minecraft_import_hash":"7ac059cfb1500c4e84ecdfbba2e46ae9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-27406","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nScreenshots<\/summary>\n
\n<\/p>\n
\n<\/p>\n
\n<\/p>\n
\n<\/p>\n
\n<\/p>\n<\/details>\n
\n* **Modern GUI:** An interactive and stylish main menu, accessed with `\/kese`, where all transactions can be handled with ease.
\n* **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.
\n* **Smart Withdrawing:** If your inventory is full when withdrawing, the plugin gives you the maximum amount you can carry and notifies you.
\n* **Transaction History:** Players can view their last 50 financial transactions (sending, receiving, level-ups, etc.) transparently through the GUI.
\n* **Safe Transactions:** A confirmation menu for high-cost actions (like upgrading limits or breaking a time deposit) prevents accidental clicks.
\n* **Instant Feedback & Dynamic GUI:**
\n * After a transfer, players receive an instant update on their current limit status via the **Action Bar**.
\n * The remaining time for time deposits in the interest menu updates dynamically every second, allowing players to track their investments without refreshing the menu.<\/p>\n
\n* **Level-Based Limit System:**
\n * Create fully customizable limit levels in `limits.yml`.
\n * Each level can have its own name, cost, and daily sending\/receiving limits.
\n * Players can upgrade their limit levels in-game by paying the configured cost.
\n* **Time Deposit (Interest) System:**
\n * Players can lock their money for a specific duration (`1d`, `7d`, etc.) to earn interest based on rates defined in `config.yml`.
\n * All time deposit accounts are easily managed through a dedicated GUI.
\n* **Dynamic Buttons:**
\n * 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.<\/p>\n
\n* **Powerful Admin Commands (`\/keseadmin`):**
\n * **Reload:** Instantly refresh all configuration files without a server restart.
\n * **Balance Management:** Add, remove, or set a player’s Vault balance directly.
\n * **Limit Management:** Instantly change a player’s limit level.
\n* **Flexible Data Storage:**
\n * Choose between **YAML**, **SQLite** (default), or **MySQL** storage to fit your server’s needs. MySQL is supported with the high-performance `HikariCP` connection pool.
\n* **Fully Translatable:** Customize every single message in the plugin via `messages.yml`, complete with color codes and variables.
\n* **Fully Customizable Menus (`menus.yml`):**
\n * 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.
\n * Adjust menu sizes, titles, and the material, slot position, name, and lore of buttons to match your server’s theme without any coding.<\/p>\n
\n* **Vault (Required):** Works seamlessly with any economy plugin on your server.
\n* **PlaceHolderAPI (Optional):** Extensive placeholder support for integration with scoreboards, chat formats, and other plugins.
\n* **AnvilGUI (Embedded):** Uses modern and user-friendly interfaces to get input like amounts or player names.<\/p>\n
\n2. Ensure you have **Vault** installed on your server.
\n3. (Optional) Install **PlaceHolderAPI**.
\n4. Place the downloaded `.jar` file into your server’s `plugins\/` folder.
\n5. Start the server. The plugin will generate `config.yml`, `messages.yml`, `menus.yml`, and `limits.yml` in the `plugins\/BenthKese\/` directory.
\n6. Customize the configuration files to your liking and use `\/bka reload` to apply the changes instantly.<\/p>\n
\n| Command | Description | Permission |
\n| — | — | — |
\n| `\/kese` | Opens the main GUI menu. | `benthkese.command.gui` |
\n| `\/kese help` | Shows the help menu. | `benthkese.command.help` |
\n| `\/kese deposit [amount|hand|inventory]` | Deposits items into the pouch. | `benthkese.command.koy` |
\n| `\/kese withdraw [amount]` | Withdraws items from the pouch. | `benthkese.command.al` |
\n| `\/kese send
\n| `\/kese limit` | Shows info about all limit levels. | `benthkese.command.limit.info` |
\n| `\/kese limit status` | Shows your personal limit status. | `benthkese.command.limit.gor` |
\n| `\/kese limit upgrade` | Upgrades your limit level. | `benthkese.command.limit.yukselt`|
\n| `\/kese interest` | Opens the Time Deposit System menu. | `benthkese.command.faiz` |
\n| `\/kese interest create
\n| Command | Description | Permission |
\n| — | — | — |
\n| `\/bka reload` | Reloads the plugin’s configuration files. | `benthkese.admin.reload` |
\n| `\/bka limit set
\n| `\/bka balance
\n| Placeholder | Description |
\n| — | — |
\n| `%benthkese_bakiye_formatted%` | Shows the player’s current balance, formatted (`1,234 \u26c1`). |
\n| `%benthkese_bakiye_raw%` | Returns the player’s raw balance as a number (`1234.56`). |
\n| `%benthkese_limit_seviye_adi%` | Returns the name of the player’s current limit level. |
\n| `%benthkese_limit_seviye_id%` | Returns the numeric ID of the player’s current limit level. |
\n| `%benthkese_limit_gonderme_kalan%` | Returns the player’s remaining daily send limit. |
\n| `%benthkese_limit_gonderme_kullanilan%` | Shows the amount sent by the player today. |
\n| `%benthkese_limit_gonderme_max%` | Shows the player’s maximum daily send limit. |
\n| `%benthkese_limit_alma_kalan%` | Returns the player’s remaining daily receive limit. |
\n| `%benthkese_limit_reset_suresi%` | Shows the time remaining until daily limits reset. |
\n| `%benthkese_limit_sonraki_seviye_adi%` | Returns the name of the next limit level. |
\n| `%benthkese_limit_sonraki_seviye_ucret%` | Returns the cost to upgrade to the next level. |
\n| `%benthkese_limit_sonraki_seviye_ilerleme%`| Shows the player’s progress to the next level as a percentage.|
\n| `%benthkese_limit_yukseltebilir_mi%` | Shows if the player can afford to upgrade (`Yes`\/`No`). |<\/p>\n
\n| Placeholder | Description |
\n| — | — |
\n| `%benthkese_faiz_hesap_sayisi%` | Shows the number of the player’s active time deposit accounts. |
\n| `%benthkese_faiz_hesap_durum%` | Shows the account status in `current \/ max` format. |
\n| `%benthkese_faiz_yatirim_toplam%` | Shows the total principal amount in all of the player’s time deposits. |
\n| `%benthkese_faiz_sonraki_kazanc_miktar%` | Shows the return from the next maturing account. |
\n| `%benthkese_faiz_sonraki_kazanc_sure%` | Shows when the next account will mature. |<\/p>\n
\n| Placeholder | Description |
\n| — | — |
\n| `%benthkese_toplam_islem_sayisi%` | Shows the player’s total number of transactions. |
\n| `%benthkese_gonderilen_toplam_para%` | Shows the total amount of money the player has ever sent. |
\n| `%benthkese_odenen_toplam_vergi%` | Shows the total amount of taxes the player has ever paid. |
\n| `%benthkese_siralama_bakiye%` | Shows the player’s balance rank on the server. |
\n| `%benthkese_siralama_bakiye_hedef_kalan%` | Shows the amount needed to overtake the player ranked above. |<\/p>\n
\n| Placeholder | Description |
\n| — | — |
\n| `%benthkese_top_bakiye_isim_<1-10>%` | Shows the name of the top X richest player. |
\n| `%benthkese_top_bakiye_deger_<1-10>%` | Shows the balance of the top X richest player. |
\n| `%benthkese_top_seviye_isim_<1-10>%` | Shows the name of the player with the top X highest limit level. |
\n| `%benthkese_top_seviye_deger_<1-10>%` | Shows the level name of the player with the top X highest limit level. |<\/p>\n
\n| Placeholder | Description |
\n| — | — |
\n| `%benthkese_ekonomi_item_adi%` | Shows the name of the physical item used for the economy. |
\n| `%benthkese_vergi_yatirma_oran_yuzde%` | Shows the deposit tax rate as a percentage. |
\n| `%benthkese_vergi_cekme_oran_yuzde%` | Shows the withdrawal tax rate as a percentage. |
\n| `%benthkese_vergi_gonderme_oran_yuzde%` | Shows the send tax rate as a percentage. |<\/p>\n
\n* **`messages.yml`:** All text in the plugin. Fully customizable.
\n* **`limits.yml`:** The heart of the plugin. Create your own limit levels, with custom names, costs, and values.
\n* **`menus.yml`:** Manage the appearance, layout, and text of all in-game menus.<\/p>\n
\n“`yaml
\nlimit-levels:
\n 1:
\n name: “&7Starter”
\n cost: 1000.0
\n send-limit: 5000.0
\n receive-limit: 10000.0
\n 2:
\n name: “&aMerchant”
\n cost: 5000.0
\n send-limit: 25000.0
\n receive-limit: 50000.0
\n 3:
\n name: “&dBaron”
\n cost: 0.0
\n send-limit: -1.0 # -1 means infinite limit
\n receive-limit: -1.0
\n“`<\/p>\n