ClansLite - 氏族插件

ClansLite 是一款适用于运行 Spigot 及其分支的 Minecraft 服务器的轻量级公会插件，专注于基础公会功能，同时提供可自定义的单箱子保护。

💡插件简介

• 适用于 Spigot 及其任意分支服务端
• 支持 1.16.5 及以上所有 Minecraft 版本
• 持续开发与修复中，以提供更好的使用体验
• 不支持领地圈地、反破坏等土地保护功能
• 支持可自定义的单个箱子保护系统

🔧最新开发构建

• 想体验最新的开发版本？
• [Click here]
• 请自行承担使用上述 dev build 的风险
• 请务必遵循每个 dev build 附带的全部说明

🎮指令说明

`/clan` 指令

• 别名：/clans, /cl
• /clan 是本插件的主指令，可执行以下操作：

• /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, /c
• /clanchat 用于使用每个公会独立的聊天频道
• 支持以下语法：

• /clanchat <message> - 向你所在公会的成员发送一条消息
• /clanchat - 切换是否进入公会聊天模式

`/clanchatspy` 指令

• 别名：/cs, /ccs, /spy
• /clanchatspy 专用于监控各公会聊天频道
• 支持以下语法：

• /clanchatspy - 启用后，可查看 ANY 公会聊天中发送的 ANY 消息

`/clanchest` 指令

• 别名：/cchest, /cch, /cht
• /clanchest 是使用箱子保护系统的基础指令，可执行以下操作：

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

`/clanadmin` 指令

• 别名：/ca, /cla
• /clanadmin 仅供服务器管理员使用
• 当前已实现以下参数：

• /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 - 查看插件核心信息概览

❓权限

• 参见 Documentation 标签页

⭐配置文件

• config.yml

ClansLite Wiki

• messages.yml

ClansLite Wiki

• clangui.yml

ClansLite Wiki

✨聊天前缀

• ClansLite 提供了一个可在 Essentials Chat 或类似插件中使用的变量：{CLAN}
• 只需将 {CLAN} 占位符加入 EssentialsX 的 config.yml 中 chat.format 字符串的任意位置，即可让它显示在聊天里
• 重载 EssentialsX 或重启服务器后，公会前缀就会显示出来
• 如果你遇到 {CLAN} 占位符无法工作的问题，请查看该修复指南

✨Placeholder API

• 当前可用占位符完整列表：请参见 Documentation 标签页
• 若要使用这些占位符，必须安装最新版 PlaceholderAPI
• 如果未安装它，则只有 {CLAN} 可用于 EssentialsX Chat

🔧API 实现

• ClansLite 提供了一个功能完整的 API
• 开发者可以借此访问插件内部功能，并扩展作者尚未实现的内容
• 使用方法请查看 ClansLite Wiki

🎮开发计划 / 已完成内容

• Add clan chat system - DONE v1.2.2
• Add command tab completion - DONE v1.3.0-BETA
• Add GUI system - DONE v1.3.0-BETA
• Add admin ability to visit clan homes - DONE v1.5.3
• Add admin view of clan chats - DONE v1.3.9
• Add clan chest protection system - DONE v1.3.9
• Add ability for admins to delete clans - DONE v1.3.1
• Add numerical value for clan members list - DONE v1.2.4
• Add public announcement when a clan is created - DONE v1.2.4
• Add full API for external developer use - DONE v1.4.4

💡支持与反馈

• 如发现任何问题，请及时反馈
• 也欢迎加入我的 discord
• 不要在评论区发布问题或报错
• 发布在评论区的此类内容将被忽略
• 请在讨论帖中反馈，或加入 Discord 创建 support ticket

ClansLite 是一款用于创建、管理与扩展玩家公会系统的 Minecraft 插件。下面整理了该插件的权限、命令以及 PlaceholderAPI 占位符支持说明，便于在插件目录中快速查阅。

🎮插件基础信息

• 插件名称：ClansLite
• 版本：1.6.4

🔧命令

`/clan`

• 描述：创建、解散并管理公会。
• 用法：/clan [create|disband|invite|kick|info|list|prefix|transfer|ally|enemy|sethome|delhome|home|points|playerpoints]
• 别名：
• clans
• cl

`/topclans`

• 描述：查看服务器中的顶级公会排行。
• 用法：/topclans
• 别名：
• topc
• tc

`/clanadmin`

• 描述：公会管理后台命令。
• 用法：/clanadmin [save|reload|about]
• 权限：clanslite.admin
• 别名：
• ca
• cla

`/clanchat`

• 描述：仅向你的公会成员发送消息。
• 用法：/clanchat <message>, or /clanchat toggle to toggle clan chat mode on/off.
• 别名：
• clanc
• cchat
• chat
• c

`/clanchatspy`

• 描述：允许管理员查看所有公会聊天消息。
• 用法：/clanchatspy
• 别名：
• cs
• ccs
• spy

`/clanchest`

