VibeShare

VibeShare

在Minecraft中直接与其他玩家分享图片、GIF和视频。

管理

VibeShare Minecraft

直接在 Minecraft 中与其他玩家分享图片、GIF 和视频。

VibeShare 添加了一个简洁的游戏内界面,玩家可以在其中粘贴媒体 URL、添加简短说明、选择提示弹窗出现的位置、调整提示弹窗大小,并将其发送给服务器上的所有人。媒体以小提示弹窗的形式显示,并带有队列系统,使消息依次出现,而不是一次性覆盖整个屏幕。

功能

  • 游戏内媒体分享界面,默认通过 V 键打开。
  • 通过 HTTP/HTTPS URL 分享图片、GIF 和视频。
  • 为每个分享的媒体提示弹窗添加说明文字。
  • 选择提示弹窗的角落:左上、右上、左下或右下。
  • 自定义提示弹窗大小。
  • 控制视频音量和静音状态。
  • 队列系统,使媒体一次播放一个。
  • 本地 Skip 按钮,仅为你自己跳过当前媒体。
  • 本地 Clear Queue 按钮,移除你当前的媒体和队列中的媒体。
  • 通过默认的 N 键在本地切换所有 VibeShare 提示弹窗。
  • 对于服务器分享的媒体,玩家头像会显示在媒体说明文字旁边。
  • 服务端管理工具,用于禁言用户、屏蔽域名/URL、限制时长、限制 URL 长度以及记录日志。

要求

Minecraft

  • Minecraft 1.21.1
  • NeoForge 21.1.x

该模组基于 NeoForge 21.1.228 构建并测试。

客户端

在每个需要查看和发送分享媒体的客户端上安装 VibeShare。

若要播放视频,客户端还需要:

  • WaterMedia
  • WaterMedia: Binaries
  • 可选:WaterMedia YouTube Plugin,如果你想支持 YouTube URL

图片和 GIF 不需要 WaterMedia。

服务器

如果玩家之间需要互相分享媒体,请在服务器上安装 VibeShare。

服务器不需要 WaterMedia、WaterMedia: Binaries,只需要 WaterVision。

工作原理

VibeShare 是一个客户端 + 服务端模组。

服务器接收来自玩家的媒体请求,检查管理规则,然后将媒体 URL 和说明文字广播到已连接的客户端。随后每个客户端在本地显示媒体。

这意味着:

  • 每个想要查看 VibeShare 媒体的玩家都需要安装该模组。
  • 服务器需要该模组才能实现多人共享媒体。
  • 要与其他玩家分享,请使用公开或可访问的 http:// 或 https:// URL。

使用方法

按 V 键打开 VibeShare 界面。

在界面中,你可以:

  • 粘贴媒体 URL。
  • 添加显示文本。
  • 在本地预览媒体。
  • 将媒体发送到服务器。
  • 更改提示弹窗角落。
  • 更改提示弹窗大小。
  • 调整视频音量。
  • 静音或取消静音视频。
  • 在本地跳过当前媒体。
  • 清除你的本地队列。

按 N 键在本地切换 VibeShare 提示弹窗。禁用后,VibeShare 会停止显示媒体,并仅为你清除当前覆盖层。

队列行为

VibeShare 为每个客户端使用本地队列。

如果多个玩家同时发送媒体,每个客户端会将它们排队并一次显示一个。

Skip 仅影响你自己。它会跳过你当前的提示弹窗并移动到本地队列中的下一个项目。它不会为其他玩家跳过媒体。

Clear Queue 也仅影响你自己。它会清除你当前的 VibeShare 媒体和你的本地队列。

时长

图片和 GIF 最多显示 10 秒。

视频在本地预览中播放至结束。在服务器上,视频会遵守服务器的管理时长限制。

服务器管理员可以通过以下命令更改最大共享时长:

/vibeshare filter duration <seconds>

客户端命令

/vibeshare
/vibeshare open
/vibeshare show <url>
/vibeshare send <url>
/vibeshare skip
/vibeshare clear

/vibeshare skip 仅为你自己在本地跳过当前媒体。

/vibeshare clear 清除你的本地 VibeShare 覆盖层和队列。

服务端管理命令

服务器命令需要管理员权限。

禁止玩家发送 VibeShare 媒体:

/vibeshare mute <player>

取消禁止玩家:

/vibeshare unmute <player>

列出被禁言的玩家:

/vibeshare mutes

添加被屏蔽的域名、URL 片段或模式:

/vibeshare blacklist add <pattern>

移除黑名单条目:

/vibeshare blacklist remove <pattern>

列出黑名单条目:

/vibeshare blacklist list

设置最大共享媒体时长:

/vibeshare filter duration <seconds>

设置最大 URL 长度:

/vibeshare filter urlLength <characters>

显示当前管理过滤器:

/vibeshare filter status

服务器日志

VibeShare 将媒体管理日志写入:

logs/vibeshare-media.log

被接受和被拒绝的媒体提交会被记录,包括玩家名称、URL、时长以及适用时的拒绝原因。

配置

客户端设置存储在:

config/vibeshare-minecraft.properties

服务器管理设置存储在:

config/vibeshare-server.properties

大多数面向玩家的设置可以直接从游戏内 VibeShare 界面更改。

关于本地文件的说明

本地文件路径可以在你自己的客户端上预览,但无法与其他玩家分享,除非这些玩家可以在自己的机器上访问相同路径。

对于多人分享,请使用 HTTP/HTTPS URL。

兼容性说明

VibeShare 专为 NeoForge 1.21.1 设计。

视频播放使用客户端上的 WaterMedia。如果未安装 WaterMedia,视频可能无法直接播放,但图片和 GIF 提示弹窗仍然有效。

VibeShare 不需要 WaterVision。

安全

服务器所有者应在允许公开媒体分享之前配置管理设置。使用禁言、黑名单、URL 长度限制、时长限制和日志来保持媒体分享可控。

玩家始终可以通过切换键在本地禁用 VibeShare 提示弹窗。

许可证与致谢

除非另有说明,VibeShare Minecraft 采用 CC BY-NC-ND 4.0 许可。

此许可证仅适用于 VibeShare Minecraft 的原始代码和资源。WATERMeDIA、WATERViSION、VLC、LibVLC、Minecraft、NeoForge 及其他依赖项仍遵循其各自的许可证。