1.21.6 - Clan Plugin v1 ( Early Beta ) + Api - Clan 插件 v1 (测试版) - 终极公会体验

ClanSystem 是一款功能强大的 Minecraft 插件，它为服务器提供了完整的公会（Clan）系统，并附带丰富的 API 供开发者集成使用。以下文档将介绍其占位符、API 使用方法和重要条款。

🎮占位符列表

ClanSystem 提供了以下 PlaceholderAPI 占位符，可用于在聊天、计分板或其他支持 PlaceholderAPI 的插件中显示公会信息。

• %clansystem_member_rank% - 显示成员在公会中的等级。
• %clansystem_tag% - 显示公会的标签。
• %clansystem_name% - 显示公会的名称。
• %clansystem_member_count% - 显示公会的成员数量。

🔧API 集成指南

如果您希望在自己的插件中使用 ClanSystem 的 API，请按以下步骤操作。

添加依赖

首先，您需要在您插件的 plugin.yml 文件中声明对 ClanSystem 的依赖。

name: YourPlugin
main: path
version: 1.0
description: Info
depend: [ClanSystem]

使用 ClanCreator 类

ClanCreator 类允许您以编程方式创建公会。以下是一个完整的 Java 代码示例，展示了如何创建公会并处理结果。

// 实例化 ClanCreator 对象
ClanCreator clanCreator = new ClanCreator();

// 设置公会名称
clanCreator.setClanName("Warriors");

// （可选）设置公会最大成员数
clanCreator.setClanMaxMemberSize(50);

// （可选）设置公会最大管理员数
clanCreator.setClanMaxModeratorSize(5);

// 设置公会所有者。请将 "player-uuid" 替换为玩家的真实 UUID，123 替换为其在数据库中的唯一 ID
clanCreator.setClanOwner("player-uuid", 123);

// （可选）设置公会标签
clanCreator.setTag("WRR");

// 尝试创建公会
ClanCreatorStatus status = clanCreator.create();

// 处理创建结果
switch (status) {
    case SUCCESS:
        System.out.println("Clan created successfully!");
        break;
    case PLAYER_HAS_OWN_CLAN:
        System.out.println("Player already owns a clan.");
        break;
    case PLAYER_IS_INSIDE_A_CLAN:
        System.out.println("Player is already part of another clan.");
        break;
    case CLAN_ALREADY_EXIST:
        System.out.println("A clan with this name or tag already exists.");
        break;
    case ERROR:
        System.out.println("An error occurred while creating the clan.");
        break;
}

❓获取帮助与更多信息

如需更详细的 API 指南或有任何疑问，请通过以下方式获取支持。

• 请加入我们的 Discord 服务器。我们设有专门的论坛，其中包含完整的 API 使用指南。
• 如果您在使用 ClanSystem 时遇到任何问题或需要协助，欢迎加入我们的 Discord 服务器以获取支持、更新和社区讨论。

💡服务条款

在使用 ClanSystem 插件时，您必须遵守以下条款。

• 您不得以任何形式公开发布本插件的源代码。
• 插件错误不应写在公开评论中，但可以通过私信或讨论区提交。
• 您不得出售、赠送或重新分发此插件。
• 您不能将此插件声称为自己的作品。