眼球摄像头

眼球摄像头

用你自己的眼睛去捕捉这个世界——真的。

眼睛相机

真正地用你自己的眼睛捕获世界。

眼睛相机是一款专为 Minecraft 26.1.2 设计的 NeoForge Mod，它能将你的角色变成一台行走的相机。制作一个眼睛相机，通过手术植入（没错，是真的），然后只需按下一个按键，就能开始记录你的冒险。在时尚的相册中浏览你的照片，并与其它已植入的玩家分享喜爱的照片——即使他们处于离线状态。

该 Mod 完全基于 Minecraft 26.1.2 及新的渲染管线构建，支持完整的多人游戏、可配置的服务端限制，以及每个世界的照片隔离，确保你的单人模式截图永远不会与生存服务器的相册混在一起。

功能

植入物

  • 使用紫水晶碎片、玻璃、红石、一个末影之眼和一个铁锭制作一个 眼睛相机。
  • 右键并按住以进行植入。动画复用望远镜姿势，整个过程需要 5 秒。
  • 植入是永久性的——直到你死亡。死亡会移除植入物；你的物品栏内容会保留，但相机的功能会失去，直到你制作并植入一个新的。（这是有意为之的设计——为危险探险增加分量。）
  • 植入的玩家将获得 拍摄、发送和删除照片 的能力。没有植入物的情况下，相册只读。

拍摄照片

  • 按下 K 键（可重新绑定）以捕获截图。
  • 可配置捕获的 分辨率 和 JPEG 质量。
  • 可选的 HUD 隐藏 功能，确保你的照片不会显示快捷栏或生命值。
  • 可选的 捕获音效 和可配置的 冷却时间，以防止刷屏。
  • 捕获操作在工作线程中运行，因此你的帧率不会在拍摄瞬间卡顿。

相册

  • 使用皮革、纸、一本书和红石制作一本 相册。
  • 右键点击以打开一个 4 列缩略图网格，显示当前世界或服务器的所有照片。
  • 点击任意照片以全尺寸查看，并按屏幕大小缩放。
  • 每张照片的操作：发送（给另一个已植入的玩家）和 删除（需确认）。
  • 收到的照片会显示 “来自 <玩家>”，以便你记住是谁发送的。
  • 相册有可配置的最大容量，并采用 先进先出修剪 策略——当超过上限时，最旧的照片会被自动清除。

分享照片

  • 可以从世界中的任何位置，将任意照片发送给另一个 在线、已植入 的玩家。
  • 一个 可搜索的接收者列表 会显示当前在线的有效玩家。
  • 离线队列： 如果你的接收者处于离线状态，照片会保存在服务端，并在他们下次登录时送达。可配置的保留期限（设置为 0 可完全禁用队列）。
  • 跨维度策略： 服务器管理员可以允许或阻止照片跨维度（主世界 ↔ 下界 ↔ 末地）发送。
  • 接收者会收到一条系统消息，通知他们有新照片到达。

每个世界 / 每个服务器的隔离

  • 照片存储在 <游戏目录>/eyecamera/<作用域>/ 目录下，其中作用域是世界名称（单人模式）或服务器地址（多人模式）的哈希值。
  • 这意味着：
    • 你的单人模式截图会保留在单人模式中。
    • 每个服务器都有自己的相册——你访问的不同服务器之间不会泄露。
    • 切换世界或加入不同的服务器会干净地切换相册视图。
  • 损坏的索引文件会自动备份为 index.json.bak 并重建——你的照片绝不会被静默丢失。

服务器管理员控制

该 Mod 从一开始就为共享服务器设计：

  • 主开关 (enableMod) — 如果在安装后改变主意，可以在全局范围内禁用所有 Mod 功能。
  • 发送速率限制 — 限制每个玩家每分钟可以发送的照片数量（防刷屏）。
  • 最大图片字节数 — 在上传图片到达磁盘前拒绝过大的文件。
  • 离线保留天数 — 控制未送达照片在队列中保留的时间（0 禁用队列）。
  • 跨维度允许/拒绝 — 如果你愿意，可以限制分享仅限于同一维度内。
  • JPEG 魔数验证 — 只有有效的 JPEG 文件才能进入接收者的存储；任意字节会被拒绝。

合成配方

眼睛相机

A G A
R E R
   I
  • A = 紫水晶碎片
  • G = 玻璃
  • R = 红石
  • E = 末影之眼
  • I = 铁锭

相册

  L
P B P
  R
  • L = 皮革
  • P = 纸
  • B = 书
  • R = 红石

配置

眼睛相机带有两个配置文件，可通过 Mods → 眼睛相机 → 配置 或直接在 config/ 目录下编辑：

客户端 (eyecamera-client.toml) — 你的个人捕获偏好：

  • 捕获分辨率
  • JPEG 质量
  • 捕获时隐藏 HUD（开/关）
  • 最大相册容量
  • 捕获冷却时间（毫秒）
  • 显示捕获闪光（开/关）
  • 播放捕获音效（开/关）

通用 (eyecamera-common.toml) — 服务端策略（在单人模式中，此文件存在于你的存档内）：

  • 启用 Mod（主开关）
  • 每分钟发送速率限制
  • 最大图片字节数
  • 离线保留天数
  • 允许跨维度发送

兼容性

  • Minecraft： 26.1.2（需要完全匹配）
  • 加载器： NeoForge 26.1.2.36-beta 或更新版本
  • Java： 25（随 Minecraft 26.1.2 启动器附带——无需单独安装）
  • 侧： 客户端 和 服务器 均需要安装。专用服务器必须安装此 Mod 才能使用任何功能；不支持仅单侧安装。
  • 多人游戏： 完全支持。未安装此 Mod 的原版服务器不受影响（Mod 不会加载）。

安装

  1. 为 Minecraft 26.1.2 安装 NeoForge 加载器。
  2. 将眼睛相机的 .jar 文件放入你的 mods/ 文件夹。
  3. （服务器）在专用服务器的 mods/ 文件夹中重复此步骤。
  4. 启动游戏并制作你的第一个眼睛相机。

存储与隐私说明

  • 照片以 JPEG 文件 的形式存储在 <游戏目录>/eyecamera/<作用域哈希>/ 下。
  • 作用域哈希是从世界名称或服务器地址派生出来的；该 Mod 绝不 向任何第三方服务上传任何内容。
  • 发送的照片仅通过你连接的 Minecraft 服务器进行传输。
  • 离线队列位于服务器文件系统的 <世界目录>/eyecamera/offline_queue/<接收者 UUID>/ 目录下，并在配置的保留期后自动清理。
  • 所有照片数据仅保留在你和你的同伴玩家的机器上。没有遥测、没有分析、没有外部网络调用。

已知限制

  • 由于等待 26.1.2 渲染重写的稳定，捕获闪光叠加层 目前被禁用。捕获音效和 HUD 隐藏功能正常。
  • 出于相同原因，收到照片的通知以 系统聊天信息 的形式显示，而不是弹出提示。
  • 这些问题在源代码中标记为 ASSUMPTION: 注释，并将在未来的版本中重新启用。

许可

保留所有权利。如果你想重新分发或分支，请联系作者。

致谢

  • 由 Klausiiiii (de.klausiiiii.eyecamera) 制作。
  • 基于 NeoForge、Mojang 官方映射构建，并对 26.1.2 API 重写怀有敬意。