• 描述：保护你的公会箱子。
• 用法：/clanchest [lock|unlock|accesslist|buylock]
• 别名：
• cchest
• cch
• cht

💡权限

核心权限

• clanslite.*
• 默认：op
• 说明：主权限，允许使用 ClansLite 的所有功能（包括管理员功能）。

• clanslite.admin
• 说明：管理员权限，授予所有管理功能。

• clanslite.chat.spy
• 默认：op
• 说明：允许使用 /clanchatspy 命令及其功能。

• clanslite.update
• 默认：op
• 说明：当插件有可用更新时，接收游戏内通知。

• clanslite.maxclansize.*
• 默认：op
• 说明：允许拥有无限数量的公会成员。

• clanslite.points.listall
• 默认：op
• 说明：允许使用 /clan playerpoints listall 查看所有玩家积分。

⭐命令权限

聊天相关

• clanslite.command.chat
• 默认：true
• 说明：允许使用 /clanchat <message>。

公会箱相关

• clanslite.command.chest.*
• 默认：op
• 说明：允许使用所有 /clanchest 命令。

• clanslite.command.chest.accesslist
• 默认：true
• 说明：允许使用 /clanchest accesslist。

• clanslite.command.chest.buylock
• 默认：true
• 说明：允许使用 /clanchest buylock。

• clanslite.command.chest.lock
• 默认：true
• 说明：允许使用 /clanchest lock。

• clanslite.command.chest.unlock
• 默认：true
• 说明：允许使用 /clanchest unlock。

`/clan` 相关

• clanslite.command.clan.*
• 默认：op
• 说明：允许使用所有 /clan 命令。

• clanslite.command.clan.ally
• 默认：true
• 说明：允许使用 /clan ally。

• clanslite.command.clan.create
• 默认：true
• 说明：允许使用 /clan create。

• clanslite.command.clan.delhome
• 默认：true
• 说明：允许使用 /clan delhome。

• clanslite.command.clan.disband
• 默认：true
• 说明：允许使用 /clan disband。

• clanslite.command.clan.enemy
• 默认：true
• 说明：允许使用 /clan enemy。

• clanslite.command.clan.home
• 默认：true
• 说明：允许使用 /clan home。

• clanslite.command.clan.info
• 默认：true
• 说明：允许使用 /clan info。

• clanslite.command.clan.invite
• 默认：true
• 说明：允许使用 /clan invite。

• clanslite.command.clan.join
• 默认：true
• 说明：允许使用 /clan join。

• clanslite.command.clan.kick
• 默认：true
• 说明：允许使用 /clan kick。

• clanslite.command.clan.leave
• 默认：true
• 说明：允许使用 /clan leave。

• clanslite.command.clan.list
• 默认：true
• 说明：允许使用 /clan list。

• clanslite.command.clan.playerpoints
• 默认：true
• 说明：允许使用 /clan playerpoints。

• clanslite.command.clan.points
• 默认：true
• 说明：允许使用 /clan points。

• clanslite.command.clan.prefix
• 默认：true
• 说明：允许使用 /clan prefix。

• clanslite.command.clan.prefix.prefixcolors
• 默认：true
• 说明：允许为公会前缀添加颜色和样式。

• clanslite.command.clan.prefix.prefixformatting
• 默认：true
• 说明：允许使用特殊字符格式化公会前缀。

• clanslite.command.clan.pvp
• 默认：true
• 说明：允许使用 /clan pvp。

• clanslite.command.clan.sethome
• 默认：true
• 说明：允许使用 /clan sethome。

• clanslite.command.clan.top
• 默认：true
• 说明：允许使用 /clan top。

• clanslite.command.clan.transfer
• 默认：true
• 说明：允许使用 /clan transfer。

✨绕过权限

• clanslite.bypass.*
• 默认：op
• 说明：总绕过权限，可绕过所有内部限制与保护。

• clanslite.bypass.homecooldown
• 默认：op
• 说明：允许绕过 /clan home 的冷却时间。

• clanslite.bypass.homedelay
• 默认：op
• 说明：允许绕过 /clan home 的预热延迟。

• clanslite.bypass.chatcooldown
• 默认：op
• 说明：允许绕过 /clanchat <message> 的冷却时间。

• clanslite.bypass.chests
• 默认：op
• 说明：允许绕过任意已锁定箱子的保护。

• clanslite.bypass.pvp
• 默认：op
• 说明：允许绕过公会设置的友伤状态。

❓PlaceholderAPI

可用占位符列表

• 要使用以下占位符，必须安装 PlaceholderAPI 的最新正式版。
• 若未安装 PlaceholderAPI，则仅有 {CLAN} 可用于 EssentialsX Chat。
• 无需下载 PAPI eCloud 扩展。
• 所有占位符均为 ClansLite 内置。

• %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_<number>%
• %clansLite_topClanValue_<number>%
• %clansLite_topPlayerName_<number>%
• %clansLite_topPlayerValue_<number>%