SimpleClans - 简易公会系统

SimpleClans 是一款功能全面的 Minecraft 服务器插件，它允许玩家创建和管理自己的家族，并提供了丰富的社交、PvP 与团队管理功能。通过简洁的命令菜单和深度自定义选项，它能为你的服务器带来充满活力的社区互动体验。

💡主菜单

使用 /clan 命令即可打开主菜单。菜单会根据玩家的身份和家族状态，智能显示其可用的命令。

• 未受信任的家族成员可使用基础命令。
• 受信任的成员可使用高级命令。
• 家族领袖可使用家族管理命令。
• 管理员可使用全局命令。
• 未验证的家族命令列表受限。
• 已验证的家族拥有完整命令列表。
• 已验证家族的领袖拥有全部家族功能。
• 同时是管理员且为已验证家族的领袖，则拥有完整权限集。

💡家族类型

家族分为两种类型：已验证和未验证。

• 新创建的家族默认为未验证状态。它们功能受限（如无法查看坐标、生命值、统计信息），不会出现在家族列表中，并且如果其成员48小时内（可配置）无人登录，家族将被自动删除。这旨在提供临时组队功能，避免服务器上充斥大量废弃家族。
• 管理员可以使用 /clan verify 命令将家族升级为已验证状态。已验证家族拥有完整功能，其不活跃删除时限为7天（可配置）。
• 你可以在配置文件中禁用验证功能，使新创建的家族自动成为已验证状态。

✨创建你的第一个家族

创建家族需要指定家族名称和标签。

• 标签是家族的唯一标识符，用于命令和大部分消息中。标签可以包含颜色代码。
• 创建命令格式：/clan create <标签> <家族名称>
• 例如：/clan create &4K&Fo&4l Knights of the Labyrinth
• 创建后，可以使用 /clan modtag 命令修改标签的颜色和大小写（不能修改字母本身）。
• 例如：/clan modtag &4KOL
• 彩色标签会显示在家族成员的游戏名之前，并能与现有的前缀和聊天插件兼容。

✨邀请成员

• 家族创建者自动成为首位领袖，可以使用 /clan invite <玩家> 邀请其他玩家。
• 新成员初始状态为未受信任，无法查看家族坐标、生命值或统计信息，以防止间谍行为。
• 当成员获得信任后，领袖可以使用 /clan trust <玩家> 将其提升为受信任状态。
• 可以使用 /clan promote 命令投票晋升其他领袖（需要所有在线领袖同意）。/clan demote 降级操作同理。
• 管理员可以使用 /clan ban/unban 命令禁止玩家加入任何家族。

✨家族聊天

在家族频道聊天非常简单

• 使用 /c [消息] 即可。

✨家族联盟与敌对

联盟

• 任何家族领袖可以使用 /clan ally add <家族标签> 发送结盟请求。
• 需要对方家族的一位领袖接受请求，联盟才正式成立。
• 任何一方家族的领袖都可以使用 /clan ally remove <家族标签> 单方面解除联盟。

敌对

• 任何家族领袖可以使用 /clan rival add <家族标签> 单方面宣布敌对，无需对方同意。
• 要解除敌对，需要使用 /clan rival remove <家族标签> 发送请求，需要对方家族的一位领袖接受。
• 使用 /clan alliances 查看所有家族及其盟友，使用 /clan rivalries 查看敌对关系。

✨击杀/死亡比率 (KDR)

当玩家加入已验证家族后，其击杀和死亡记录开始生效。

• 击杀不同身份的玩家权重不同（可配置）：
• 敌对家族成员：1.5
• 中立家族成员：1.0
• 无家族平民：0.5
• 权重也可设为负值，以惩罚某些行为（如击杀平民）。
• KDR 分数 = 加权击杀总数 / 死亡次数。这是衡量玩家 PvP 技巧的核心指标。
• 玩家从首次加入服务器起的数据就会被记录，加入家族时会继承此前的记录。
• 玩家可以在家族统计页面和服务器排行榜上查看自己的 KDR。

✨友军伤害

• 同家族及盟友之间默认受到友军伤害保护，无法互相伤害。
• 家族领袖可以使用 /clan clanff 命令为整个家族开启或关闭友军伤害。
• 个人玩家可以使用 /clan ff 命令设置自己的友伤偏好：allow（允许）、auto（跟随家族设置）、block（阻止，仅在家族设置允许时生效）。
• 管理员可以使用 /clan globalff 命令设置全局友伤状态：allowed（完全允许）或 auto（交还各家族/个人控制）。这在举办全服锦标赛时非常有用。

✨家族基地

• 已验证家族的领袖可以使用 /clan home set 设置家族基地。
• 任何成员可以使用 /clan home 传送回基地（有可配置的传送准备时间，期间不能移动）。
• 领袖可以使用 /clan home regroup 将所有在线成员召唤至基地。
• 如果服务器禁止传送，可以移除玩家的 simpleclans.member.home 和 simpleclans.member.home-regroup 权限，并启用配置中的 teleport-home-on-spawn 选项，使基地成为成员的出生点。

✨家族公告板

• 服务器日志会记录家族活动，最新的几条事件（数量可配置）会在成员登录时显示。
• 使用 /bb view 随时查看公告。
• 受信任的成员可以使用 /bb add [消息] 添加公告，在线成员会收到通知。
• 个人可以使用 /clan toggle bb 切换登录时是否显示公告。
• 使用 /bb clear 清空公告板。

