Camera Circles

插件

· 作者 chai0k

在玩家头顶添加实时圆形摄像头画面

0 本站下载 0 关注 更新于 5 个月前

最新 fabric-1.0.0+26.1.2 · 26.1.2 · Fabric

一键开服(送7天)

Camera Circles

在《Minecraft》中查看好友的面容。Camera Circles 会将你的网络摄像头画面以实时视频圆圈的形式投射到你头顶上方,发送给其他玩家——就像 Telegram 的视频消息,但存在于游戏之中。

Mod in action

功能介绍

  • 你的网络摄像头会显示为一个悬浮在你头顶的小圆形实时画面,这样其他玩家在游玩时就能看到你的脸。
  • 提供两种显示样式可供选择:悬浮圆圈(位于头顶上方)或将其烘焙到玩家面部(类似肖像画效果)。
  • 无需额外的网络设置——无需开放防火墙端口,也无需独立的 VoIP 服务器。视频流通过你正常的 Minecraft 连接传输。
  • 摄像头不会自动开启。由你决定何时进行广播。

安装

你需要在两个地方安装该模组:客户端(用于广播和观看他人)以及服务端(用于将视频中继给其他玩家)。如果只有一方安装了,则无法正常工作。

1. 在你的 Minecraft 客户端 (Fabric)

  1. 从 发布页面 下载 fabric-1.0.0+26.1.2.jar。
  2. 将其放入 Fabric 配置文件的 mods/ 文件夹中。
  3. 确保你也已安装 Fabric API。
  4. 启动游戏。

2. 在你的服务器上

选择符合你服务器架构的版本。

独立服务器(无代理): 将 bukkit-1.0.0+26.1.2.jar 放入 plugins/ 文件夹。适用于 Paper、Spigot、Bukkit、Purpur 和 Folia。

位于 Velocity 代理背后的服务器网络: 将相同的 bukkit-1.0.0+26.1.2.jar 放入 Velocity 的 plugins/ 文件夹。完成——你不再需要单独在后端服务器上安装它了。摄像头现在可以在整个网络中工作:在 Lobby 广播的人可以被在 Survival 服的朋友看到。

如果你在 Velocity 和后端都安装了插件,Velocity 版本的优先级更高,后端的副本将处于闲置状态。你可以安全地移除它们。

Java 版本

服务端 Jar 包需要 Java 25 或更高版本。现代 Minecraft 26.1+ 已经要求此版本,因此在大多数情况下你无需担心。

使用方法

默认情况下,所有内容都会保持静默,直到你按下其中一个按钮。

  1. 按 K 打开 Camera Circles 设置界面(可在常规控制菜单中重新绑定按键)。
  2. 点击设置屏幕右上角的 OFF 按钮以开启摄像头。它会变为绿色并显示 ON。
  3. 就是这样——此时你周围的其他玩家会在你头顶看到一个包含你摄像头的圆圈。

再次按下切换键即可停止。如果你在游戏过程中关闭了游戏,Camera Circles 会记住该状态,并在下次加入服务器时自动重新开启摄像头。你可以更改此行为——详见下方的“自动启动”。

设置

使用 K 打开设置界面(或者在 选项 → 控制 → 按键绑定 → Camera Circles 下将其绑定为你想要的任意按键)。

设置分为四个标签页:

Camera(摄像头) — 选择使用哪个设备、发送画面的分辨率以及帧率。

  • Camera — 如果你有多个摄像头,请选择特定的一个。保持 auto(自动)将使用第一个可用的摄像头。
  • Target FPS — 每秒发送的帧数。数值越高越流畅,但对网络和 CPU 的负担也越重。
  • Width / Height — 画面分辨率。
  • JPEG quality — 画面清晰度。数值越低画面越模糊,但对网络的负担越轻。

如果服务器对这些参数的限制低于你的设置值,滑块旁边会出现一个小的黄色 ⚠️ 图标——你在该服务器广播时,你的设置值会被静默限制,但你的偏好设置在其他服务器上仍会保留。

