BenthKese

Minecraft 版本： 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit folia paper purpur spigot

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.

✨ 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)

Admin Commands (/keseadmin or /bka)

? PlaceHolderAPI Placeholders

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

Personal Balance & Limits

Time Deposit System

Personal Statistics

Server Leaderboards (SQL Required)

Server Information

⚙️ 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.