Fjord

Fjord 文档

模块

01

欢迎

欢迎新成员、送别离开的用户,并自动分配身份组。

包含的功能

  • 自定义欢迎和告别消息
  • 自定义欢迎卡片
  • 为新成员自动分配身份组
  • 为加入和离开分别设置频道

欢迎什么?

通过欢迎,您可以自动问候新成员、告别离开的成员以及在加入时分配角色。所有三个区域都可以独立使用。

所需的 Discord 权限

查看频道 发送消息 附加文件 管理角色 嵌入链接提及并非所有人都能提及的身份组

只有在欢迎或告别消息的普通正文需要通知并非所有人都能提及的身份组时,Fjord 才需要此权限。@everyone 和 @here 在欢迎系统中被屏蔽,无法使用。

欢迎卡需要“附加文件”。仅自动角色需要管理角色。

设置

  1. 选择您要管理的服务器。
  2. 打开欢迎。
  3. 启用欢迎消息、告别消息或自动身份组。
  4. 选择一个可访问的文本渠道或至少一个角色。
  5. 检查预览并保存更改。

对于自动角色,Fjord 角色必须位于要分配的所有角色之上。

欢迎消息

开关和频道选择可分别编辑。关闭服务会保留所选频道。选择无频道最初只会清空选择,编辑器仍可访问。保存时若没有频道,才会停用对应服务并关闭其消息编辑器。欢迎和告别都遵循此规则。

一旦成员加入服务器,就会发送欢迎消息。频道、消息文本和欢迎卡保存在一起。预览显示保存前文本和欢迎卡如何交互。

发送欢迎消息可选

打开或关闭自动问候语。

频道激活时需要

确定在哪个可访问的文本频道中发布问候语。

消息可选

包含正常消息文本。可以通过选择使用占位符、角色、频道和服务器表情符号。

欢迎卡可选

在欢迎中添加个人设计的图片卡。

消息占位符

占位符替换为示例
{member.user.name}成员的 Discord 用户名corvus48
{member.mention}提及新成员@Mira
{member.user.id}成员的 Discord 用户 ID123456789012345678
{member.user.global_name}成员的全局显示名称Mira
{guild.name}服务器名称Fjord社区
{guild.member_count}当前会员数量1,248

在编辑器中使用占位符选择。这样可以准确地使用名称,并避免大括号中的拼写错误。

消息编辑器和卡片附件

{guild.icon}服务器图标
{member.avatar}成员头像

没有保存的自定义配置时,欢迎卡片默认开启,嵌入内容默认关闭。离开消息默认普通文本,无嵌入内容和卡片。欢迎、离开和加入身份组分别启用。两个消息编辑器均提供 V1 和 V2、可选文本及可选嵌入内容。生成卡片开关位于欢迎编辑器。文本为空时使用界面显示的默认文本。

消息正文最多 1,800 字符,与嵌入文本分别计算。

欢迎与离开消息各有独立的 V1/V2 选择器。切换需要确认,会重置该编辑器的消息文本、嵌入内容、图片和链接按钮。频道、启用状态及独立的卡片设计会保留。保存才会应用切换,取消恢复之前保存的状态。

V1

V1 使用 Discord 经典嵌入内容,包含强调色和固定区域。最多十个嵌入内容。表中的数字是字符上限。所有嵌入内容的作者、标题、描述、页脚以及全部字段名和字段值合计最多 6000 个字符。普通消息文本有单独的上限。 每个 V1 嵌入最多支持 25 个字段。

输入项字符上限状态
作者256可选
作者 URL512可选
标题256可选
标题链接(可选)512可选
描述4096可选
页脚文本2048可选
字段名称256添加后必填
字段值1024添加后必填

所有设计区域均可选。添加字段后,字段名和字段值均为必填。请删除不用的字段。并排显示启用行内字段,实际布局由 Discord 和屏幕宽度决定。作者链接和图标需要作者名,标题链接需要标题,页脚图标需要页脚文本。可选链接必须是完整 HTTP(S) 地址。时间戳显示发送时间。

普通文本、V1 描述和字段值支持身份组及频道选择器。作者、标题、页脚和字段名不提供这些提及选择器,但可使用服务器表情。作者 URL 和标题链接只接受网址,不能插入身份组、频道或表情。经典嵌入内容中的提及不会发送通知。

只有同时填写作者名称时,Discord 才会显示作者图标。请在上方输入名称,使图标出现在预览中。 只有同时填写页脚文本时,Discord 才会显示页脚图标。请在上方输入文本,使图标出现在预览中。

V2

