重要提示
本插件需要 Vault 才能正常运行！
TheosisEconomy 是一款基于 Vault 的经济插件，旨在提供简洁、强大且高度可定制的经济系统。它避免了不必要的臃肿功能，专注于核心经济管理，并允许你自定义货币的方方面面，从名称、格式到排行榜规则。
核心特性
- 高度可定制：几乎所有内容都可配置。
- 自定义货币：
- 设置玩家首次加入时的默认余额。
- 设置货币的最大余额上限。
- 自定义货币使用的小数位数。
- 自定义货币的单数/复数名称。
- 自定义货币的显示格式。
- 异步排行榜：拥有完全可定制的
/balancetop命令，排序过程异步进行，避免服务器卡顿。 - MiniMessage 支持：所有聊天信息均使用 MiniMessage 格式，可自由定制样式。
- API 与事件：为其他插件提供了 API 和可监听的事件。
- PlaceholderAPI 支持：提供丰富的占位符。
玩家命令
/balance或/bal或/money [玩家名]
查看自己或他人的余额。
/balancetop或/baltop [页码]
查看从富有到贫穷的玩家余额排行榜。
/pay <玩家> <金额>
向另一名玩家支付指定金额。
/paytoggle
切换是否接受来自其他玩家的 /pay 付款。
管理员命令
/economy或/eco
显示 /economy 命令的帮助信息。
/economy set <玩家> <金额>
将指定玩家的余额设置为指定金额。
/economy give <玩家> <金额>
向指定玩家的余额增加指定金额。
/economy take <玩家> <金额>
从指定玩家的余额中扣除指定金额。
/economy reset <玩家>
将指定玩家的余额重置为配置的默认余额。
/economy reload
重载插件配置和数据。
权限节点
默认授予的权限
theosiseconomy.command.balance
使用 /balance 命令。
theosiseconomy.command.balance.others
使用 /balance [玩家名] 查看他人余额。
theosiseconomy.command.balancetop
使用 /balancetop 命令。
theosiseconomy.command.pay
使用 /pay 命令。
theosiseconomy.command.paytoggle
使用 /paytoggle 命令。
默认未授予的权限
theosiseconomy.balancetop.exclude
拥有此权限的玩家将从 /balancetop 排行榜中排除（需在配置中启用）。
theosiseconomy.command.*
使用所有 TheosisEconomy 命令。
theosiseconomy.command.economy.*
使用 /economy 及其所有子命令。
theosiseconomy.command.economy
使用 /economy 命令。
theosiseconomy.command.economy.set
使用 /economy set 命令。
theosiseconomy.command.economy.give
使用 /economy give 命令。
theosiseconomy.command.economy.take
使用 /economy take 命令。
theosiseconomy.command.economy.reset
使用 /economy reset 命令。
theosiseconomy.command.economy.reload
使用 /economy reload 命令。
PlaceholderAPI 占位符
TheosisEconomy 提供以下 PlaceholderAPI 占位符：
%theosiseconomy_accepting_payments%%theosiseconomy_richest_<位置>_name%%theosiseconomy_richest_<位置>_uuid%%theosiseconomy_richest_<位置>_balance%%theosiseconomy_richest_<位置>_balance_formatted%%theosiseconomy_richest_<位置>_entry%%theosiseconomy_richest_<位置>_entry_legacy%%theosiseconomy_combined_total_balance%%theosiseconomy_combined_total_balance_formatted%
请注意：其他常见的经济占位符（如玩家余额）已由 Vault 提供。详情请见：PlaceholderAPI Vault 占位符列表。
API
TheosisEconomy 提供以下事件供其他插件监听：
PlayerPayPlayerEventPreBaltopSortEvent
要监听这些事件，你需要将 TheosisEconomy 的 jar 文件添加到你的插件构建路径中。
配置概览 (`config.yml`)
配置文件结构清晰，主要分为 settings（设置）和 messages（消息）两大部分，所有消息均支持 MiniMessage 格式。
主要配置项
货币设置 (settings.currency)：
default-balance：新玩家初始余额，也是/economy reset的复位值。max-balance：玩家最大余额上限（受小数位数影响，请仔细阅读配置内注释）。decimal-places：货币使用的小数位数。name-singular/name-plural：货币的单数/复数名称。format：货币显示格式，支持<amount>和<name>占位符。rounding-mode：超出小数位时的舍入模式（NONE,ROUND_NEAREST,ROUND_UP,ROUND_DOWN）。
排行榜设置 (settings.baltop)：
update-task-frequency：更新排行榜排序的频率（单位：刻，20刻=1秒）。page-length：每页显示的条目数。min-balance：上榜所需的最低余额。consider-exclude-permission：是否考虑theosiseconomy.balancetop.exclude权限以排除玩家。exclude-banned-players：是否从排行榜中排除被封禁的玩家（支持原版封禁和 LiteBans）。
日志记录 (settings.logging)：
- 可详细配置各种操作（如账户创建、余额设置、Vault 存取款等）是否记录到控制台或文件，并自定义日志消息格式。
**消息定制 (`messages`)**
- 所有命令的反馈消息、错误提示均可在此部分使用 MiniMessage 语法进行完全自定义。
常见问题与支持
- 演示服务器：你可以在我的非付费赢取（Pay-to-Win）硬核生存服务器体验本插件：
hardcore-smp.com - 问题与反馈：如果你有任何疑问、需要支持或发现了任何漏洞，请不要在评论中求助。请使用插件页面的“讨论（Discussion）”板块或直接与我发起对话，我会尽快回复你。
