ClansLite - 简单公会插件

ClansLite 是一款轻量级的家族插件，适用于运行 Spigot 或其分支的 Minecraft 服务器。它不支持领地保护等防破坏功能，但提供了可自定义的单箱子保护系统。插件支持从 1.16.5 版本起的任何 Minecraft 版本，并持续进行开发和修复，以确保最佳使用体验。

💡重要提示

想要尝试最新的开发版本吗？

点击此处获取

• 请自行承担使用开发版本的风险！
• 请务必遵循每个开发版本附带的所有说明！

🎮命令列表

主命令：/clan

别名： /clans, /c, /cl

这是插件的核心命令，功能如下

• /clan create <name> - 创建一个新家族（若你尚未加入任何家族）。
• /clan disband - 如果你是族长，此命令将解散你的家族。
• /clan leave - 如果你在家族中，此命令将使你退出家族。
• /clan invite <player> - 邀请一名玩家加入你的家族（若该玩家未加入其他家族）。
• /clan join - 接受邀请，加入一个家族。
• /clan kick <player> - 将一名玩家从你的家族中踢出。
• /clan info - 显示你当前家族的信息。
• /clan list - 列出服务器上的所有家族。
• /clan prefix <prefix> - 更改你的家族在聊天中的前缀。
• /clan ally [add|remove] <ally-owner> - 为你的家族添加或移除一个盟友家族。
• /clan enemy [add|remove] <ally-owner> - 为你的家族添加或移除一个敌对家族。
• /clan pvp - 切换你家族内的友军伤害状态。
• /clan [sethome|delhome|home] - 设置家族家园位置，或传送你及家族成员到此位置。
• /clan transfer <player> - 将你的家族所有权转移给另一名玩家。
• /clan points [withdraw|deposit] <amount> - 从你的家族存入或取出点数。
• /clan playerpoints <listall> - 显示你或其他玩家通过 PvP 获得的点数。

家族聊天命令：/clanchat

别名： /clanc, /cchat, /chat

此命令专用于使用家族内部聊天。

• /clanchat <message> - 将消息发送给你所在家族的所有成员。

聊天监视命令：/clanchatspy

别名： /cs, /ccs, /spy

此命令用于监视所有家族聊天。

• /clanchatspy - 启用后，可以查看任何家族聊天中发送的所有消息。

箱子保护命令：/clanchest

别名： /cchest, /cch, /cht

此命令是使用箱子保护系统的基础命令。

• /clanchest lock - 锁定你正在查看的单箱子。
• /clanchest unlock - 解锁你正在查看的单箱子。
• /clanchest accesslist - 查看哪些玩家有权访问该箱子。
• /clanchest buylock <amount> - 购买一个新的或多个箱子锁。

管理员命令：/clanadmin

别名： /ca, /cla

此命令仅供服务器管理员使用。

• /clanadmin save - 将所有当前家族信息保存到 clans.yml 数据文件。
• /clanadmin reload - 从磁盘重新加载插件的 config.yml 和 messages.yml 文件。
• /clanadmin disband <owner-name> - 允许管理员使用族长名称删除任何家族。
• /clanadmin disband byname: <clan-name> - 允许管理员使用家族名称删除任何家族。
• /clanadmin info <clan-name> - 允许管理员查看指定家族的所有信息。
• /clanadmin playerinfo <player> - 允许管理员查看指定玩家所在家族的所有信息。
• /clanadmin visithome <clan-name> - 允许管理员传送至指定家族的家园位置。
• /clanadmin about - 提供插件的核心信息概览。

🔧权限与配置

• 权限： 请查看文档选项卡以获取完整权限列表。
• 配置文件： 插件使用多个配置文件，详细说明可在 Wiki 中查阅。
• config.yml
• messages.yml
• clangui.yml

✨聊天前缀集成

ClansLite 提供了一个 {CLAN} 变量，可用于 Essentials Chat 或类似插件。

• 只需将 {CLAN} 占位符添加到 EssentialsX 配置文件 config.yml 的 chat.format 字符串中你希望它出现的位置。
• 重新加载 EssentialsX 或重启服务器，家族前缀就会像魔法一样显示出来！
• 如果 {CLAN} 占位符无法工作，请查看此指南以获取解决方案。

✨PlaceholderAPI 支持

要使用完整的占位符列表，必须安装最新版本的 PlaceholderAPI。否则，只有 {CLAN} 占位符可用于 EssentialsX Chat。

• 可用占位符的完整列表，请查看文档选项卡。

⭐API 与开发

ClansLite 拥有功能完整的 API，允许任何开发者访问插件内部并添加新功能。

• 有关如何使用 API 的详细信息，请查看 ClansLite Wiki。

❓已完成的功能