Display(显示) — 摄像头在世界中的显示方式。

  • Display — Disabled(不绘制任何内容)、Above the player(悬浮圆圈,默认)或 On the player's face(摄像头烘焙到头模型上)。
  • Show self — 你是否能在游戏中看到自己的圆圈。Off、Third-person only(默认,仅当你按 F5 切换到第三人称视角时可见)或 Always。
  • Auto-start — 当你加入服务器时的行为:Never(始终从摄像头关闭状态开始)、If was on(记住上一次的状态——默认)或 Always(始终开始广播)。
  • Circle size — 屏幕上悬浮圆圈的大小。

Hotkeys(热键) — 更改切换摄像头、打开设置界面以及切换圆圈可见性的按键。

Hidden(隐藏) — 当前正在广播的玩家列表。点击其中任意一名玩家,即可仅对你自己隐藏其圆圈(个人静音——不影响其他任何人)。

服务器管理员须知

服务端配置文件位于 plugins/CameraCircles/server.json(或在 Velocity 上为 plugins/cameracircles/server.json)。首次运行插件时会自动生成带有合理默认值的配置文件。

你可以限制:

  • 允许玩家广播的最大分辨率
  • 最大帧率
  • 每个广播者的最大带宽(kbps)
  • 同时广播的人数上限
  • 视距——仅在此距离内的玩家能看到圆圈(设置为 0 表示无限制)

代码中还内置了硬性绝对上限(640×480 分辨率、30 FPS、2000 kbps)。配置错误的服务器无法突破这些限制——即使你将 JSON 编辑为荒谬的数字,它们在启动时也会被强制钳制。这是有意为之:这使插件能够防止 DoS 攻击。

要控制谁可以广播,请使用 cameracircles.use 权限。默认情况下它授予所有人(在 plugin.yml 中为 default: true)。若要限制,请使用任何标准的权限插件(如 LuckPerms、PermissionsEx 等),并为特定玩家或组撤销该权限。

故障排除

加入服务器时聊天栏出现 “Camera Circles is not installed on this server”。 服务器未安装该插件。要么请管理员安装它,要么它被安装在了无法检测到你的位置(例如仅安装在代理上,而你是直接连接的)。

即使我设置了“If was on”,我的摄像头也不会自动开启。 确保你上次游玩时将摄像头留在了开启状态。断开与服务器的连接会保留你的“我想广播”偏好;按下切换键将其设为 OFF 则会清除该偏好。

其他玩家上方不会显示任何内容。 请确保:

  • 对方正在广播(其圆形图标必须处于开启状态,而不仅仅是已安装)。
  • 你的“显示”设置未设为禁用。
  • 对方不在你的隐藏列表中(请在设置的“隐藏”标签页中检查)。
  • 你处于服务器的最大视距范围内。

在“位于玩家面部”模式下,我的摄像头画面没有出现在其他人的脸上。 此模式将摄像头渲染为头部模型上的高分辨率叠加层。它仅从正面可见——从侧面或背面时,你会看到朋友原本的皮肤。这是设计如此(摄像头物理上无法位于他人头部后方)。此外,服务器端需要 Java 25 或更高版本。

开启摄像头后帧率下降。 尝试在“摄像头”选项卡中降低分辨率、帧率或 JPEG 质量。流媒体数据量越轻,对你的客户端和网络造成的负担就越小。

隐私

以下是一些注意事项:

  • 除非你有操作,否则摄像头绝不会自动开启。“自动启动”功能仅在恢复你之前选择开始的会话。
  • 视频帧通过正常的 Minecraft 连接传输。它们未单独加密,因此其私密性与到服务器本身的连接相当。请将其视为任何未加密的网络摄像头流来处理。
  • 视频帧绝不会上传至 Mojang、Microsoft 或任何外部服务。它们仅通过你自己的游戏服务器传输,并发送给该服务器上的其他玩家。
  • 你客户端的偏好设置(摄像头选择、隐藏的玩家等)存储在本地机器上,永远不会发送到服务器。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源