在《英灵神殿》中建立你的氏族，设置领袖、官员、成员和访客角色，支持氏族聊天、可移动的生命值HUD、私密地图标记、位置共享、自定义徽章和动态GIF表情。申请加入、邀请好友、管理成员，在《英灵神殿》中保持联系。

公会

为Valheim打造的服务器权威氏族系统，已整合至原版聊天界面。

展示

氏族面板与管理

直接从游戏中打开战队面板，浏览战队和玩家，搜索名录，申请或邀请，并管理成员角色。

首领可以更新战队名称和描述，并从服务器的媒体目录中选择一个徽章。

氏族聊天和通知

氏族聊天集成在原生聊天界面中，而可移动HUD则让当前氏族和在线成员在游戏过程中始终可见。

视图筛选器可以在全部、战队、本地和全局消息之间切换，而不会改变所选的发送频道。待处理的邀请和申请通过战队控件显示。

表情符号和动态GIF

从聊天中打开五列表情选择器，插入服务器同步的PNG或GIF表情。动态GIF会在支持的聊天消息中直接播放。

功能

• 创建、浏览、搜索和管理战队
• 领袖, 军官, 成员，以及 访客 角色
• 与……进行氏族聊天 全部, 部落, 本地，以及 全局 查看筛选
• 仅限氏族成员的地图标记和可选位置共享
• 可移动氏族界面，显示在线玩家生命值
• 服务器同步的PNG/GIF表情和PNG徽章
• 英语和韩语本地化

快速开始

动作	默认控制
打开或关闭氏族面板	J
打开聊天和表情面板	H
发送仅氏族可见的地图标记	按住 左Shift键 使用原版地图标记时

打开氏族面板即可创建氏族或申请加入现有氏族。打开原版聊天可切换频道、插入表情、筛选可见消息，或通过附带的控件打开氏族面板。

氏族HUD默认启用，最多显示10名在线玩家。拖动其标题栏可移动位置，或使用标题栏控件折叠玩家列表。

角色与客卿氏族

一个玩家可能拥有：

• 一个主要氏族角色： 领袖, 长官，或 成员
• 一个持久 访客 连接到其他部落

当访客连接处于激活状态时，访客氏族将用于氏族聊天、HUD、标记、共享地图位置和友军伤害检查。主要成员身份仍会被保留，在离开或被移出访客氏族后重新生效。

已接受的申请和邀请始终以 访客队长和官员可以从名册中管理符合条件的玩家；领导权转让和战队资料管理仅限队长操作。

可选战斗与任务兼容性

在服务器和参与客户端（包括拥有附近生物的客户端）上安装相同的氏族构建版本及相关可选模组。已审核的版本为 古怪史诗MMO系统 1.9.68 和 RtDQuestForge 0.2.13其他版本会禁用对应适配器并在启动时发出警告，直到其契约经过审查。Clan 不捆绑任何模组，也不依赖 Jotunn；QuestForge 保留其自身的依赖项。

服务器同步设置位于 3 - 兼容性:

设置	默认	行为
分享史诗级MMO体验	开	与其他在线有效氏族成员共享战斗经验值，保留Epic的组队倍率、接收范围、等级曲线和经验值修正。
分享任务工坊击杀	开	为附近的存活氏族成员增加击杀目标进度。每个玩家必须接受自己的任务；采集、奖励和进度存档仍为个人所有。
任务工坊分享范围	70	击杀生物后获得额外任务奖励的最大距离（米）。

对于这两项功能，客座成员身份优先于主成员身份。不会同时向两个部族发放荣誉点数，且原击杀者不会获得额外荣誉点数。这些功能不会新增独立的临时队伍系统，也不会改变部族与小队之间现有的互斥关系。

中继会校验已连接身份与服务端部落成员资格。任务报告还会校验生物归属、预制体与死亡ID；过晚的报告或无法识别的归属会被拒绝。Epic原生战斗报告没有唯一死亡ID，因此中继会拒绝重复的传输序列，但无法识别独立重复的原生击杀报告。这些校验不会使第三方战斗或奖励系统完全由服务端权威控制。

自定义表情和徽章

权威服务器从以下位置加载媒体：

BepInEx/config/Clan/emoji BepInEx/config/Clan/emblems

单人游戏和本地主机，将媒体放入本地配置文件的文件夹中。对于专用服务器，将媒体放入该服务器安装的文件夹中。