• 添加家族聊天系统 - 已完成 (v1.2.2)
• 添加命令补全 - 已完成 (v1.3.0-BETA)
• 添加 GUI 系统 - 已完成 (v1.3.0-BETA)
• 添加管理员访问家族家园功能 - 已完成 (v1.5.3)
• 添加管理员查看家族聊天功能 - 已完成 (v1.3.9)
• 添加家族箱子保护系统 - 已完成 (v1.3.9)
• 添加管理员删除家族功能 - 已完成 (v1.3.1)
• 为家族成员列表添加数值显示 - 已完成 (v1.2.4)
• 添加家族创建时的公共公告 - 已完成 (v1.2.4)
• 添加完整 API 供外部开发者使用 - 已完成 (v1.4.4)

🔧支持与反馈

请报告任何问题，并欢迎加入我们的 Discord。

• 请勿在评论部分发布问题或错误报告！在该处发布的任何内容将被忽略！
• 请在讨论主题中发帖，或加入我们的 Discord 并创建支持工单！

ClansLite 是一款轻量级的 Minecraft 服务器插件，允许玩家创建和管理自己的家族，进行团队合作与竞争。它提供了家族聊天、领地保护、积分排行等核心功能，并支持 PlaceholderAPI 以实现深度自定义。

🎮命令与权限

主要命令

• /clan - 创建、解散和管理家族。
• 别名: /clans, /c, /cl
• /topclans - 查看服务器上的顶级家族。
• 别名: /topc, /tc
• /clanadmin - 管理家族插件。
• 别名: /ca, /cla
• 权限: clanslite.admin
• /clanchat <消息> - 仅向你的家族成员发送消息。
• 别名: /clanc, /cchat, /chat
• /clanchatspy - 允许管理员查看所有家族聊天信息。
• 别名: /cs, /ccs, /spy
• /clanchest - 保护你的家族箱子。
• 别名: /cchest, /cch, /cht

权限节点

权限结构以 clanslite.* 作为总权限，默认仅 OP 可用。以下是关键权限组：

管理权限

• clanslite.admin - 授予所有管理功能。
• clanslite.chat.spy - 使用 /clanchatspy 命令。
• clanslite.update - 接收插件更新游戏内通知。
• clanslite.maxclansize.* - 允许拥有无限家族成员。
• clanslite.points.listall - 使用 /clan playerpoints listall 命令查看所有玩家积分。

命令权限

• clanslite.command.chat - 使用 /clanchat 命令。（默认：true）
• clanslite.command.chest.* - 使用所有 /clanchest 命令。
• 包含子权限：accesslist, buylock, lock, unlock。
• clanslite.command.clan.* - 使用所有 /clan 命令。
• 包含创建、邀请、踢出、传送、设置前缀、结盟、宣战、管理积分等所有子命令权限。

绕过权限

• clanslite.bypass.* - 绕过所有内部限制和保护。
• clanslite.bypass.homecooldown - 绕过 /clan home 冷却时间。
• clanslite.bypass.homedelay - 绕过 /clan home 传送预热延迟。
• clanslite.bypass.chatcooldown - 绕过 /clanchat 聊天冷却。
• clanslite.bypass.chests - 绕过任何已上锁箱子的保护。
• clanslite.bypass.pvp - 绕过家族设置的友军伤害状态。

✨PlaceholderAPI 支持

要使用以下占位符，必须安装最新版本的 PlaceholderAPI。否则，仅 {CLAN} 可用于 EssentialsX Chat。

可用占位符列表

• 插件信息
• %clansLite_pluginVersion% - 插件版本。
• %clansLite_pluginAuthor% - 插件作者。
• %clansLite_baseServerVersion% - 服务器基础版本。
• %clansLite_serverPackage% - 服务器软件包。
• 玩家与家族信息
• %clansLite_clanName% - 玩家所在家族名称。
• %clansLite_clanPrefix% - 家族前缀。
• %clansLite_friendlyFire% - 友军伤害状态。
• %clansLite_clanHomeSet% - 家族传送点是否已设置。
• %clansLite_clanMembersSize% - 家族成员数量。
• %clansLite_clanAllySize% - 盟友家族数量。
• %clansLite_clanEnemySize% - 敌对家族数量。
• 积分与箱子
• %clansLite_playerPointBalance% - 玩家个人积分。
• %clansLite_clanPointBalance% - 家族总积分。
• %clansLite_clanChestMaxAllowed% - 家族可锁箱子最大数量。
• %clansLite_clanChestCurrentLocked% - 当前已锁箱子数量。
• 排行榜
• %clansLite_topClanName_<数字>% - 指定排名的家族名称。
• %clansLite_topClanValue_<数字>% - 指定排名的家族积分值。
• %clansLite_topPlayerName_<数字>% - 指定排名的玩家名称。
• %clansLite_topPlayerValue_<数字>% - 指定排名的玩家积分值。

> 重要提示：所有占位符均已内置在 ClansLite 中，无需从 PlaceholderAPI eCloud 额外下载扩展。