EasyEco

插件

· 作者 materiz66

Easyeco 插件,用于服务器经济系统

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

最新 1.6.2 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

EasyEco — 轻量级多货币经济系统

一款快速、现代的经济插件,支持多货币余额、交易历史、GUI 排行榜以及完整的 Vault 1 + VaultUnlocked (Vault 2) 支持。单个 JAR 文件包含所有功能——无付费版,采用 MIT 许可证。

功能特性

? 核心经济系统

  • 多货币余额(economy.currencies.* —— 符号、单/复数名称、小数格式化)
  • 初始/最小/最大余额限制,可选负余额
  • /pay 命令支持真实交易税——税收从经济系统中燃烧销毁(不重新流通),并记录为 PAY_TAX
  • 原子性、线程安全的操作,转账失败时自动回滚
  • 交易事件可被其他插件取消(EasyEcoTransactionEvent)

? 交易历史

  • /eco history <player> —— 查看最近交易,直接从数据库读取(easyeco_history 表)
  • 每笔存款/取款/设置/支付均记录类型、金额和原因
  • 默认启用(logging.log-to-database: true)——开箱即用
  • 也支持可选的文件日志记录(logs/transactions.log)

? 排行榜 GUI

  • 45 格排名 GUI,显示玩家头像并支持分页
  • 紧凑的余额格式(1.5K$、2.3M$、10B$)
  • 文本模式:/baltop 1 -text(也可从控制台执行)
  • 缓存排行榜(默认刷新间隔 60 秒,可配置)

? 世界经济

  • 按世界分组的经济系统(economy.world-economy)——不同世界组拥有独立余额
  • 自动由 Vault 和 PlaceholderAPI 查询

⚡ 性能与存储

  • RAM 缓存在线玩家数据——每次余额查询零数据库读取
  • 离线余额使用 TTL 缓存(默认 60 秒,读取时刷新)
  • 脏标记自动保存(批量插入),安全退出玩家(异步保存确认后才移除缓存条目)
  • SQLite(内置,零配置)和通过 HikariCP 连接池连接的 MySQL —— JDBC 驱动已嵌入 JAR 中,无需额外安装
  • 优雅关闭:在关闭数据库前同步刷新所有缓存余额

? 集成支持

  • Vault 1 和 VaultUnlocked (Vault 2) —— 两者均注册为经济提供商(各自可独立开关)
  • PlaceholderAPI —— 一个扩展 %easyeco_*%(见下方占位符说明)
  • bStats 和更新检查器(可选)
  • 开发者 API pl.materiz66.easyeco.api.EasyEcoAPI + 事件(EasyEcoBalanceChangeEvent, EasyEcoTransactionEvent)
  • EssentialsX 导入 —— /eco import essentials(异步、安全)

占位符(PlaceholderAPI)

占位符 返回值
%easyeco_balance% 余额,保留两位小数(1500.00)
%easyeco_balance_formatted% 紧凑余额 + 符号(1.5K$)
%easyeco_balance_world_<group/world>% 目标组或世界的余额(1500.00)
%easyeco_balance_formatted_world_<group/world>% 目标组或世界的紧凑余额(1.5K$)
%easyeco_currency_symbol% / %easyeco_currency_name% 当前活跃货币符号 / 复数名称
%easyeco_baltop_position% 排名位置(1…99, 100+)
%easyeco_baltop_name_<pos>% / %easyeco_baltop_balance_<pos>% / %easyeco_baltop_balance_formatted_<pos>% 前 100 名条目(从 1 开始索引)

命令

命令 描述 权限
/balance [player] (/bal, /money) 查看余额 easyeco.balance / easyeco.balance.others
/pay <player> <amount> 转账(含冷却时间 + 税费) easyeco.pay
/baltop [page] [-text] 排行榜 GUI / 文本输出 easyeco.baltop
`/eco give take set
/eco history <player> · /eco reload · /eco info 历史记录 / 重载 / 诊断信息 easyeco.admin.*
/eco import essentials 从 EssentialsX 导入数据 easyeco.admin.import

easyeco.admin(默认:op)包含所有 easyeco.admin.* 权限作为子权限。

要求

  • Java 21
  • Paper / Purpur 1.21+(或兼容分支)—— API 版本 1.21
  • 可选:Vault 1, VaultUnlocked, PlaceholderAPI

安装方法

  1. 下载 JAR 文件并将其放入 plugins/ 目录
  2. 重启服务器(SQLite 数据库 plugins/EasyEco/database.db 会自动创建)
  3. 完成。如需使用 MySQL,请在 config.yml 中设置 storage.type: MYSQL 并填写 storage.mysql.* 相关配置项

配置说明

所有设置位于 plugins/EasyEco/config.yml:

  • economy.* —— 货币、初始/最小/最大余额、/pay 限制与税率、冷却时间
  • storage.* —— SQLite/MySQL、HikariCP 连接池大小、自动保存间隔
  • baltop.*, vault.*, integrations.*, logging.*, messages-file, update-checker, bstats, debug

语言文件:en_us.yml(默认)、pl_pl.yml、de_de.yml —— 通过 messages-file 切换。

许可证

MIT —— 免费,永久有效。请参阅仓库中的 LICENSE 文件。

*文档由人工智能生成

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源