BenthKese

插件

· 作者 bentahsin

一款高级钱包/经济插件,通过交易限制、国库投资(利息)和完整的图形界面,增强 Towny 服务器的经济系统。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.3-b2 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

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 (内置): 使用现代且用户友好的界面来获取输入,如金额或玩家名称。

? 安装

  1. 从 Releases 页面 下载最新版本的插件 (BenthKese-1.0.1.jar)。
  2. 确保你的服务器上已安装 Vault。
  3. (可选)安装 PlaceHolderAPI。
  4. 将下载的 .jar 文件放入服务器的 plugins/ 文件夹中。
  5. 启动服务器。插件将在 plugins/BenthKese/ 目录中生成 config.yml、messages.yml、menus.yml 和 limits.yml。
  6. 根据需要自定义配置文件,并使用 /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 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源