

- 可以邀请活着(在线、休眠)和死去(不活着)的玩家
 - 未进入游戏的受邀玩家在登录 3 秒后会显示其军团邀请
 - 它支持用于部落互动的可选联盟功能
 - 军团成员可以为军团成员和盟友切换友军火力保护
 - 军团/盟友聊天会显示说话者的姓名及其彩色军团状态
 - 军团广播会显示任何操作,例如邀请或降级,并显示演员军团状态颜色
 - 战队概览显示离线成员名称
 - 氏族 TAG min- 和 max-length 可以在配置中定义
 - 部落创建可以根据阻止的单词列表检查 TAG
 - 可以选择性地禁用 Clan taging
 - 它可以创建/管理自动 Oxide 氏族组,包括其成员
 - 旧的(x 天后未更新)军团可以自动清除
 - 所有 authLevel 1 和 2 的授权玩家都可以直接广播到军团频道
 - 所有默认聊天命令都是可更改的。
 - 所有插件颜色都可以格式化
 - 所有文本均按语言文件提供
 
更新到 3.x.x 以及如何将旧数据文件转换为新数据结构
这仅在您希望在更新时保留以前的战队数据时才有意义。
1) 在将插件更新到 v3.x.x 之前,请先创建您的 Clans 配置文件和数据文件的备份。然后将您的氏族数据文件 (/oxide/data/clans.json) 重命名为 “Clans” 以外的名称。
2) 在您的服务器上
加载更新的插件 3) 在 rcon 中键入 “clans.convertdata <filename>”,将 <filename> 替换为您现有氏族数据文件的副本名称(不带扩展名)。
您现有的所有战队都将转换为新的数据文件结构
:默认情况下,与 Rusts
团队系统集成集成处于启用状态。这允许玩家使用 Rust 团队原生功能(例如邀请玩家和离开团队),并将其也适用于他们的部落。
"Rust Team Options": {
      "Automatically create and manage Rust team's for each clan": true,
      "Allow players to leave their clan by using Rust's leave team button": true,
      "Allow players to kick members from their clan using Rust's kick member button": true,
      "Allow players to invite other players to their clan via Rust's team invite system": true,
      "Allow players to promote other clan members via Rust's team promote button": true
    }
