Toby's Camera

模组

· 作者 unrealtoby

使用客户端相机和配套服务器插件捕捉并分享 Minecraft 精彩瞬间

0 本站下载 0 关注 更新于 1 周前

最新 0.2.13+build.28+mc26.3 · 26.3 · Fabric

一键开服(送7天)

TobysCamera

将眼前的 Minecraft 世界转化为持久、可分享的地图照片。

只有摄影师需要 Fabric 客户端模组。服务器端运行 Paper/Folia 插件,而成品媒体以原版的 filled_map(已填充地图)物品形式交付,所有玩家均可查看、持有、交易并将其放置在物品展示框中。

支持 Fabric 1.21.11 / 26.1 / 26.2 / 26.3 客户端以及 Paper 或 Folia 1.21.11+ 服务器。

请确保客户端模组与服务器插件使用相同的 TobysCamera 版本。旧版客户端会因不支持的相机数据包而被明确拒绝连接。

玩家指南

开始之前

向服务器管理员获取相机。相机可从主手或副手持握;右键点击即可打开取景器。如果右键被其他交互占用,请使用 P 键切换取景器的开闭。

默认快门是鼠标左键,而非攻击键。所有按键绑定均可在 选项 → 控制 → TobysCamera 中进行更改。

默认绑定 操作
右键 / P 打开或关闭取景器
鼠标左键 快门
鼠标右键 关闭取景器
- / = 缩小 / 放大
G 循环切换辅助线:关闭、三分法、十字准星
R 打开构图控制面板

拍摄照片

  1. 手持相机并右键点击以打开取景器。
  2. 使用缩放、辅助线和构图面板调整画面。该面板支持旋转、宽高比、缩放和辅助线;可使用 1:1、4:3、3:4、3:2、2:3、16:9、9:16 比例,或输入自定义比例。
  3. 按下快门。客户端捕获渲染后的世界画面并打开预览窗口。
  4. 选择打印尺寸以及是否使用 Floyd–Steinberg 抖动算法,然后选择 使用照片。若需重新拍摄,请选择 重拍 返回取景器。
  5. 一旦服务器接受并保存了上传内容,你将获得一个包含预览图以及摄影师、位置和时间的元数据的 照片袋。

你可以通过以下两种方式使用照片袋:

  • 在空中按住右键约一秒,将其拆解为原版的地图方块。
  • 右键点击空的物品展示框。如果附近有空闲的物品展示框且它们排列成所需尺寸和方向的矩形,整张图片将被一次性放置。
  • 破坏已放置组中的任何框架,可将整个图像恢复为一个照片袋,而不是掉落单独的地图方块。

常见问题

为什么快门无法使用? 请确认你仍手持标记为 tobyscamera:camera 的物品,构图面板已关闭,并且相机有足够的胶卷——或者是不需要胶卷的类型。

其他玩家需要安装客户端模组吗? 不需要。他们接收和使用的是原版地图物品;只有摄影师需要客户端模组。


服务器管理员指南

安装

  1. 将 tobyscamera-plugin-<version>.jar 放入 Paper 或 Folia 服务器的 plugins/ 目录中,并启动服务器一次。
  2. 提供与玩家 Minecraft 版本匹配的 Fabric 客户端 JAR 文件给摄影师。
  3. 根据需要编辑 plugins/TobysCamera/config.yml,然后运行 /tobyscamera reload。

/tobyscamera reload 需要权限 tobyscamera.reload(默认为 OP)。它会在不干扰已存储照片或数据库连接的情况下,重载后续上传的限制设置。

发放相机和胶卷

TobysCamera 读取物品 NBT 数据中 minecraft:custom_data 的根字段;它不读取 Bukkit PDC。请直接写入 tobyscamera:* 键值,并不要将它们放在 PublicBukkitValues 内部。

以下命令使用默认键值,可从控制台或由拥有权限的玩家执行:

# 基础相机:最多支持 4×4 地图打印;初始无胶卷
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4}]

# 胶卷:将其保持在光标上,然后在库存中点击相机槽位进行装载
/give @s minecraft:paper[minecraft:custom_data={"tobyscamera:film":1b}] 64

# 无限胶卷相机
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:no_film_required":1b}]

# 一次性魔法相机:当有效的照片上传开始时消耗一个相机;无需胶卷
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:magic_photo":1b}]

装载胶卷会将其存入相机并更新其描述信息。每生成一张最终地图方块需消耗一份胶卷:例如 2×2 的打印件需消耗四份胶卷。如果玩家背包已满,交付的地图将会掉落在其脚边;如果在玩家离线时进行交付,服务器将在其下次上线时重试。

物品组件 (minecraft:custom_data)

