VibeShare Minecraft
在 Minecraft 中直接与其他玩家分享图片、GIF 和视频。
VibeShare 添加了一个简洁的游戏内界面,玩家可以在其中粘贴媒体 URL、添加简短的说明文字、选择提示框(toast)出现的位置、调整提示框大小,并将其发送给服务器上的所有玩家。媒体将以小型提示框覆盖层的形式显示,并采用队列机制,使消息依次出现,而不是同时覆盖整个屏幕。
功能
- 游戏内媒体分享界面,默认按
V 键打开。
- 从 HTTP/HTTPS URL 分享图片、GIF 和视频。
- 为每个分享的媒体提示框添加说明文字。
- 选择提示框角落:左上角、右上角、左下角或右下角。
- 自定义提示框大小。
- 控制视频音量和静音状态。
- 队列系统,确保媒体一次播放一项内容。
- 本地“跳过”按钮,仅为您自己跳过当前媒体。
- 本地“清除队列”按钮,移除您当前正在播放的媒体和队列中的媒体。
- 默认按
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 为每个客户端使用独立的本地队列。
如果多名玩家同时发送媒体,每个客户端会将它们排队并依次显示。
“跳过”仅影响您自己。它会跳过您当前的提示框并进入您本地队列中的下一项。它不会跳过其他玩家的媒体。
“清除队列”也仅影响您自己。它会清除您当前的 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 及其他依赖项仍受其各自许可证的约束。
VibeShare Minecraft
Share images, GIFs, and videos with other players directly inside Minecraft.
VibeShare adds a clean in-game interface where players can paste a media URL, add a short caption, choose where the toast appears, adjust the toast size, and send it to everyone on the server. Media is displayed as a small toast overlay, with a queue so messages appear one after another instead of covering the screen all at once.
Features
- In-game media sharing interface, opened with
V by default.
- Share images, GIFs, and videos from HTTP/HTTPS URLs.
- Add a caption to each shared media toast.
- Choose the toast corner: top left, top right, bottom left, or bottom right.
- Customize toast size.
- Control video volume and mute state.
- Queue system so media plays one item at a time.
- Local
Skip button to skip the current media only for yourself.
- Local
Clear Queue button to remove your current media and queued media.
- Toggle all VibeShare toasts locally with
N by default.
- Player heads appear next to media captions for server-shared media.
- Server-side moderation tools for muting users, blocking domains/URLs, duration limits, URL length limits, and logging.
Requirements
Minecraft
- Minecraft
1.21.1
- NeoForge
21.1.x
The mod was built and tested against NeoForge 21.1.228.
Client
Install VibeShare on every client that should see and send shared media.
For video playback, clients also need:
- WaterMedia
- WaterMedia: Binaries
- Optional: WaterMedia YouTube Plugin, if you want YouTube URL support
Images and GIFs do not require WaterMedia.
Server
Install VibeShare on the server if players should share media with each other.
The server does not need WaterMedia, WaterMedia: Binaries, only WaterVision is required.
How It Works
VibeShare is a client + server mod.
The server receives a media request from a player, checks moderation rules, then broadcasts the media URL and caption to connected clients. Each client then displays the media locally.
This means:
- Every player who wants to see VibeShare media needs the mod installed.
- The server needs the mod for shared multiplayer media.
- To share with other players, use a public or reachable
http:// or https:// URL.
Usage
Press V to open the VibeShare screen.
From the interface, you can:
- Paste a media URL.
- Add display text.
- Preview the media locally.
- Send the media to the server.
- Change the toast corner.
- Change toast size.
- Adjust video volume.
- Mute or unmute videos.
- Skip the current media locally.
- Clear your local queue.
Press N to toggle VibeShare toasts locally. When disabled, VibeShare stops displaying media and clears the current overlay for you only.
Queue Behavior
VibeShare uses a local queue per client.
If multiple players send media at the same time, each client queues them and displays one at a time.
Skip only affects you. It skips your current toast and moves to the next item in your local queue. It does not skip media for other players.
Clear Queue also only affects you. It clears your current VibeShare media and your local queue.
Durations
Images and GIFs display for up to 10 seconds.
Videos play until they end in local preview. On servers, videos respect the server moderation duration limit.
Server operators can change the maximum shared duration with:
/vibeshare filter duration <seconds>
Client Commands
/vibeshare
/vibeshare open
/vibeshare show <url>
/vibeshare send <url>
/vibeshare skip
/vibeshare clear
/vibeshare skip skips the current media locally for you only.
/vibeshare clear clears your local VibeShare overlay and queue.
Server Moderation Commands
Server commands require operator permissions.
Mute a player from sending VibeShare media:
/vibeshare mute <player>
Unmute a player:
/vibeshare unmute <player>
List muted players:
/vibeshare mutes
Add a blocked domain, URL fragment, or pattern:
/vibeshare blacklist add <pattern>
Remove a blacklist entry:
/vibeshare blacklist remove <pattern>
List blacklist entries:
/vibeshare blacklist list
Set max shared media duration:
/vibeshare filter duration <seconds>
Set max URL length:
/vibeshare filter urlLength <characters>
Show current moderation filters:
/vibeshare filter status
Server Logs
VibeShare writes media moderation logs to:
logs/vibeshare-media.log
Accepted and rejected media submissions are logged with the player name, URL, duration, and rejection reason when applicable.
Configuration
Client settings are stored in:
config/vibeshare-minecraft.properties
Server moderation settings are stored in:
config/vibeshare-server.properties
Most player-facing settings can be changed directly from the in-game VibeShare screen.
Notes About Local Files
Local file paths can be previewed on your own client, but they cannot be shared with other players unless those players can access the same path on their own machine.
For multiplayer sharing, use an HTTP/HTTPS URL.
Compatibility Notes
VibeShare is designed for NeoForge 1.21.1.
Video playback uses WaterMedia on the client. If WaterMedia is not installed, videos may not play directly, but image and GIF toasts still work.
VibeShare does not require WaterVision.
Safety
Server owners should configure moderation settings before allowing public media sharing. Use mute, blacklist, URL length limits, duration limits, and logs to keep media sharing manageable.
Players can always disable VibeShare toasts locally with the toggle key.
License and Credits
VibeShare Minecraft is licensed under CC BY-NC-ND 4.0 unless otherwise stated.
This license applies only to VibeShare Minecraft's original code and assets. WATERMeDIA, WATERViSION, VLC, LibVLC, Minecraft, NeoForge, and other dependencies remain under their own licenses.
评论 0
登录后参与评分
还没有评论,来抢沙发吧