Coins [ABANDONED] - Coins - 经济管理插件

Coins 是一款功能全面、性能高效的插件，专为管理服务器副经济系统而设计。它拥有大量可自定义的功能，支持多语言消息、跨服同步、API 集成等，能够满足各类服务器的经济管理需求。

💡主要特性

• 高度可定制：所有消息、命令均可配置，甚至可自定义主命令名称。
• 多语言支持：根据玩家客户端语言自动匹配消息文件，未匹配时回退至默认 messages.yml。
• BungeeCord 支持：可将插件安装在 BungeeCord 端以使用 API。
• 命令成本：可为特定命令设置使用费用（消耗硬币）。
• 命令执行器：可创建需支付硬币才能执行的命令列表（支持在 BungeeCord 配置中全局设置）。
• 告示牌执行器：可在告示牌上使用执行器功能。
• PlaceholderAPI 支持：提供丰富的占位符。
• Vault 支持：可管理全服经济，并支持跨服同步。
• 倍数系统：可为玩家添加权限以获得更多硬币，或创建全服范围、有时限的全局倍数。
• 内部日志：内置日志系统，便于快速定位错误。
• 异步任务：所有任务均异步运行，确保性能。
• 数据导入：支持从 PlayerPoints 插件导入数据。
• LeaderHeads 支持：与 LeaderHeads 插件兼容。
• 自动下载依赖：所需依赖会自动下载。
• 轻量高效：插件本身非常轻量，对服务器性能影响极小。

🎮命令列表

玩家命令

• /coins help - 显示所有命令。
• /coins - 查看自己的硬币数量。
• /coins <玩家名> - 查看其他玩家的硬币数量。
• /coins pay <玩家名> <数量> - 向其他玩家支付硬币。
• /coins top - 显示硬币数量前十的玩家排行榜。
• /coins multipliers - 打开 GUI 查看你所有的倍数效果。

管理员命令

• /coins give <玩家名> <数量> (true) - 给予玩家硬币。若在末尾添加 true，则会计算权限和服务器倍数。
• /coins take <玩家名> <数量> - 扣除玩家硬币。若扣除数量大于玩家持有量，硬币将被设为 0。
• /coins set <玩家名> <数量> - 设置玩家的硬币数量。
• /coins reset <玩家名> - 将玩家的硬币重置为配置文件中定义的默认数量。
• /coins reload - 重载配置文件及所有已加载的消息文件。
• /coins about - 显示服务器设置、插件版本、数据库及已加载执行器的信息。
• /coins import - 从其他插件导入数据。
• /coins importdb - 从其他存储（SQLite 或 MySQL）导入数据。
• /coins multipliers help - 显示关于倍数系统的相关命令。

🔧权限节点

• coins.admin - 授予所有管理员命令的使用权限。
• coins.multiplier.x<2-100> - 个人倍数权限，数值范围可在 2 到 100 之间。

✨前置需求

• Java 8 或更高版本。
• PlaceholderAPI（可选，用于使用下方列出的占位符）。
• Vault（可选，仅在希望本插件管理 Vault 经济系统时需要）。

⭐配置摘要

配置文件 (config.yml) 允许你自定义插件行为，主要部分包括：

• 版本与前缀：配置版本号（请勿手动修改）及消息前缀。
• 在线模式：通常保持为 true。仅在特定 BungeeCord 网络环境下或服务器为离线模式时才需设为 false。
• Vault 集成：可启用并设置货币的单复数名称。
• MySQL 设置：配置数据库连接以实现跨服数据同步。
• 通用设置：

- 设置新玩家的初始硬币数量。

- 自定义主命令的名称、描述、用法、权限及别名。

- 启用自动清理不活跃账户。

• 命令成本：可为任意命令设置使用费用。
• 命令执行器：可创建需支付硬币才能触发的控制台命令列表，支持 %player% 占位符。特殊命令类型包括 message:（向玩家发送消息）和 broadcast:（向全服广播）。
• 告示牌执行器：可为特定执行器自定义告示牌显示文本。
• 倍数系统：配置倍数 GUI 的界面、音效及服务器标识符。
• 调试模式：启用后会在控制台输出更详细的日志，便于排查问题。

❓PlaceholderAPI 占位符

需要安装 PlaceholderAPI 才能使用以下占位符：

• %coins_amount% - 显示玩家的硬币数量。
• %coins_amount_formatted% - 显示格式化后的硬币数量。
• %coins-multipliers_amount_<server>% - 显示指定服务器的倍数数值（服务器名在配置中定义）。
• %coins-multipliers_enabler_<server>% - 显示指定服务器的倍数启用者。
• %coins-multipliers_time_<server>% - 显示指定服务器倍数的剩余时间，格式为（天数, ）时:分:秒。

🔧兼容插件

以下插件已支持 Coins

• SkyWars
• Animated Menu
• Marcelys BedWars - Coins and Nick Addon
• SkyBlockEarth

如果你开发了支持 Coins 的插件，欢迎通过私信联系作者。

⭐支持的语言

插件内置以下语言，你也可以通过创建 messages_<语言代码>.yml 文件来添加更多语言（语言代码采用 ISO 639-1 标准）：

• 英语
• 西班牙语
• 中文（感谢 @mcryuki）
• 捷克语（感谢 @KevinYouTube）
• 俄语（感谢 @Bogdan2402）
• 匈牙利语（感谢 montlikadani）

以下由用户翻译的语言尚未包含在最新发布版本中，但同样可以使用：

• 印度尼西亚语（感谢 YumeMugen）

如果你想翻译插件到其他语言，请将翻译文件通过私信发送给作者。

✨使用告示牌执行器

要使用告示牌执行器，你需要创建一个告示牌，并按配置文件中 Executor Sign 部分定义的格式填写文本。所有文本都将被替换为配置中设定的内容。

🎮相关链接

• GitHub：查看源代码或提交问题。
• API：开发者集成指南。

❓支持与问题反馈

如果你需要帮助或遇到插件问题，可以通过以下方式联系：

• 在讨论区发帖。
• 给作者发送私信。
• 在 GitHub 上提交 issue。