CoinsAPI - 金币管理插件 支持Vault与PlaceholderAPI

CoinsAPI 是一款面向服务器管理员和开发者的多功能硬币管理插件。它不仅提供基础的硬币增减功能，还拥有强大的开发者 API，支持跨服数据同步与深度自定义，助你轻松构建经济系统。

💡核心特色

CoinsAPI 并非普通的 API，它具备许多独特功能：

• MySQL 支持：所有玩家的硬币数据均存储在数据库中。只要接入同一数据库，数据可在多个服务器间同步调用。
• Hex 颜色代码：支持使用 Hex 颜色代码，让你能更好地自定义插件的视觉设计。
• 丰富的命令：提供添加、移除、重置硬币等命令，并且所有命令均支持在控制台执行。
• 开发者 API：提供直接访问数据库硬币数据或当前会话硬币的 API。同时还包含多种事件，供开发者进行创意扩展。
• Vault 支持：可与其他经济插件兼容，CoinsAPI 已内置 Vault 支持。
• 数字格式化：硬币显示格式经过特别优化，例如会显示为 1.000 而非 1000，更易阅读。
• UUID 支持：玩家在数据库中通过 UUID 而非名称保存，即使玩家更改游戏名也不会丢失数据。
• 可编辑消息：所有消息都可在 Messages.yml 文件中配置，包括是否启用支付命令。
• PlaceholderAPI 支持：插件支持 PlaceholderAPI，可使用以下占位符：

- `%CoinsAPINB_coinsdb%`：直接从数据库获取硬币数。

- `%CoinsAPINB_coins%`：从当前会话获取硬币数。

🎮命令列表

• /Coins — 查看自己当前的硬币数量。
• /Coins [玩家] — 查看指定玩家当前的硬币数量。
• /Coins [玩家] reset — 重置指定玩家的硬币。
• /Coins [玩家] pay [数量] — 向其他玩家支付硬币。
• /Coins [玩家] [add | remove | set] [数量] — 管理玩家的硬币（增加/移除/设置）。
• /Coins reload — 重载所有配置设置。
• /Pay [玩家] [数量] — 向其他玩家支付硬币（快捷命令）。

🔧权限节点

• coinsapi.showcoins — 允许查看玩家当前硬币数量。
• coinsapi.editcoins — 允许编辑玩家的硬币。
• coinsapi.reset — 允许重置玩家的硬币。
• coinsapi.pay — 允许向其他玩家支付硬币。
• coinsapi.checkupdate — 接收插件更新通知。

✨安装与配置

运行要求

• Java 8 或更高版本。
• MySQL 数据库。
• SpigotMC 服务器，版本 1.8 至 1.20（需正版验证）。

安装步骤

• 下载插件并将其放入服务器的 plugins 文件夹。
• 重启或启动服务器。
• 在 plugins 文件夹中找到生成的 CoinsAPI 文件夹，打开其中的 MySQL.yml 文件并填入你的数据库信息。
• 再次重启服务器，并在控制台检查是否启动成功。确认无误后，进入服务器即可开始使用。

⭐开发者 API 示例

以下为 Java 代码使用示例

// 直接向数据库中的玩家添加硬币。
CoinsAPI.addCoinsDB(p.getUniqueId().toString(), 50);

// 直接从数据库中的玩家移除硬币。
CoinsAPI.removeCoinsDB(p.getUniqueId().toString(), 50);

// 将数据库中玩家的硬币设置为特定值。
CoinsAPI.setCoinsDB(p.getUniqueId().toString(), 100);

// 查询玩家在数据库中的硬币数量。
CoinsAPI.getCoinsDB(p.getUniqueId().toString());

// 向玩家（当前会话）添加硬币。
CoinsAPI.addCoins(p, 50);

// 从玩家（当前会话）移除硬币。
CoinsAPI.removeCoins(p, 50);

// 设置玩家（当前会话）的硬币数量。
CoinsAPI.setCoins(p, 50);

// 查询玩家（当前会话）拥有的硬币数量。
CoinsAPI.getCoins(p);

事件使用示例

// 当玩家的硬币数量发生变化时触发。
@EventHandler
public void on(PlayerChangeCoinsEvent e) {
    Player p = e.getPlayer();
    int amount = e.getAmount();
    p.sendMessage("你的硬币数量已变更。 (" + amount + ")");
}

// 当玩家向另一玩家支付硬币时触发。
@EventHandler
public void on(PlayerPayCoinsEvent e) {
    Player sender = e.getSender();
    Player receiver = e.getReceiver();
    int amount = e.getAmount();
    sender.sendMessage("你向 " + receiver + " 支付了 " + amount + " 硬币。");
    receiver.sendMessage("你收到了来自 " + sender + " 的 " + amount + " 硬币。");
}

❓获取支持

在寻求支持前，请先检查所有配置步骤。请勿在评论区内报告错误或提问。

支持渠道如下

• 如需讨论，可在 SpigotMC 讨论区 @Neonn_Bukkit。请注意，讨论区并非官方支持渠道。
• 对于一般帮助、技术支持或建议，请加入我们的 Discord 服务器。
• 你也可以通过 SpigotMC 站内私信联系我们，但回复可能较慢。
• 我们推荐通过 Discord 联系我们。

🔧使用条款

下载并使用 CoinsAPI 即表示你同意以下条款：

你可以：

• 在任何服务器上使用 CoinsAPI。

你禁止：

• 尝试对 CoinsAPI 或其部分源代码进行反编译或反混淆。
• 未经我们许可，将插件发布至其他网站。

我们：

• 不会为任何人（包括付费请求）修改软件，软件将保持原样。
• 保留随时更新服务条款的权利，且不一定会另行通知。