TheosisEconomy - TheosisEconomy

💡重要提示

本插件需要 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 提供以下事件供其他插件监听：

• PlayerPayPlayerEvent
• PreBaltopSortEvent

要监听这些事件，你需要将 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）”板块或直接与我发起对话，我会尽快回复你。