Viscord – Discord/Fluxer Server to Server

Viscord

将你的 Minecraft 服务器连接到 Discord、Fluxer，或同时连接两者。

Viscord 是一款适用于 Minecraft 专用服务器的服务端双向聊天集成模组。它可将游戏内聊天和服务器事件连接到 Discord 与 Fluxer，同时不影响玩家端体验：玩家无需安装 Viscord。

功能

• 支持 Discord 和 Fluxer — 可仅使用 Discord、仅使用 Fluxer、让两个平台独立运行，或启用 Discord ↔ Fluxer ↔ Minecraft 三向互通。
• 双向聊天 — 将 Minecraft 消息发送到社区平台，并将平台消息转发回 Minecraft。
• 丰富的格式设置 — 支持 Minecraft 颜色格式、Discord 风格格式、自定义前缀和消息模板。
• 服务器事件 — 播报玩家加入、离开、死亡、取得进度，以及服务器启动和关闭事件。
• 多频道监控 — 为单个服务器连接配置多个聊天频道和事件频道。
• 多服务器转发 — 为每台服务器设置独特前缀，并使用可信的机器人或 Webhook 标识，实现可控的跨服务器事件和消息转发。
• 账号关联 — 使用短时有效且安全生成的验证码，将 Minecraft UUID 与 Discord 账号关联。
• 玩家偏好设置 — 允许玩家分别控制是否接收桥接聊天、事件通知和系统消息。
• 热重载 — 使用 /viscord reload 重新加载配置，日常修改无需完整重启服务器。
• 异步运行 — 网络任务、状态更新和数据持久化均在 Minecraft 刻循环之外处理，并采用有界调度和背压机制。
• 防止循环转发 — 过滤由自身发出的机器人、Webhook 和带前缀消息，避免平台间产生回声循环。
• 仅服务端 — 原版客户端可正常连接；无需安装客户端模组。

支持的桥接模式

Discord       Minecraft ↔ Discord
Fluxer        Minecraft ↔ Fluxer
Both          Minecraft ↔ Discord and Minecraft ↔ Fluxer
Tridirectional Discord ↔ Fluxer ↔ Minecraft

实用命令

/viscord reload                    Reload safe configuration changes
/viscord status                    Inspect bridge status
/viscord discord link              Begin account linking
/viscord discord unlink            Remove a linked account
/viscord discord messages          Toggle bridged message preferences
/viscord discord events            Toggle event notification preferences

服务端安装

1. 下载与你的 Minecraft 版本和加载器相匹配的 Viscord 构建版本。
2. 将 JAR 文件放入服务器的 mods/ 文件夹。
3. 启动一次服务器以生成 config/viscord/viscord.toml。
4. 配置所选平台的凭据、频道、Webhook、服务器标识和消息格式。
5. 安全修改配置后，使用 /viscord reload。

请妥善保管机器人令牌和 Webhook URL。它们只能保存在服务器配置中，切勿公开分享。

兼容性

Viscord 为受支持的 Minecraft 版本系列提供对应版本的 Fabric、Forge 和 NeoForge 构建版本，包括 1.18.2、1.19.2、1.20.1 和 1.21.1 模板。各版本模块共享桥接功能，并会持续维护。

专为专用服务器打造的社区桥接

无论你需要简单的 Discord 聊天转发、Fluxer 连接、事件通知，还是三方社区互通，Viscord 都能让集成保持可配置、异步运行，并且无需客户端安装。

项目： Vonix Network
项目版本： 5.0.0
发布系列： V2 common rewrite