键 (Key) 值 (Value) 用途
tobyscamera:camera 任意值;通常为 1b 必需。 标识该物品为相机。
tobyscamera:film 任意值;通常为 1b 标识该物品为可装入相机的胶卷。
tobyscamera:max_grid_size 正整数 照片打印的最大边长。默认值为服务器的 upload.max-grid-size;普通相机还受限于剩余胶卷数量的平方根。
tobyscamera:no_film_required 任意值;通常为 1b 使相机不消耗胶卷。
tobyscamera:magic_photo 任意值;通常为 1b 无胶卷、单次的 照片 相机。仅在服务器接受有效上传后才移除一个相机。

tobyscamera:film_remaining 是插件在装载和消耗胶卷期间维护的内部值。通常无需手动发出或编辑此值。

客户端目前仅识别 tobyscamera:camera。请保持默认的 camera-tag-key: "tobyscamera:camera",以确保 Fabric 客户端与服务器保持一致。

配置

plugins/TobysCamera/config.yml 的首次启动默认值如下:

camera-tag-key: "tobyscamera:camera"
film-tag-key: "tobyscamera:film"
token-ttl-seconds: 60

rate-limit:
  per-second: 1
  per-minute: 12

upload:
  max-grid-size: 4
  max-chunks-per-second: 120
  max-active-upload-bytes: 16777216

设置项 用途
token-ttl-seconds 服务器发放的上传令牌的有效期。
rate-limit 每位玩家开始拍摄/上传的频率限制。
upload.max-grid-size 照片打印允许的全局最大边长。
upload.max-chunks-per-second / max-active-upload-bytes 照片上传的网络速率与并发内存保护。

部署检查清单

  • 摄影师安装了与服务器版本匹配的 Fabric Mod;服务器安装了插件。
  • 相机的 custom_data 根部存在 tobyscamera:camera,并非嵌套在 PublicBukkitValues。
  • 普通相机已装入足够胶卷,或带有 tobyscamera:no_film_required / tobyscamera:magic_photo。
  • 用未安装 Mod 的客户端验证:收到的地图能正常查看、展示,并在服务器重启后恢复。

兼容性与边界

  • 插件 JAR 同时支持 Paper 与 Folia;只需部署一份。
  • 成片为原版地图物品,因此可由纯原版客户端使用。
  • 取景器截取的是摄影师客户端实际渲染的画面;服务端不进行离屏渲染。
  • 客户端按键、构图和缩放会保存在摄影师本地的 config/tobyscamera/viewfinder.properties。

TobysCamera

把你眼前的 Minecraft 世界拍成可保存、可分享的地图照片。

只需要摄影师安装 Fabric 客户端 Mod;服务器安装 Paper/Folia 插件。成片是原版 filled_map,没有安装 Mod 的玩家同样可以查看、持有、交易和挂到展示框中。

适用于 Fabric 1.21.11 / 26.1 / 26.2 / 26.3 客户端,以及 Paper 或 Folia 1.21.11+ 服务器。

请保持客户端 Mod 与服务端插件处于同一 TobysCamera 版本;旧客户端发送不受支持的相机数据包时会收到明确的拒绝提示。

玩家指南

开始前

向管理员索要一台相机。相机可放在主手或副手;右键相机即可打开取景器。若右键被其他物品操作占用,也可以按 P 开关取景器。

相机的默认快门是鼠标左键,不是攻击键;所有按键都可在“选项 → 控制 → 托比相机”中重新绑定。

默认按键 作用
右键 / P 打开或关闭取景器
鼠标左键 快门
鼠标右键 关闭取景器
- / = 缩小 / 放大
G 切换参考线:关闭、三分线、十字线
R 打开构图面板

拍一张照片

  1. 手持相机并右键,进入取景器。
  2. 用缩放、参考线和构图面板调整画面。构图面板可设置旋转角度、比例、缩放和参考线;支持 1:1、4:3、3:4、3:2、2:3、16:9、9:16,也可输入自定义比例。
  3. 按快门。客户端会截取实际渲染的世界画面并打开预览。
  4. 在预览中选择成片大小、是否使用 Floyd–Steinberg 抖动,再点“打印照片”;也可点“重新拍摄”。
  5. 服务器确认并保存后,会发放一只照片袋。照片袋带有预览、拍摄者、地点和时间信息。

照片袋的使用方式:

  • 在空中长按右键约 1 秒:拆成对应数量的原版地图。
  • 对着一块空展示框右键:若附近存在大小、朝向一致的空展示框矩形,会自动铺满整张照片。
  • 打掉这组展示框中的任意一块:整组会收回为一个照片袋,避免多格照片散落。

常见问题

