3D浮动聊天

3D Floating Chats

将直播聊天带入你的 Minecraft 世界。3D Floating Chats 以悬浮卡片的形式在玩家附近显示消息，并配有平台图标、动画、表情以及可选的声音和粒子效果。

该模组运行于 Minecraft 客户端；无需安装在服务器上。Fabric 版本适用于 Minecraft 1.21、1.21.1、1.21.4 和 1.21.11。

功能特性

• 最多可同时连接 10 个公开的 Twitch、Kick 或 YouTube 频道。每张卡片都会显示发送消息的平台和频道。
• 通过 Social Stream Ninja 显示来自 TikTok、Facebook、Twitch、Kick 和 YouTube 的消息。
• 可将卡片固定在世界中，或让它们按配置的距离跟随玩家，同时保留出现时的方向。
• 让卡片面向玩家，或保持其原始朝向。卡片也可以在你面前的随机位置出现。
• 自定义进入、退出和击中动画，包括淡入淡出、缩放、弹跳和滑动。
• 点击卡片可将其关闭，并可选触发击中粒子和声音。卡片出现时可播放单独的声音。
• 使用 Minecraft 粒子和声音 ID，或添加你自己的 PNG 粒子和 WAV PCM 声音。为每个平台选择不同的自定义粒子，并调整其颜色、亮度、不透明度、大小、速度、重力等。
• 调整卡片大小、文字大小、持续时间、阅读时间以及可见卡片的最大数量。较长的消息会自动换行并在需要时跨页继续。
• 显示支持的表情符号、表情和贴纸。你也可以添加自己的图片和动态 GIF 表情。
• 按下 K 键可在可滚动历史记录中查看错过的消息。
• 使用模拟消息预览模组，无需连接直播。
• 使用 Social Stream Ninja、Streamer.bot 或本地 HTTP 桥接进行更多聊天配置。

快速上手

1. 为你的 Minecraft 版本安装 Fabric Loader、Fabric API 和 Java 21。
2. 下载与你的 精确 Minecraft 版本匹配的 JAR 文件，并将其放入 mods 文件夹。
3. 进入世界并按下 F8 打开设置。

若要直接连接，请打开 连接频道，选择 Twitch、Kick 或 YouTube，输入频道名称或 @handle，然后选择 添加频道。重复此操作可添加更多频道。YouTube 直接聊天需要已启用聊天的公开直播。

对于 TikTok、Facebook 或其他受支持的 Social Stream 配置，请按照 F8 菜单中的 Social Stream 指南操作。直接频道连接读取公开聊天；向直播发布消息则使用 Social Stream Ninja。

从 Minecraft 发送消息

配置好 Social Stream Ninja 后，你可以使用客户端命令向已连接的平台发送消息：

/fn kick Hello!
/fn youtube Hello!
/fn facebook Hello!
/fn all Hello, everyone!

平台名称支持 Tab 补全。你也可以在 F8 中启用 直接聊天模式 并选择一个目标。该模式激活时，在 Minecraft 聊天中输入的普通消息会发送到所选的直播聊天。使用 /fn mode off 可返回 Minecraft 聊天。

发送消息需要有能够向目标平台发帖的活动 Social Stream Ninja 源。发送到平台的消息是公开聊天消息，而非私密回复。

按键操作

按键	操作
F8	打开设置
K	打开消息历史
F7	切换周期性测试消息
F9	切换卡片是否跟随玩家
F10	切换点击卡片关闭功能

自定义粒子、声音和表情

打开 F8 → 击中与效果 以访问粒子和声音文件夹。添加 PNG 粒子或 WAV PCM 声音，刷新文件列表，然后在菜单中选择它们。自定义文件最大可为 2 MB。最大 4096 × 4096 的粒子 PNG 会自动调整大小以进行渲染。

对于自定义表情，请从 F8 → 文字与表情 打开文件夹。添加例如 hello.png 的图片，然后在消息中使用 :hello: 来显示它。

所有卡片、动画、粒子和声音均在客户端本地渲染。