原创 工具 经济 Ecolink - 异步多货币经济插件 | Vault兼容 | SQLite/PostgreSQL/MySQL | Folia支持 1.0

Ecolink 是什么？​

核心特性​

• 异步经济读写：余额查询、流水、迁移、排行榜等数据库操作走异步线程池，避免主线程阻塞。
• 多货币模型：支持 coins、gems、tokens 等多货币配置，可控制是否允许转账、是否显示、是否参与排行榜、是否作为 Vault 主货币。
• Vault 兼容：安装 Vault 后可提供 `/money`、`/balance`、`/pay`、`/baltop` 等主货币命令，并注册 Vault Economy Provider。
• Folia 兼容：主线程边界通过调度器处理，插件声明 `folia-supported: true`。
• 幂等充值：支持事务号去重，适合商城、Webhook、人工补单等场景。
• 商品系统：独立 `shop.yml` 配置商品，购买后可执行控制台命令发放奖励。
• 数据迁移：支持从 CMI、EssentialsX 导入经济数据，并支持迁移到远端 PostgreSQL / MySQL。
• 语言系统：内置中文与英文语言文件，消息使用 MiniMessage 格式。

数据库支持​

• SQLite：默认开箱即用，适合单服或测试服。
• PostgreSQL：推荐生产环境使用，跨服和审计场景更稳定。
• MySQL：兼容已有 MySQL 基础设施。

主要命令​

多货币命令​

/el me
/el buy <商品>
/el top <货币> [页码]
/el pay <玩家> <货币> <数量>
/el create <货币>
/el give <玩家> <货币> <数量>
/el set <玩家> <数量> [货币]
/el add <玩家> <数量> [货币]
/el take <玩家> <数量> [货币]
/el reset <玩家> <货币>
/el delete <货币>
/el ledger [玩家] [货币] [页码]
/el recharge <玩家> <货币> <数量> <事务号> [来源标签...]
/el migrate <cmi|essentials|all|storage> [overwrite]
/el currencies
/el reload

Vault 主货币命令​

/money
/money <玩家>
/money pay <玩家> <数量>
/money top [页码]
/money give <玩家> <数量>
/money set <玩家> <数量>
/money take <玩家> <数量>
/balance [玩家]
/pay <玩家> <数量>
/baltop [页码]

权限节点​

ecolink.pay              默认玩家可用
ecolink.balance.others   默认 OP
ecolink.ledger           默认 OP
ecolink.ledger.others    默认 OP
ecolink.recharge         默认 OP
ecolink.migrate          默认 OP
ecolink.admin            默认 OP

安装方法​

1. 将 `Ecolink-0.1.0-SNAPSHOT.jar` 放入服务器 `plugins` 文件夹。
2. 启动服务器生成配置文件。
3. 按需安装 Vault / PlaceholderAPI 。
4. 如需生产环境数据库，将 `config.yml` 中的 `storage.type` 改为 `postgresql` 或 `mysql` 并填写连接信息。
5. 执行 `/el reload` 或重启服务器加载配置。

默认配置文件​

• `config.yml`：核心配置、数据库、多货币、兼容设置、迁移设置。
• `shop.yml`：商品配置。
• `lang/zh_CN.yml`、`lang/en_US.yml`：语言文件。