BenthKese
高级虚拟钱袋与经济系统
BenthKese 是一款现代化的 Spigot 插件,允许玩家将贵重物品(默认为金锭)存入虚拟钱袋并提取出来,将其转换为数字货币。它不仅仅是一个简单的物品到货币的转换器,还通过完全可配置的系统为你的服务器经济增添了深度和控制力。
凭借其用户友好的菜单、强大的管理工具、透明的交易历史以及广泛的 PlaceHolderAPI 支持,BenthKese 是任何服务器经济的完美补充。
截图
主菜单
定期存款账户
快速存款
取款
交易历史
✨ 主要功能
? 玩家导向功能
- 现代化 GUI: 一个交互性强且风格独特的的主菜单,通过
/kese 访问,所有交易都可以轻松处理。
- 灵活的存款方式: 通过单个命令存入特定数量(
/kese deposit 64)、手中所有物品(/kese deposit hand)或背包中所有物品(/kese deposit inventory)。
- 智能取款: 如果背包已满,插件会退还你能携带的最大金额并通知你。
- 交易历史: 玩家可以通过 GUI 透明地查看最近 50 笔财务交易(发送、接收、升级等)。
- 安全交易: 针对高成本操作(如升级限制或取消定期存款)设有确认菜单,防止误点击。
- 即时反馈与动态 GUI:
- 转账后,玩家会通过 操作栏 (Action Bar) 立即收到当前限额状态的更新。
- 利息菜单中定期存款的剩余时间每秒动态更新,让玩家无需刷新菜单即可追踪其投资。
? 高级系统
- 基于等级的限额系统:
- 在
limits.yml 中创建完全自定义的限额等级。
- 每个等级可以拥有自己的名称、成本和每日发送/接收限额。
- 玩家可以在游戏中通过支付配置好的费用来升级他们的限额等级。
- 定期存款(利息)系统:
- 玩家可以锁定资金一段特定时间(
1d、7d 等),以根据 config.yml 中定义的利率赚取利息。
- 所有定期存款账户都可以通过专用的 GUI 轻松管理。
- 动态按钮:
- GUI 中的按钮会根据玩家的状态动态变化。例如,如果玩家没有足够的资金升级限额,按钮会变红并解释原因。
⚙️ 管理与服务器功能
- 强大的管理员命令 (
/keseadmin):
- 重载: 无需重启服务器即可立即刷新所有配置文件。
- 余额管理: 直接添加、移除或设置玩家的 Vault 余额。
- 限额管理: 即时更改玩家的限额等级。
- 灵活的数据存储:
- 选择 YAML、SQLite(默认)或 MySQL 存储以适应你的服务器需求。MySQL 支持与高性能
HikariCP 连接池配合使用。
- 完全可翻译: 通过
messages.yml 自定义插件中的每一条消息,包括颜色代码和变量。
- 完全可自定义的菜单 (
menus.yml):
- 除了
messages.yml 和 limits.yml 之外,你现在可以通过 menus.yml 文件完全控制插件中所有菜单的外观和布局。
- 调整菜单大小、标题以及按钮的材质、槽位位置、名称和描述,以匹配你的服务器主题,无需任何编码。
? 集成
- Vault (必需): 与服务器上的任何经济插件无缝协作。
- PlaceHolderAPI (可选): 提供广泛的支持占位符,用于与记分板、聊天格式和其他插件集成。
- AnvilGUI (内置): 使用现代且用户友好的界面来获取输入,如金额或玩家名称。
? 安装
- 从 Releases 页面 下载最新版本的插件 (
BenthKese-1.0.1.jar)。
- 确保你的服务器上已安装 Vault。
- (可选)安装 PlaceHolderAPI。
- 将下载的
.jar 文件放入服务器的 plugins/ 文件夹中。
- 启动服务器。插件将在
plugins/BenthKese/ 目录中生成 config.yml、messages.yml、menus.yml 和 limits.yml。
- 根据需要自定义配置文件,并使用
/bka reload 即时应用更改。
?️ 命令与权限
玩家指令 (/kese)
| 指令 |
描述 |
权限 |
/kese |
打开主 GUI 菜单。 |
benthkese.command.gui |
/kese help |
显示帮助菜单。 |
benthkese.command.help |
/kese deposit [amount|hand|inventory] |
将物品存入钱袋。 |
benthkese.command.koy |
/kese withdraw [amount] |
从钱袋中取出物品。 |
benthkese.command.al |
/kese send <player> <amount> |
向其他玩家发送货币。 |
benthkese.command.gonder |
/kese limit |
显示所有限制等级的信息。 |
benthkese.command.limit.info |
/kese limit status |
显示您的个人限制状态。 |
benthkese.command.limit.gor |
/kese limit upgrade |
升级您的限制等级。 |
benthkese.command.limit.yukselt |
/kese interest |
打开定期存款系统菜单。 |
benthkese.command.faiz |
/kese interest create <amount> <duration> |
创建一个新的定期存款账户。 |
benthkese.command.faiz.koy |
管理员指令 (/keseadmin 或 /bka)
| 指令 |
描述 |
权限 |
/bka reload |
重新加载插件的配置文件。 |
benthkese.admin.reload |
/bka limit set <player> <level> |
设置玩家的限制等级。 |
benthkese.admin.limit |
/bka balance <add|remove|set> <player> <amount> |
管理玩家的余额。 |
benthkese.admin.bakiye |
? PlaceHolderAPI 占位符
您可以在任何支持 PlaceHolderAPI 的插件中使用以下占位符。
个人余额与限制
| 占位符 |
描述 |
%benthkese_bakiye_formatted% |
显示玩家当前的余额,已格式化(1,234 ⛁)。 |
%benthkese_bakiye_raw% |
以数字形式返回玩家的原始余额(1234.56)。 |
%benthkese_limit_seviye_adi% |
返回玩家当前限制等级的名称。 |
%benthkese_limit_seviye_id% |
返回玩家当前限制等级的数值 ID。 |
%benthkese_limit_gonderme_kalan% |
返回玩家每日发送额度的剩余量。 |
%benthkese_limit_gonderme_kullanilan% |
显示玩家今日已发送的金额。 |
%benthkese_limit_gonderme_max% |
显示玩家每日发送的最大限额。 |
%benthkese_limit_alma_kalan% |
返回玩家每日接收额度的剩余量。 |
%benthkese_limit_reset_suresi% |
显示距离每日额度重置剩余的时间。 |
%benthkese_limit_sonraki_seviye_adi% |
返回下一个限制等级的名称。 |
%benthkese_limit_sonraki_seviye_ucret% |
返回升级到下一等级的费用。 |
%benthkese_limit_sonraki_seviye_ilerleme% |
以百分比形式显示玩家到达下一等级的进度。 |
%benthkese_limit_yukseltebilir_mi% |
显示玩家是否有能力升级(Yes/No)。 |
定期存款系统
| 占位符 |
描述 |
%benthkese_faiz_hesap_sayisi% |
显示玩家活跃的定期存款账户数量。 |
%benthkese_faiz_hesap_durum% |
以 当前 / 最大 格式显示账户状态。 |
%benthkese_faiz_yatirim_toplam% |
显示玩家所有定期存款中的本金总额。 |
%benthkese_faiz_sonraki_kazanc_miktar% |
显示下一个到期账户的收益金额。 |
%benthkese_faiz_sonraki_kazanc_sure% |
显示下一个账户到期的时间。 |
个人统计
| 占位符 |
描述 |
%benthkese_toplam_islem_sayisi% |
显示玩家的总交易次数。 |
%benthkese_gonderilen_toplam_para% |
显示玩家历史上发送过的总金额。 |
%benthkese_odenen_toplam_vergi% |
显示玩家历史上缴纳的总税额。 |
%benthkese_siralama_bakiye% |
显示玩家在服务器上的余额排名。 |
%benthkese_siralama_bakiye_hedef_kalan% |
显示超过上一名玩家所需的金额。 |
服务器排行榜(需要 SQL)
| 占位符 |
描述 |
%benthkese_top_bakiye_isim_<1-10>% |
显示前 X 名最富有玩家的姓名。 |
%benthkese_top_bakiye_deger_<1-10>% |
显示前 X 名最富有玩家的余额。 |
%benthkese_top_seviye_isim_<1-10>% |
显示拥有最高限制等级的前 X 名玩家的姓名。 |
%benthkese_top_seviye_deger_<1-10>% |
显示拥有最高限制等级的前 X 名玩家的等级名称。 |
服务器信息
| 占位符 |
描述 |
%benthkese_ekonomi_item_adi% |
显示用于经济的实体物品的名称。 |
%benthkese_vergi_yatirma_oran_yuzde% |
显示存款税率为百分比。 |
%benthkese_vergi_cekme_oran_yuzde% |
显示取款税率为百分比。 |
%benthkese_vergi_gonderme_oran_yuzde% |
显示转账税率为百分比。 |
⚙️ 配置
该插件附带四个主要配置文件:
config.yml: 主要设置。在此处管理存储类型、经济物品、税率和利率。
messages.yml: 插件中的所有文本。完全可自定义。
limits.yml: 插件的核心。创建您自己的限制等级,具有自定义名称、费用和数值。
menus.yml: 管理所有游戏内菜单的外观、布局和文本。
limits.yml 示例结构:
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 表示无限限额
receive-limit: -1.0
? 支持与贡献
如果您发现错误或想要建议新功能,请使用项目 GitHub 上的 Issues 标签。欢迎提交拉取请求 (Pull requests)。
? 许可证
本项目根据 MIT 许可证授权。有关更多详细信息,请参阅 LICENSE 文件。
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
- Download the latest version of the plugin (
BenthKese-1.0.1.jar) from the Releases page.
- Ensure you have Vault installed on your server.
- (Optional) Install PlaceHolderAPI.
- Place the downloaded
.jar file into your server's plugins/ folder.
- Start the server. The plugin will generate
config.yml, messages.yml, menus.yml, and limits.yml in the plugins/BenthKese/ directory.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