Fjord 文档
模块
01
欢迎
欢迎新成员、送别离开的用户,并自动分配身份组。
包含的功能
- 自定义欢迎和告别消息
- 自定义欢迎卡片
- 为新成员自动分配身份组
- 为加入和离开分别设置频道
欢迎什么?
通过欢迎,您可以自动问候新成员、告别离开的成员以及在加入时分配角色。所有三个区域都可以独立使用。
所需的 Discord 权限
欢迎卡需要“附加文件”。仅自动角色需要管理角色。
设置
- 选择您要管理的服务器。
- 打开欢迎。
- 启用欢迎消息、告别消息或自动身份组。
- 选择一个可访问的文本渠道或至少一个角色。
- 检查预览并保存更改。
对于自动角色,Fjord 角色必须位于要分配的所有角色之上。
欢迎消息
开关和频道选择可分别编辑。关闭服务会保留所选频道。选择无频道最初只会清空选择,编辑器仍可访问。保存时若没有频道,才会停用对应服务并关闭其消息编辑器。欢迎和告别都遵循此规则。
一旦成员加入服务器,就会发送欢迎消息。频道、消息文本和欢迎卡保存在一起。预览显示保存前文本和欢迎卡如何交互。
打开或关闭自动问候语。
确定在哪个可访问的文本频道中发布问候语。
包含正常消息文本。可以通过选择使用占位符、角色、频道和服务器表情符号。
在欢迎中添加个人设计的图片卡。
消息占位符
| 占位符 | 替换为 | 示例 |
|---|---|---|
{member.user.name} | 成员的 Discord 用户名 | corvus48 |
{member.mention} | 提及新成员 | @Mira |
{member.user.id} | 成员的 Discord 用户 ID | 123456789012345678 |
{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 | 可选 |
| 作者 URL | 512 | 可选 |
| 标题 | 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 个角色。
- 在服务器设置 → 角色下检查 Fjord 角色是否高于目标角色。
- 激活自动角色分配并选择所需的角色。
- 保存选择。
不应自动分配具有广泛管理权限的角色。 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 中检查保存后的结果,显示效果可能因客户端和屏幕宽度而异。
02
自动管理
AutoMod 检测不需要的内容并按照服务器规则采取操作。
- 针对内容、刷屏、链接和提及的十种过滤器
- 分别设置身份组和频道的适用范围
- 最多十级警告,可删除内容、禁言、踢出或封禁
03
活动日志
在选定的 Discord 频道中清晰记录重要事件。
- 支持 89 种事件类型
- 共用一个日志频道
- 可单独启用的日志
04
嵌入内容
使用可视化编辑器创建结构化消息,无需编写 JSON。
- 标题、描述、字段和媒体
- 编辑时实时预览
- 保存并再次编辑
自选身份组
成员通过按钮和下拉菜单选择身份组。配置身份组组合、V1/V2 消息以及可管理的发布消息。
包含的功能
- 两种格式均支持预览、强调色、图片、多个嵌入内容及展开、复制、删除、排序嵌入。V1 使用 Discord 固定字段,V2 使用自由排列的块。后续章节说明输入内容及差异。
- 身份组按钮支持标签、表情、四种样式及每个选项一个或多个身份组
- 下拉菜单支持提示文本、描述、表情及单选或多选
- V1 支持在整条消息下方添加多个独立身份组选择器,共用最多五个操作行。每个菜单占一行,最多五个按钮共用一行。因此只有没有额外按钮行时才能使用五个菜单。每个选择器最多 25 选项。V2 的每个容器有自己的按钮或菜单选择器,计入共用组件额度。移动 V1 嵌入不会移动独立选择器。本模块提供蓝、灰、绿、红身份组按钮,但没有网站链接按钮编辑器和单次发送。
- 实时预览可模拟身份组选择,不会更改成员的真实身份组
- 命名和复制消息组合、保存草稿、发布和更新消息以及移除发布消息
- 提供身份组权限和层级、图片大小、文本上限及共享组件上限的说明
05
设置
在设置中,你可以选择语言、时区和嵌入消息的默认颜色,委派控制面板访问权限,并管理已保存的模块数据。
- 机器人嵌入消息的默认颜色
- 语言和时区
- 委托管理控制面板
- 管理已保存的模块数据
06
命令
Fjord 的所有斜杠命令、所需权限及故障排查方法。