Viscord

Viscord

一个Discord和Fluxer三向多服务器支持聊天集成

实用

Viscord - 适用于 Hytale 的 Discord + Fluxer 桥接

将你的 Hytale 服务器连接到 Discord、Fluxer 或两者。玩家聊天、加入和离开以及服务器状态会实时流出——消息也会流回游戏。两个服务器可以共享一个聊天频道,同时保持各自的本地聊天内容相互独立。

聊天会以输入者的身份显示,使用其自己的名称和渲染后的 Hytale 头像。仅服务端。玩家无需安装任何内容。

功能

  • Discord 和 Fluxer 并行 - platform = "discord"、"fluxer" 或 "both"。每一侧都有自己的机器人令牌、频道和 webhook。
  • 以玩家身份聊天,而非机器人 - Viscord 在首次连接时会在你的聊天频道中创建或复用一个 webhook,因此每一行都会以 [HY] Steve 发布,并使用 Steve 自己的头像。无需手动设置 webhook。
  • 玩家头像 - 头像从玩家的 Hytale 个人资料以四分之三角度渲染,最高 2048px。avatar_type、avatar_size 和 avatar_rotation 控制它,或者将 avatar_url 指向你自己的图像。
  • 服务器到服务器 - 将多个游戏服务器运行到一个社区频道中:每个服务器用自己的前缀标记其行,循环防护会丢弃你自己发出的回来的帖子,这样没有人会看到自己的话两次。聊天和事件频道都会被读取,因此另一个服务器的公告也能传达到你的玩家。
  • 可选的前缀过滤 - 要求游戏聊天在离开服务器之前带有前缀(!、.、任何内容),并在传出时将其去除。本地闲聊留在本地。
  • 独立频道 - 聊天发送到一个频道,加入/离开/状态嵌入发送到另一个频道,在两个平台上都是如此。
  • 三向模式 - 在 Discord 和 Fluxer 之间镜像聊天,用其来源([Discord]、[Fluxer])标记每一行,以便另一侧可以识别它。
  • 模板 - 重写两个方向:{message}、{username}、{prefix}、{uuid}。
  • 过滤器 - 忽略机器人和 webhook(带有受信任机器人允许列表),丢弃标记有另一个服务器前缀的消息,使用 Discord 显示名称。
  • 在设置之前就可用的命令 - /viscord status 显示令牌、频道、连接状态和配置路径;/viscord reload 应用配置编辑而无需重启。
  • 设计上保持安静 - Discord 和 Fluxer 的工作会从游戏线程中转发出去。慢网络永远不会阻塞服务器;失败会记录日志,不会崩溃。

安装

  1. 将 viscord-hytale-<version>.jar 放入你服务器的 mods/ 文件夹。
  2. 启动服务器一次。Viscord 会写入 mods/network.vonix.viscord_Viscord/viscord.toml,其中包含每个选项和解释它的注释。
  3. 填写你的令牌和频道 ID,然后运行 /viscord reload(或重启)。

在聊天频道中为机器人授予 管理 Webhook 权限,并在 Discord 开发者门户中启用 消息内容意图——这两项是让聊天显示玩家名称和读取消息的关键。

[general]
enabled = true
platform = "both" # discord | fluxer | both
chat_to_discord = true
discord_to_chat = true
debug = false # verbose logging when chasing a filter problem

[general.tridirectional]
enabled = false # true = mirror chat between Discord and Fluxer
discord_to_fluxer = true
fluxer_to_discord = true
show_source = true # tag relayed lines with [Discord] / [Fluxer]

[server]
prefix = "[HY]" # how this server is identified in shared channels
name = "My Hytale Server"
avatar_type = "headshot" # headshot | fullbody | none
avatar_size = 2048 # 64, 96, 128, 256, 512, 1024, 2048
avatar_rotation = 45 # multiple of 15; 45 = three-quarter view
avatar_url = "" # full custom template, overrides the three options above

[discord]
bot_token = ""
channel_id = ""
auto_webhook = true # create/reuse a webhook so chat shows player names
auto_webhook_name = "Viscord"
webhook_url = "" # set to use your own webhook instead
invite_url = ""

[discord.events]
channel_id = "" # separate channel for join/leave/status

[fluxer]
bot_token = ""
channel_id = ""
event_channel_id = ""
webhook_url = ""

[messages]
game_to_discord = "{message}"
game_to_discord_bot = "**{username}**: {message}" # used only if no webhook is available
discord_to_game = "[Discord] {username}: {message}"
webhook_username = "{prefix} {username}"
use_display_name = true

[messages.events]
join = true
leave = true
startup = true
shutdown = true

[filters]
ignore_bots = true # turn off for server-to-server: other servers post as bots
ignore_webhooks = true
trusted_bot_ids = ""
ignore_own_prefix = true # loop guard: drop our own posts coming back
show_other_server_events = true # relay other servers' tagged messages into game
require_prefix = false # true = only relay chat starting with the prefix

[filters.chat]
prefix = "!"

[bot_status]
enabled = true
format = "Online: {online}/{max}"

要求

  • Hytale 专用服务器 0.7.x(针对 0.7.4 构建并验证)
  • Java 25(随 Hytale 服务器安装捆绑)
  • 端:仅服务端 · 无依赖

说明

  • 当前版本:1.0.0 - 稳定接口(配置键和 /viscord 命令)。
  • 早期插件:Hytale 服务器 API 还很年轻,并且会在版本之间变化。请固定与你的服务器版本匹配的插件版本。
  • 配置编辑通过 /viscord reload 应用;更新插件时会自动添加缺失的键,格式错误的文件会回退到默认值,而不是禁用聊天。
  • 头像由公共 hytl.skin API 渲染。设置 avatar_type = "none" 可完全跳过该调用。
  • Viscord 仅使用你自己的令牌与 Discord 和 Fluxer API 通信。没有第三方 webhook,也没有玩家数据收集。

支持

问题和配置帮助:https://vonix.network - 或在 Vonix Network Discord 中找到我们。

由 Vonix Network 构建,他们也是 Minecraft 版 Viscord 背后的团队(1.18.2 -> 26.3,Fabric / Forge / NeoForge)。