XConomy - 多服经济同步插件

XConomy 是一款基础的经济系统插件，为使用 Vault API 的插件提供支持。它支持 MySQL 存储玩家数据，并能通过 BungeeCord 或 Redis 在多服务器间同步数据。

💡重要须知

• 请通过 GitHub 报告问题。
• 欢迎加入 Discord 与我们交流。
• 若服务器安装了其他 BungeeCord 同步插件，请将其 Vault 功能设置为 false。

版本区别

• Bukkit 版本：不支持 Folia 服务端。
• Paper 版本：仅支持 1.20+ 的 Paper 或 Folia 服务端。

🎮功能特性

• 基础经济系统，兼容 Vault API。
• 支持 MySQL 存储玩家数据。
• 支持通过 BungeeCord 或 Redis 进行跨服数据同步。
• 支持 PlaceholderAPI，提供丰富的占位符。
• 可配置的货币格式、税率、初始金额等。
• 支持非玩家账户（如用于 Towny、Factions 等插件）。
• 可记录交易流水（仅 MySQL）。
• 提供离线支付提示功能。

🔧命令列表

玩家命令

• balance 或 money - 查看自己的余额。
• balance <玩家名> 或 money <玩家名> - 查看指定玩家的余额。
• pay <玩家名> <金额> - 向指定玩家支付金额。
• balancetop - 查看财富排行榜 TOP10。
• paytoggle - 切换是否接受他人付款。
• xconomy help - 查看帮助。

管理员命令 (OP)

• balance give <玩家名> <金额> - 给予玩家金额。
• balance take <玩家名> <金额> - 扣除玩家金额。
• balance set <玩家名> <金额> - 设置玩家的余额。
• balance give * <all/online> <金额> <原因> - 给予所有/在线玩家金额。
• balance take * <all/online> <金额> <原因> - 扣除所有/在线玩家金额。
• balancetop hide/display <玩家名> - 在排行榜中隐藏或显示玩家。
• paytoggle <玩家名> - 切换指定玩家是否接受付款。
• paypermission set <玩家名> true/false - 设置玩家的支付权限（* 代表全局设置）。
• paypermission remove <玩家名> - 将玩家的支付权限重置为默认。
• xconomy reload - 重载 message.yml 配置文件。
• xconomy deldata <玩家名> - 删除玩家的数据。

✨权限节点

• xconomy.user.balance - 允许玩家查看自己及他人的余额。
• xconomy.user.balance.other - 允许玩家查看他人的余额。
• xconomy.user.pay - 允许玩家向他人转账。
• xconomy.user.pay.receive - 允许玩家接收他人付款（需要 LuckPerms 插件）。
• xconomy.user.balancetop - 允许玩家查看 TOP10 排行榜。
• xconomy.user.paytoggle - 允许玩家切换是否接受付款。
• xconomy.admin.give - 允许管理员给予玩家余额。
• xconomy.admin.take - 允许管理员扣除玩家余额。
• xconomy.admin.set - 允许管理员设置玩家余额。
• xconomy.admin.balancetop - 允许管理员在排行榜中隐藏或显示玩家。
• xconomy.admin.paytoggle - 允许管理员设置玩家是否接受付款。
• xconomy.admin.permission - 允许管理员设置支付权限。
• xconomy.admin.hidden - 在 Tab 列表中隐藏。

❓前置需求

• Vault 或 Enterprise 插件。
• 若 MySQL 版本高于 8.0，且服务端版本低于 1.17.X，则需要安装 DatabaseDrivers。

⭐配置摘要

配置文件主要包括 config.yml、message.yml 和 database.yml。

config.yml 核心选项

• UUID-mode：玩家 UUID 识别模式 (Default/Online/Offline/SemiOnline)。
• Importdata-mode：设置为 true 时，可通过 /xconomy 命令从其他 Vault 经济插件导入数据。
• language：插件语言。
• initial-bal：玩家初始余额。
• payment-tax：转账税率（0.5 代表 50%）。
• ranking-size：排行榜显示数量（最大 100）。
• currency：可配置货币单数/复数名称、显示格式、千位分隔符等。
• SyncData：启用跨服数据同步，可选择 BungeeCord 或 Redis 通道。

message.yml

此文件用于自定义插件所有提示信息，如余额显示、排行榜标题、支付成功/失败提示等。

database.yml

• storage-type：数据库类型，可选 SQLite 或 MySQL。
• usepool：是否启用数据库连接池（需要 Java 11+ 和 slf4j 依赖）。
• 可配置 MySQL 连接参数、表后缀、连接池设置及 Redis 连接设置。

🔧BungeeCord 跨服设置

• 在子服和 BungeeCord 代理端均安装本插件。
• 在子服的 config.yml 中，将 SyncData 部分的 enable 设为 true，并选择 channel-type: BungeeCord。
• 确保子服的 spigot.yml 中 bungeecord 设置为 true。
• BungeeCord 端无需配置文件。

✨PlaceholderAPI 占位符

• %xconomy_balance% - 玩家余额（带格式）。
• %xconomy_balance_value% - 玩家余额（纯数值）。
• %xconomy_balance_formatted% - 格式化后的玩家余额。
• %xconomy_top_player_#% - 排行榜第 # 名的玩家名。
• %xconomy_top_balance_#% - 排行榜第 # 名的余额。
• %xconomy_sum_balance% - 服务器总资金。
• %xconomy_top_rank% - 指定玩家的排名。
• %xconomy_paytoggle% - 玩家是否接受付款的状态。
• %xconomy_global_paypermission% - 全局支付权限状态。
• %xconomy_paypermission% - 玩家支付权限状态。