BenthKese

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.

Screenshots

Main Menu

Time Deposit Account

Quick Deposit

Withdraw Money

Transaction History

✨ 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 Releases page.
2. Ensure you have Vault installed on your server.
3. (Optional) Install PlaceHolderAPI.
4. Place the downloaded .jar file into your server's plugins/ folder.
5. Start the server. The plugin will generate config.yml, messages.yml, menus.yml, and limits.yml in the plugins/BenthKese/ directory.
6. Customize the configuration files to your liking and use /bka reload to apply the changes instantly.

🛠️ Commands & Permissions

Player Commands (/kese)

Command	Description	Permission
/kese	Opens the main GUI menu.	benthkese.command.gui
/kese help	Shows the help menu.	benthkese.command.help
/kese deposit [amount|hand|inventory]	Deposits items into the pouch.	benthkese.command.koy
/kese withdraw [amount]	Withdraws items from the pouch.	benthkese.command.al
/kese send <player> <amount>	Sends money to another player.	benthkese.command.gonder
/kese limit	Shows info about all limit levels.	benthkese.command.limit.info
/kese limit status	Shows your personal limit status.	benthkese.command.limit.gor
/kese limit upgrade	Upgrades your limit level.	benthkese.command.limit.yukselt
/kese interest	Opens the Time Deposit System menu.	benthkese.command.faiz
/kese interest create <amount> <duration>	Creates a new time deposit account.	benthkese.command.faiz.koy

Admin Commands (/keseadmin or /bka)

Command	Description	Permission
/bka reload	Reloads the plugin's configuration files.	benthkese.admin.reload
/bka limit set <player> <level>	Sets a player's limit level.	benthkese.admin.limit
/bka balance <add|remove|set> <player> <amount>	Manages a player's balance.	benthkese.admin.bakiye

📊 PlaceHolderAPI Placeholders

You can use the following placeholders in any plugin that supports PlaceHolderAPI.

Personal Balance & Limits

Placeholder	Description
%benthkese_bakiye_formatted%	Shows the player's current balance, formatted (1,234 ⛁).
%benthkese_bakiye_raw%	Returns the player's raw balance as a number (1234.56).
%benthkese_limit_seviye_adi%	Returns the name of the player's current limit level.
%benthkese_limit_seviye_id%	Returns the numeric ID of the player's current limit level.
%benthkese_limit_gonderme_kalan%	Returns the player's remaining daily send limit.
%benthkese_limit_gonderme_kullanilan%	Shows the amount sent by the player today.
%benthkese_limit_gonderme_max%	Shows the player's maximum daily send limit.
%benthkese_limit_alma_kalan%	Returns the player's remaining daily receive limit.
%benthkese_limit_reset_suresi%	Shows the time remaining until daily limits reset.
%benthkese_limit_sonraki_seviye_adi%	Returns the name of the next limit level.
%benthkese_limit_sonraki_seviye_ucret%	Returns the cost to upgrade to the next level.
%benthkese_limit_sonraki_seviye_ilerleme%	Shows the player's progress to the next level as a percentage.
%benthkese_limit_yukseltebilir_mi%	Shows if the player can afford to upgrade (Yes/No).

Time Deposit System

Placeholder	Description
%benthkese_faiz_hesap_sayisi%	Shows the number of the player's active time deposit accounts.
%benthkese_faiz_hesap_durum%	Shows the account status in current / max format.
%benthkese_faiz_yatirim_toplam%	Shows the total principal amount in all of the player's time deposits.
%benthkese_faiz_sonraki_kazanc_miktar%	Shows the return from the next maturing account.
%benthkese_faiz_sonraki_kazanc_sure%	Shows when the next account will mature.

Personal Statistics

Placeholder	Description
%benthkese_toplam_islem_sayisi%	Shows the player's total number of transactions.
%benthkese_gonderilen_toplam_para%	Shows the total amount of money the player has ever sent.
%benthkese_odenen_toplam_vergi%	Shows the total amount of taxes the player has ever paid.
%benthkese_siralama_bakiye%	Shows the player's balance rank on the server.
%benthkese_siralama_bakiye_hedef_kalan%	Shows the amount needed to overtake the player ranked above.

Server Leaderboards (SQL Required)

Placeholder	Description
%benthkese_top_bakiye_isim_<1-10>%	Shows the name of the top X richest player.
%benthkese_top_bakiye_deger_<1-10>%	Shows the balance of the top X richest player.
%benthkese_top_seviye_isim_<1-10>%	Shows the name of the player with the top X highest limit level.
%benthkese_top_seviye_deger_<1-10>%	Shows the level name of the player with the top X highest limit level.

Server Information

Placeholder	Description
%benthkese_ekonomi_item_adi%	Shows the name of the physical item used for the economy.
%benthkese_vergi_yatirma_oran_yuzde%	Shows the deposit tax rate as a percentage.
%benthkese_vergi_cekme_oran_yuzde%	Shows the withdrawal tax rate as a percentage.
%benthkese_vergi_gonderme_oran_yuzde%	Shows the send tax rate as a percentage.

⚙️ Configuration

The plugin comes with four main configuration files:

• config.yml: Main settings. Manage storage type, economy item, taxes, and interest rates here.
• messages.yml: All text in the plugin. Fully customizable.
• limits.yml: The heart of the plugin. Create your own limit levels, with custom names, costs, and values.
• menus.yml: Manage the appearance, layout, and text of all in-game menus.

Example limits.yml structure:

limit-levels:
  1:
    name: "&7Starter"
    cost: 1000.0
    send-limit: 5000.0
    receive-limit: 10000.0
  2:
    name: "&aMerchant"
    cost: 5000.0
    send-limit: 25000.0
    receive-limit: 50000.0
  3:
    name: "&dBaron"
    cost: 0.0 
    send-limit: -1.0 # -1 means infinite limit
    receive-limit: -1.0

🤝 Support & Contribution

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.

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.