✨家族披风与称号

• 如果使用 Spout，可以看到成员佩戴带有家族标签的披风和游戏内称号。
• 称号的样式、颜色和括号等均可配置。玩家潜行时称号会隐藏。
• 家族成员默认拥有统一披风（可配置）。已验证家族的领袖可以使用 /clan cape 为家族选择独特披风。
• 个人玩家可以使用 /clan cape toggle 切换是否显示披风。

✨成员头衔

• 家族领袖可以使用 /clan setrank [玩家] [头衔] 为成员设置自定义头衔。头衔可以包含颜色代码。

✨查看信息

• 家族列表：使用 /clan list 查看服务器所有家族（按 KDR 排序）。
• 排行榜：使用 /clan leaderboard 查看所有玩家的 KDR 排名。
• 成员花名册：使用 /clan roster 查看本家族成员的等级、状态和最后在线时间。
• 成员状态：使用 /clan vitals 查看所有在线成员的生命值、装备和饱食度。
• 成员坐标：使用 /clan coords 查看所有在线成员的距离和坐标（按距离排序）。
• 家族统计：使用 /clan stats 查看所有成员的 KDR、原始击杀和死亡数据。
• 玩家查询：使用 /clan lookup [玩家] 查看指定玩家的详细信息、KDR、所属家族及历史记录。
• 家族资料：使用 /clan profile [家族标签] 查看指定家族的详细信息。
• 击杀列表：使用 /clan kills [玩家] 查看该玩家击杀最多的受害者列表。不指定玩家则查看自己的。
• 可疑击杀记录：管理员可以使用 /clan mostkilled 命令查看全服范围内单次攻击击杀数异常高的记录，用于排查 KDR 作弊。

🎮领地保护集成

SimpleClans 深度集成了 PreciousStones 保护系统。

• 你可以使用家族标签，将整个家族一次性添加到任何保护区域：
• /ps allow c:家族标签
• 其他命令如 remove, allowall, removeall 同理。
• 如果你是家族成员，你放置的任何保护区域都会自动允许你的家族进入。
• 注意：此功能可通过 API 由其他保护系统提供。

🎮战争系统

如果使用 PreciousStones 保护，家族之间可以宣战。

• 一个家族可以使用 /clan war [家族标签] 向敌对家族发送战争请求。
• 对方接受后，双方家族成员的所有保护区域，以及任何允许了该家族的区域，将对另一方完全失效。双方可以自由攻击对方的基地。
• 战争将持续到一方请求结束且另一方接受为止。
• 注意：此功能可通过 API 由其他保护系统提供。

🎮经济支持

需要 Vault 经济插件支持。

• 下载 Vault：http://dev.bukkit.org/server-mods/vault/
• 创建收费：启用 economy.purchase-clan-create 并设置 economy.creation-price，可对创建未验证家族收费。
• 验证收费：启用 economy.purchase-clan-verify 并设置 economy.verification-price，玩家将获得 /clan verify 菜单项，可付费自行验证家族。两种收费可以同时启用。

🔧用户翻译

• 意大利语：http://pastie.org/3354009
• 波兰语：http://pastebin.com/MXaXYYhW
• 法语：http://pastie.org/3441369

🔧权限

兼容所有主流权限管理插件。

• 权限节点列表：http://dev.bukkit.org/server-mods/simpleclans/pages/permissions/

🔧数据存储

• 建议在配置中启用 MySQL 以获得最佳性能。
• 如果没有 MySQL 服务器，可以使用 SQLite。
• 首选引擎：MySQL

🔧API

SimpleClans 的所有功能都可通过 API 调用。

• 首先获取玩家的 ClanPlayer 数据对象，进而可以操作其所属的家族。
• 更多信息：http://dev.bukkit.org/server-mods/simpleclans/pages/api/

❓反馈与支持

发现漏洞或有功能建议？

• 请提交至问题追踪器：https://github.com/phaed420/SimpleClans/issues

⭐相关插件

SimpleClansChat

• 为 SimpleClans 格式化聊天内容的附加插件。
• 支持兼容模式，可与 mChat、ChatSuite 和 Herochat（仅标签，无频道支持）等聊天管理插件共用。

Dynmap-SimpleClans

• 为 Dynmap 提供家族显示支持。
• 下载：http://dev.bukkit.org/server-mods/dynmap-simpleclans/

SimpleClansStats

• 一个 PHP 前端，用于展示 SimpleClans 数据库中的统计信息。
• 原始版本：http://dev.bukkit.org/server-mods/simpleclansstats/
• ProjectNarna 维护的更新版：http://forums.bukkit.org/threads/web-admin-narna-simpleclanstats.83389/

SimpleClansResidence

• 在 Residence 领地插件和 SimpleClans 之间建立桥梁。
• 为领地新增四个标志：
• clanbuild：允许家族成员建造。
• clanuse：允许家族成员使用物品。
• clanmove：仅允许家族成员进入（否则回退至 move 标志）。
• clancontainer：为家族创建共享存储。
• 下载：http://dev.bukkit.org/server-mods/simpleclansresidence/

SimpleClansGUIs

• 为 SimpleClans 提供图形用户界面。
• 下载：http://dev.bukkit.org/server-mods/simpleclansguis/

Castle Defense Mini-Game

• 一款基于 SimpleClans 的城堡攻防小游戏。
• 下载：http://dev.bukkit.org/bukkit-plugins/castle-defence-simpleclan/