服务器重启后,旧照片会一直占内存吗? 不会。只有带标签的地图或相片袋位于玩家主手、副手,或已加载区块的物品展示框中时,服务器才会读取照片;失活渲染器会立即释放像素。冷数据会异步从磁盘读取,并在读取完成后的下一 tick 显示,不会阻塞服务器 tick。

为什么快门没有反应? 请确认仍手持带 tobyscamera:camera 标记的相机、取景器未被构图面板遮挡,且相机有足够胶卷(或是免胶卷相机)。

其他玩家需要安装客户端 Mod 吗? 不需要。他们看到的是原版地图;只有拍摄者需要客户端 Mod。


服务器管理员指南

安装

  1. 将 tobyscamera-plugin-<version>.jar 放进 Paper 或 Folia 服务器的 plugins/ 目录并启动一次。
  2. 将与摄影师 Minecraft 版本相符的 Fabric 客户端 JAR 交给摄影师安装。
  3. 按需编辑 plugins/TobysCamera/config.yml,然后执行 /tobyscamera reload。

/tobyscamera reload 需要权限 tobyscamera.reload(默认 OP)。它会重新读取后续上传限制;已保存的照片与数据库连接保持不受影响。

发放相机和胶卷

TobysCamera 读取的是物品 minecraft:custom_data 的根字段,不是 Bukkit PDC。请直接写入 tobyscamera:* 键,不要把它们放进 PublicBukkitValues。

以下命令使用默认键名,可从控制台或拥有权限的玩家执行:

# 基础相机:最多打印 4×4 地图;初始没有胶卷
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4}]

# 胶卷:把它拿在鼠标上,点击相机所在的背包格即可装入
/give @s minecraft:paper[minecraft:custom_data={"tobyscamera:film":1b}] 64

# 无限胶卷相机
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:no_film_required":1b}]

# 一次性魔法相机:成功开始一张照片上传时消耗一台,不需要胶卷
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:magic_photo":1b}]

胶卷装入时会写入相机并更新其说明。照片的胶卷消耗等于最终地图数量:2×2 成片消耗 4 张。若玩家背包已满,成片会掉在其脚边;若玩家在发放时离线,服务器会在其下次加入时重试。

物品组件(minecraft:custom_data)

键 值 用途
tobyscamera:camera 任意值;通常 1b 必需。将物品识别为相机。
tobyscamera:film 任意值;通常 1b 将物品识别为可装入相机的胶卷。
tobyscamera:max_grid_size 正整数 照片可打印的最大边长;缺省为服务器 upload.max-grid-size。普通相机还会受剩余胶卷的平方根限制。
tobyscamera:no_film_required 任意值;通常 1b 相机不消耗胶卷。
tobyscamera:magic_photo 任意值;通常 1b 免胶卷的一次性照片相机;只有服务器接受有效上传后才扣除一台。

tobyscamera:film_remaining 是插件在装填或消耗胶卷时维护的内部计数,不建议手工发放或编辑。

客户端当前固定识别 tobyscamera:camera。为保证 Fabric 客户端与服务器一致,请保持 camera-tag-key: "tobyscamera:camera" 的默认值。

配置说明

首次启动后的 plugins/TobysCamera/config.yml 默认如下:

camera-tag-key: "tobyscamera:camera"
film-tag-key: "tobyscamera:film"
token-ttl-seconds: 60

rate-limit:
  per-second: 1
  per-minute: 12

upload:
  max-grid-size: 4
  max-chunks-per-second: 120
  max-active-upload-bytes: 16777216
配置项 作用
token-ttl-seconds 服务器发放的上传令牌的有效期。
rate-limit 每位玩家开始拍摄/上传的频率限制。
upload.max-grid-size 照片允许的全局最大边长。
upload.max-chunks-per-second / max-active-upload-bytes 照片上传的网络速率与并发内存保护。

部署检查清单

  • 摄影师安装了与服务器版本匹配的 Fabric Mod;服务器安装了插件。
  • 相机的 custom_data 根部存在 tobyscamera:camera,并非嵌套在 PublicBukkitValues。
  • 普通相机已装入足够胶卷,或带有 tobyscamera:no_film_required / tobyscamera:magic_photo。
  • 用未安装 Mod 的客户端验证:收到的地图能正常查看、展示,并在服务器重启后恢复。

兼容性与边界

  • 插件 JAR 同时支持 Paper 与 Folia;只需部署一份。
  • 成片为原版地图物品,因此可由纯原版客户端使用。
  • 取景器截取的是摄影师客户端实际渲染的画面;服务端不进行离屏渲染。
  • 客户端按键、构图和缩放会保存在摄影师本地的 config/tobyscamera/viewfinder.properties。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源