聊天命令
/a – 与盟友聊天
/clan – 战队概览
/clan 帮助 |/clanhelp – 显示帮助
/clan 盟友 |/clanally – 显示盟友选项(所有者或议会)
/c – 部落聊天
/cinfo – 其他部落
的信息 /cff – 切换玩家 FF 状态
/aff – 切换联盟 FF
每个命令都可以在配置中更改以满足您的需要
"Command Options": {
    "Ally chat command": "a",
    "Clan chat command": "c",
    "Clan command": "clan",
    "Clan info command": "cinfo",
    "Ally friendly fire command": "aff",
    "Friendly fire command": "cff",
    "Clan ally command": "clanally",
    "Clan help command": "clanhelp",
控制台命令 –
* 可以通过 rcon 或游戏内主机
部落运行 – 控制台命令概述(仅限客户端)
他们从客户端的访问取决于配置:
"Required auth-levels to use admin console command": {
      "Create clan": 2,
      "Rename clan": 1,
      "Disband clan": 2,
      "Invite member to clan": 1,
      "Kick member from clan": 2,
      "Promote/Demote member in clan": 1
    }
Clan Tag 单词过滤器
部落创建可以根据阻止的单词列表检查 TAG
- 此功能默认开启
 - wordlist 可以在主配置中扩展
 - 通过 server/admin/mod 重命名的部落不勾选此过滤器
 
"Words/characters not allowed in tags": [
      "admin",
      "mod",
      "owner"
    ]
清除旧氏族
自动军团清除功能默认开启。您可以让它清除在指定天数内未上线的军团。
"Purge Options": {
    "Enable clan purging": true,
    "Purge clans that havent been online for x amount of day": 14,
    "List purged clans in console when purging": true,
    "Wipe clans on new map save": false
  },
BetterChat 支持
该插件支持 BetterChat,允许您为氏族标签设置大小和颜色。
"Tag color (hex) (BetterChat)": "#aaff55",
"Tag size (BetterChat)": 15,
权限和组
该插件可以自动管理每个氏族的专用 oxide 权限组,也可以为每个加入和离开的成员管理专用的 oxide 权限组。
该插件将自动创建组、检查成员资格、验证组、删除组、删除成员等。
"Permission Options": {
    "Minimum auth level required to view clan info (0 = player, 1 = moderator, 2 = owner)": 0,
    "Use permission groups": false,
    "Permission group prefix": "clan_",
    "Use permission to create a clan": false,
    "Clan creation permission": "clans.cancreate",
    "Use permission to join a clan": false,
    "Clan join permission": "clans.canjoin"
  },
Discord 日志记录
您可以使用 https://www.chaoscode.io/resources/discordclans.210/
Config 将氏族活动记录到您的 Discord 公会
建议使用编辑器和验证器以避免格式问题
{
  "Clan Options": {
    "Member limit": 8,
    "Moderator limit": 2,
    "Allow friendly fire toggle (clan members)": true,
    "Alliance Options": {
      "Enable clan alliances": true,
      "Alliance limit": 2,
      "Allow friendly fire toggle (allied clans)": true
    },
    "Invite Options": {
      "Maximum allowed member invites at any given time": 8,
      "Member invite expiry time (seconds)": 86400,
      "Maximum allowed alliance invites at any given time": 2,
      "Alliance invite expiry time (seconds)": 86400
    },
    "Rust Team Options": {
      "Automatically create and manage Rust team's for each clan": true,
      "Allow players to leave their clan by using Rust's leave team button": true,
      "Allow players to kick members from their clan using Rust's kick member button": true,
      "Allow players to invite other players to their clan via Rust's team invite system": true,
      "Allow players to promote other clan members via Rust's team promote button": true
    }
  },
  "Command Options": {
    "Ally chat command": "a",
    "Clan chat command": "c",
    "Clan command": "clan",
    "Clan info command": "cinfo",
    "Ally friendly fire command": "aff",
    "Friendly fire command": "cff",
    "Clan ally command": "clanally",
    "Clan help command": "clanhelp",
    "Required auth-levels to use admin console command": {
      "Create clan": 2,
      "Rename clan": 1,
      "Disband clan": 2,
      "Invite member to clan": 1,
      "Kick member from clan": 2,
      "Promote/Demote member in clan": 1
    }
  },
  "Role Colors": {
    "Clan owner color (hex)": "#a1ff46",
    "Clan council color (hex)": "#b573ff",
    "Clan moderator color (hex)": "#74c6ff",
    "Clan member color (hex)": "#fcf5cb",
    "General text color (hex)": "#e0e0e0"
  },
  "Clan Tag Options": {
    "Enable clan tags": true,
    "Tag opening character": "[",
    "Tag closing character": "]",
    "Tag color (hex) (BetterChat)": "#aaff55",
    "Tag size (BetterChat)": 15,
    "Tag character limits": {
      "Minimum": 2,
      "Maximum": 5
    },
    "Special characters allowed in tags": "!²³",
    "Words/characters not allowed in tags": [
      "admin",
      "mod",
      "owner"
    ]
  },
  "Permission Options": {
    "Minimum auth level required to view clan info (0 = player, 1 = moderator, 2 = owner)": 0,
    "Use permission groups": false,
    "Permission group prefix": "clan_",
    "Use permission to create a clan": false,
    "Clan creation permission": "clans.cancreate",
    "Use permission to join a clan": false,
    "Clan join permission": "clans.canjoin"
  },
  "Purge Options": {
    "Enable clan purging": true,
    "Purge clans that havent been online for x amount of day": 14,
    "List purged clans in console when purging": true,
    "Wipe clans on new map save": false
  },
  "Settings": {
    "Block clan/ally chat when muted": false,
    "Log clan and member changes": false,
    "Use ProtoBuf data storage": false
  },
  "Version": {
    "Major": 3,
    "Minor": 0,
    "Patch": 1
  }
}
(bool) IsClanMember(ulong playerId, ulong otherId) – 检查 2 名玩家是否为部落伙伴
(bool) IsMemberOrAlly(ulong playerId, ulong otherId) – 检查 2 名玩家是否为部落伙伴或部落盟友
(bool) IsAllyPlayer(ulong playerId, ulong otherId) – 检查 2 名玩家是否为部落
伙伴(JObject)GetClan(string tag) – 返回一个 JObject,表示使用指定标签的氏族,如果没有此类氏族,则返回 null。
JObject 包含以下属性:
tag:string,
description:string,
owner:ulong,
council:ulong,
moderators:JArray:ulong,
members:JArray:ulong,
allies:JArray:string
invitedallies:JArray:string
(string) GetClanOf(BasePlayer | string | ulong) – 返回玩家氏族的氏族标签,如果玩家不是clan
(JArray)GetAllClans() – 返回所有氏族标签
的数组 (List<string>)GetClanMembers(ulong | string) – 返回玩家氏族的成员 ID 列表,如果玩家不是氏族
成员,则返回 null该插件还会在更改时调用以下简单钩子(无返回行为):
(void)OnClanCreate(string tag) – 创建新氏族
时调用(无效)OnClanUpdate(string tag) – 当军团成员或邀请发生变化
时调用 (void)OnClanDestroy(string tag) – 当军团解散或删除
时调用
该插件还会在更改时调用以下信息钩子(无返回行为):
(void)OnClanMemberJoined(string userID, List<string> memberUserIDs) – 当玩家加入军团时调用。提供新成员的 ID 和先前成员的完整列表,不包括该 ID
(void)OnClanMemberJoined(string userID, string tag) – 当玩家加入部落时调用。提供新成员的 ID 和氏族标签
(void)OnClanMemberGone(string userID, List<string> memberUserIDs) – 当玩家离开氏族时调用 (leave|kick)。提供旧成员的 ID 和除该 ID
外的剩余成员的完整列表 (void)OnClanMemberGone(string userID, string tag) – 当玩家离开部落时调用 (leave|kick)。提供旧成员的 ID 和战队标签
(void)OnClanDisbanded(List<string> memberUserIDs) – 当战队解散或删除时调用。提供删除时的完整成员列表。
(void)OnClanDisbanded(string tag, List<string> memberUserIDs) – 当军团解散或删除时调用。提供删除时的完整成员列表。


