Economy - 经济系统

Economy 是一款简单轻量的经济插件，支持将玩家数据保存在本地或 MySQL 数据库中，并允许完全自定义消息，且不包含任何插件名称的品牌标识。

💡核心特性

• 轻量且简单：专注于提供核心经济功能，不包含复杂冗余的特性。
• 数据存储灵活：支持本地文件存储和 MySQL 数据库存储。
• 完全自定义消息：所有提示消息均可通过配置文件自定义，无任何强制品牌标识。
• 占位符支持：通过 PlaceholderAPI 的 Vault 占位符提供支持。
• 货币格式自定义：可自定义货币名称、符号、起始金额及显示格式。

依赖要求

• 必需插件：Vault。没有 Vault 插件将无法运行。
• 可选插件：PlaceholderAPI。用于支持经济相关的占位符。

🎮命令与权限

所有命令均支持 Tab 自动补全。

玩家命令

• /balance (/bal)
• 权限：economy.command.balance
• 查看自己或他人的余额。
• /balancetop (/baltop)
• 权限：economy.command.balancetop
• 查看财富排行榜。
• /pay
• 权限：economy.command.pay
• 向其他玩家支付金钱。

管理员命令

• /money (/eco, /economy)
• 权限：economy.command.help
• 显示帮助信息。
• /money help
• 权限：economy.command.help
• 显示详细的命令帮助。
• /money give
• 权限：economy.command.give
• 给予玩家金钱。
• /money take (/money remove)
• 权限：economy.command.take
• 扣除玩家金钱。
• /money set
• 权限：economy.command.set
• 设置玩家的金钱数额。
• /money reload (/money rl)
• 权限：economy.command.reload
• 重载插件配置文件。

> 注意：/money reload 命令不会重载 MySQL 数据库连接。更改 MySQL 配置后需要重启服务器才能生效。

🔧配置说明

配置文件为 config.yml，主要配置项如下：

基础设置

• BalanceTopTimerInterval: 排行榜数据更新间隔（单位：刻，20刻=1秒）。默认：1200（1分钟）。
• currencyNameSingular: 货币单数名称。默认："Dollar"。
• currencyNamePlural: 货币复数名称。默认："Dollars"。
• startingBalance: 玩家的初始余额。默认：100.00。
• locale: 货币显示格式的地区代码。默认："en-US"。
• 可参考 语言标签示例 进行修改。
• customSymbolEnabled: 是否启用自定义货币符号。默认：false。
• customSymbol: 自定义货币符号。若 Minecraft 不支持该符号，可能需要使用 Unicode 格式（例如 \u26C3 代表美元符号）。

MySQL 设置

• use-mysql: 是否启用 MySQL 存储。默认：false（使用本地文件存储）。
• host: 数据库地址。
• port: 数据库端口。
• database: 数据库名称。
• username: 数据库用户名。
• password: 数据库密码。

数值后缀

用于在排行榜等处简化大数字的显示（例如 1000 显示为 1k）。amount 是原始数值乘以 10 的 number 次方。

• k 或 K: 对应 10^3 (1,000)
• m 或 M: 对应 10^6 (1,000,000)
• b 或 B: 对应 10^9 (1,000,000,000)
• t 或 T: 对应 10^12 (1,000,000,000,000)
• q 或 Q: 对应 10^15 (1,000,000,000,000,000)

消息自定义

所有消息均在 messages: 节点下配置。消息支持颜色代码（使用 & 符号）和以下变量：

• %prefix%: 消息前缀。
• %player%: 玩家名。
• %balance%: 余额。
• %amount%: 涉及金额。
• %total%: 涉及玩家总数。
• %rank%: 排行榜名次。
• %top%: 输入的排行榜页码。

您可以自由修改任何消息的文本和颜色，以实现无品牌化的完全自定义。

❓常见问题

• 如何安装？
• 确保服务器已安装 Vault。
• 将 Economy 插件放入 plugins 文件夹。
• 启动服务器以生成配置文件。
• 根据需要编辑 config.yml。
• 使用 /money reload 或重启服务器使配置生效。

• 如何与 PlaceholderAPI 集成？

本插件通过 Vault 提供经济数据。只需安装 PlaceholderAPI 和 Vault，PlaceholderAPI 会自动识别并注册 Vault 的经济占位符（如 %vault_eco_balance%）。

• 支持多语言吗？

插件本身不内置多语言包，但您可以通过修改 config.yml 中的 messages 部分和 locale 设置，来自定义所有消息文本和货币显示格式，从而适配任何语言。

• 有更新计划吗？

开发者表示目前功能已完备。如果您有好的建议，可以反馈给开发者。

⭐注意事项

• 本插件的正常运行强制依赖 Vault。
• 重载配置 (/money reload) 时，MySQL 数据库连接不会刷新。修改 MySQL 设置后必须重启服务器。
• 自定义货币符号时，若遇到显示问题，请尝试使用 Unicode 转义格式（如 \u00A5 代表日元符号¥）。