图片块可包含最多十张图片的图库。使用“+ 添加图片”添加图片,每张图片均可单独移除。每张图片和缩略图可选填最多 80 个字符的描述,并设置剧透。段落最多支持三个文本,每个最多 4000 个字符。使用“+ 添加文本”增加最多两个额外文本。在附加组件中选择缩略图或链接按钮。链接按钮必须填写最多 80 个字符的标签和最多 512 个字符的完整 HTTP(S) URL。表情符号及禁用选项为可选项。额外文本和附加按钮计入组件总数。图库中的单张图片不计为额外组件。

在 V2 中,可以将容器和图片(包括缩略图)标记为剧透。内容最初隐藏,点击后显示。

V2 提供最多十个容器,各有强调色。文本块或右侧可选缩略图的段落各支持最多 4000 个字符及 Markdown。分隔线可显示线条或仅留白,间距可选小或大。可添加、复制、删除及通过箭头排序块。空文本和图片块不会产生可见内容。 V2 文本区域提供身份组、频道及服务器表情选择器。

V2 没有经典作者字段、标题链接输入框、行内字段、页脚图标或时间戳开关。请在文本块中用 Markdown 设置标题及链接。下方示例可制作小号页脚,时间标记可插入时间戳。V1 不支持自由排列的 V2 块。同一条消息不能混合两种格式。

-# ... · {time.full}

容器

快捷颜色 · 10

文本块

Markdown · 4000

带缩略图的段落

Markdown · 4000 · Thumbnail ≤ 5 MB

图片

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

分隔线

显示分隔线 · 小 / 大

V2 的整条消息合计最多 40 个组件。容器、文本、段落、缩略图、图片画廊、分隔线、操作行、按钮及菜单都分别计数。菜单选项不单独计数。自动添加的分隔线及控件也占用额度。例如,包含文本、图片、分隔线以及带操作行按钮的容器需要六个组件。 因此十个容器不能无限填充。

六个消息占位符也适用于两种格式的文本区域。没有全局显示名时使用用户名。不支持提及的 V1 区域不提供成员提及占位符。V1 作者图标、缩略图、大图和页脚图标,以及 V2 缩略图和图片块,可选择自有图片、服务器图标或成员头像。服务器没有图标时该图片为空。预览使用你的账号,发送使用实际成员。这些动态图片来源仅用于欢迎和离开消息。

关闭嵌入内容时,开启的欢迎卡片与普通文本一起作为独立图片发送。开启嵌入内容时,占用第一个 V1 嵌入的大图位置,或插入第一个 V2 容器。该卡片位置不能替换为自有大图。其他嵌入和额外 V2 图片块可使用自有图片。重新排序后卡片属于新的第一个嵌入。卡片设计独立于 V1/V2。

图片限制按每个文件计算。V1 作者图标、缩略图和页脚图标各最多 5 MB。大图上限与下方 V2 图片块上限相同。支持 PNG、JPG/JPEG、WebP 和 GIF。选择文件替换图片,删除清空位置。作者和页脚图标没有对应文本时不可见。

在消息中插入内容

消息编辑器有自己的占位符、角色、频道和服务器表情符号选择。选定的条目将插入到当前写入位置。

选择用法
占位符插入上表中的动态成员或服务器信息。
角色浏览服务器的角色并插入所需的角色提及。 @everyone 无法选择。
频道浏览可用频道并设置频道链接。
服务器表情符号浏览服务器自己的表情符号并插入静态或动画服务器表情符号。

您可以使用编辑器中的按钮打开选择。写入时,@ 打开角色选择,# 打开频道选择,: 打开服务器表情符号选择。输入的其他字符会过滤相应的列表。

欢迎消息和告别消息每条最多可包含 1,800 个字符。插入的条目算作消息内容的一部分。

设计欢迎卡

卡片编辑器包含内容、布局、表面、圆环和文本。

内容

内容包括背景图片、可选纯色背景、标题、副标题,以及带搜索、预览和分页的字体选择。

布局

布局可选左侧或居中。

画布

表面提供普通不透明度 0–100%,或可选 Liquid 层的颜色、不透明度 0–100% 和模糊 0–64 px。Liquid 开启时普通不透明度控件禁用。

环

圆环提供底色、强度 0–100%,及可选着色器的颜色、强度 0–100% 和角度 0–360°。

文本

文本提供底色、强度,及可选着色器的颜色、强度和位置 0–100%。

没有头像大小、单独字号或任意文本位置的自由控件。

重置恢复默认设计。保存或取消通过共用保存栏进行。

可使用默认背景、纯色或自己的图片。在裁剪编辑器中移动和放大图片。画布区域还提供液态图层,可设置颜色、不透明度和模糊。