部落不包含默认媒体合集。请安装可选的部落媒体包，或将你自己的文件复制到这些文件夹中。这样可以让核心模组保持精简，并允许服务器所有者和模组包作者在不替换部落 DLL 的情况下选择自己的目录。

仅服务器或主机的媒体目录会发布给已连接的客户端。远程客户端会优先复用共享缓存中的有效文件。当缓存条目缺失时，Clan 会检查相同的媒体包路径，并在验证文件长度和 SHA-256 后直接使用字节完全相同的本地文件，而不会创建缓存副本。其余文件会自动下载并添加到共享缓存中。服务器或主机上的更改会自动验证并重新加载。

传承 精灵图.png 格式不受支持；每个表情符号请使用一个图像文件。

内容	限制
表情符号目录	总共100个PNG/GIF文件，其中GIF最多50个
徽章图鉴	50个PNG文件
PNG	512 KiB，最大 512 × 512，8 位且非交错
GIF	2 MiB，最大 512 × 512；动态 GIF：最多 180 帧、10 秒，无限循环

基名在每个文件夹内必须唯一，包含1–32个字符，使用小写 A-Z，数字， _，或者 -，并且必须以字母或数字开头和结尾。不允许使用 Windows 保留名称，扩展名必须为小写 .png 或 .gif. 基名成为聊天令牌：

wave.png -> :clan_wave: pink_math.gif -> :clan_pink_math:

GIF 文件每个限制为 8,388,608 个解码像素，整个目录最多 3,000 帧。无效文件会被跳过并在服务器日志中报告。大型 GIF 目录可能占用大量系统和图形内存。

每条消息最多可包含五个识别出的表情符号。只有可见的原版聊天缓冲区内最新的15个GIF会播放动画；较早的GIF会停留在第一帧。

客户端仅下载缺失的媒体文件，并在以下路径保留共享内容缓存 <瓦尔海姆存档数据>/氏族/缓存. 下载在后台进行，不会阻碍进入世界。

配置和存档数据

客户端和同步设置存储在：

BepInEx/配置/sighsorry.Clan.cfg

主要默认值如下：

设置	默认	瞄准镜
锁定配置	开	服务器同步
部落友军伤害	开	服务器同步
分享氏族职位	开	服务器同步
氏族标记修改键	左Shift	客户端
部落聊天窗口缩放	1 (1–2)	客户端
氏族面板快捷方式	J	客户端
表情符号面板快捷键	H	客户端
发送后聊天	保持开启	客户端
显示氏族成员界面	开	客户端

部落友军伤害 = 开启 允许同氏族的玩家互相造成伤害。

氏族数据存储于：

<瓦尔海姆存档数据>/氏族/

在不含以下内容的 Windows 上 存档目录，默认位置是：

%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\Clan

路径	用途
部落.yml	氏族登记处
最近玩家.yml	最近玩家目录
缓存/	共享下载媒体缓存

使用相同《英灵神殿》存档数据根目录的世界和模组管理器配置文件，将共享此持久化氏族数据和已下载媒体缓存。它们的服务器媒体源仍按配置文件独立存放于 BepInEx/config/Clan分别使用 存档目录 独立专用服务器注册表的值。请勿删除存档数据 部落 文件夹，除非你同时打算删除已保存的部落数据。

模组API

部落接口.接口版本 是 5. 服务器端集成可以查询权威的主要和访客会员资格，使用 解除成员资格，使用以下内容查询病房访问权限 解除结界授权，并通过以下方式使缓存结果失效： 注册表修订版 和 注册表已更改.

当任一查找返回时，按关闭失败处理 不可用.

API v5新增了可选的 氏族接口.服务器聊天已接受 事件：

Action<string, long, string, string, string, string> // 平台ID，角色玩家ID，玩家名称，公会ID，公会名称，消息

在身份、成员资格、文本和速率限制检查接受氏族消息后，它在权威专用服务器或本地主机上触发一次，然后在发送给氏族成员之前触发。它不会在接受客户端或消息被拒绝/受速率限制时触发。订阅一次，当你的集成停止时取消订阅，并保持处理程序运行迅速。非致命的订阅者故障与其他处理程序和聊天消息发送隔离开来；诊断信息绝不包含消息内容。

此附加事件支持可选的服务器端日志集成，例如ServerManager。氏族保持独立运行，不依赖ServerManager。氏族聊天内容仅对其氏族接收者可见，但已安装的服务器端集成可将已接收的消息记录在服务器的本地日志中。该事件本身不会记录内容或创建公共聊天中继。