属性支持注释
文件大小最大 10 MB较大的文件无法保存为背景。
图片格式PNG、JPG/JPEG、WebP、GIF实际文件格式根据图片内容判断。
欢迎卡格式1200 × 600像素所选图像将被裁剪到编辑器中的此欢迎卡部分。
动画静态结果完成的欢迎卡保存为PNG。因此,不会保留 GIF 或 WebP 文件中的动画。

标题 ≤ 120 · 副标题 ≤ 160

卡片占位符

{member.user.name} · {guild.name} · {guild.member_count}

卡片为 1200 × 600 像素,输出为静态 PNG。预览使用你的账户及所选服务器的示例数据。成员加入时会使用该成员的数据。浏览器预览需要有效的控制面板连接。

告别消息

开关和频道选择可分别编辑。关闭服务会保留所选频道。选择无频道最初只会清空选择,编辑器仍可访问。保存时若没有频道,才会停用对应服务并关闭其消息编辑器。欢迎和告别都遵循此规则。

当成员离开服务器时发送告别消息。它可以使用不同的目标通道和自己的文本。离开后,提及的问题并不总是能够得到解决。因此,建议使用 {member.user.global_name}。

发送告别消息可选

打开或关闭自动告别消息。

频道激活时需要

确定将在哪个可访问的文本频道中发布告别消息。

消息可选

包含最多 1,800 个字符的告别文本以及可用的插入辅助工具。

自动角色

Fjord 可以在新成员加入后立即为其分配多个角色。无法分配 Discord 管理的角色以及 Fjord 角色之上的角色。

自动角色可选

加入时打开或关闭角色分配。

角色激活时需要

浏览角色选择并选择至少 1 个、最多 25 个角色。

  1. 在服务器设置 → 角色下检查 Fjord 角色是否高于目标角色。
  2. 激活自动角色分配并选择所需的角色。
  3. 保存选择。

不应自动分配具有广泛管理权限的角色。 Fjord 仅显示通常可分配的角色。

修复错误

问题检查
未发送任何消息。服务是否已激活、通道是否仍然可用以及 Fjord 是否允许查看并写入?
欢迎卡丢失。欢迎卡是否已激活,Fjord 的目标通道中是否有“附加文件”?
未分配角色。Fjord 角色是否高于目标角色,Fjord 是否具有“管理角色”功能?
占位符保持不变。它是使用占位符选择插入的吗?拼写和括号是否正确?
未出现更改。通过共用保存栏保存待处理修改;消息和卡片的修改会一起应用。

V2 每个操作行最多容纳五个链接按钮,使用总组件额度,而非 V1 的五行上限。

链接按钮打开网站,不分配身份组。每个新增按钮必须有最多 80 字符的标签和最多 512 字符的完整 HTTP(S) URL。表情可选。可排序或删除按钮。V1 将按钮放在嵌入内容下方,每行最多五个按钮、合计最多五行,即最多 25 个按钮。V2 放在对应容器内,按钮及操作行都计入 40 组件额度。

只有启用嵌入内容时才发送链接按钮。

要求与限制

有效设计不需要填写所有可选区域。仅颜色或空块不能代替发布所需的可见内容。预览不会发送消息,也不能代替目标频道的实际测试。两个编辑器都不提供投票、贴纸、表单或自由编程的操作。数据及编辑权限也取决于你获得的控制面板授权。

预览、剧透与图片文件

V2 预览中的单张图库图片保留原始宽高比。多张图片以统一的 16:9 裁切区域组成网格。两张或四张图片使用两列,三张以及五至十张图片使用三列。缩略图位于分区文字右侧。图片描述用作替代文字,不会成为额外可见的图片说明。

图片和容器的剧透开关属于 V2 编辑器。每张图库图片及缩略图可以独立隐藏。容器剧透隐藏内容,但保留可见的外框。点击会在预览中显示内容,不会更改已保存的剧透设置。成员也可以在 Discord 中点击显示剧透内容。

消息图片支持 PNG、JPG/JPEG、WebP 和 GIF。文件类型必须与图片内容一致。更改 HTML 或 SVG 文件的扩展名不会让它成为受支持的图片。图片表格中的大小限制仍适用于每个文件。如果本地图片被拒绝或无法读取,请重新选择原始文件并再次保存。

Markdown 文字区域支持网页和电子邮件链接。预览可以打开 HTTP(S) 和 mailto 链接,但不会打开本地文件或 Blob 地址。作者链接、标题链接和链接按钮必须使用完整的 HTTP(S) URL。预览不会发布消息。请在 Discord 中检查保存后的结果,显示效果可能因客户端和屏幕宽度而异。