眼部摄像机

眼部摄像机

用自己的眼睛捕捉世界——真正地。

Eye Camera

用自己的眼睛捕捉世界——名副其实。

Eye Camera 是一个面向 Minecraft 26.1.2 的 NeoForge 模组,它把你的角色变成一台行走的相机。制作一台 Eye Camera,通过手术植入它(没错,真的),然后只需按一个键就能开始记录你的冒险。在精致的相册中浏览你的照片,并与其他已植入的玩家分享最爱——即使他们离线也没问题。

从零开始为 Minecraft 26.1.2 和全新的渲染管线打造,具备完整的多人游戏支持、可配置的服务器端限制,以及按世界隔离照片的功能,让你的单人游戏截图永远不会混入生存服务器的相册。


特性

植入体

  • 用紫水晶碎片、玻璃、红石、末影之眼和铁锭制作一台 Eye Camera。
  • 右键并按住以植入。动画复用望远镜的姿势,耗时 5 秒。
  • 植入是永久的——直到你死亡。死亡会移除植入体;你保留物品栏中的物品,但会失去相机能力,直到你制作并植入新的为止。(有意的设计选择——为冒险远征增加分量。)
  • 已植入的玩家获得拍摄、发送和删除照片的能力。没有植入体时,相册为只读。

拍摄照片

  • 按 K(可重新绑定)拍摄截图。
  • 可配置的拍摄分辨率和 JPEG 质量。
  • 可选的拍摄时隐藏 HUD,这样你的照片不会显示快捷栏或生命值。
  • 可选的拍摄音效和可配置的冷却时间,以防止刷屏。
  • 拍摄在工作线程上运行,因此你的帧率不会在拍摄过程中卡顿。

相册

  • 用皮革、纸、书和红石制作一本 Photo Album。
  • 右键打开当前世界或服务器中所有照片的 4 列缩略图网格。
  • 点击任意照片以全尺寸查看,缩放以适应屏幕。
  • 每张照片的操作:发送(给另一位已植入的玩家)和删除(带确认)。
  • 收到的照片显示 "from ",让你记住谁发送了什么。
  • 相册有可配置的最大容量,并采用 FIFO 修剪——当你超出限制时,最旧的照片会被自动清除。

分享照片

  • 从世界任何地方向另一位在线的、已植入的玩家发送任意照片。
  • 可搜索的收件人列表显示当前在线的符合条件的玩家。
  • 离线队列: 如果你的收件人离线,照片会在服务器端保留,并在他们下次登录时送达。可配置的保留期限(设为 0 可完全禁用队列)。
  • 跨维度策略: 服务器管理员可以允许或阻止跨维度发送照片(主世界 ↔ 下界 ↔ 末地)。
  • 收件人会收到一条系统消息,通知他们有新照片到达。

按世界 / 按服务器隔离

  • 照片存储在 <gamedir>/eyecamera/<scope>/,其中 scope 是世界名称(单人游戏)或服务器地址(多人游戏)的哈希值。
  • 这意味着:
    • 你的单人游戏截图留在单人游戏中。
    • 每个服务器都有自己的相册——你访问的服务器之间不会泄露。
    • 切换世界或加入不同服务器会干净地切换相册视图。
  • 损坏的索引文件会自动备份到 index.json.bak 并重建——你的照片永远不会被静默丢失。

服务器管理员控制

该模组从一开始就为共享服务器而构建:

  • 总开关(enableMod)——如果你在安装后改变主意,可在服务器范围内禁用所有模组功能。
  • 发送速率限制——限制玩家每分钟可以发送多少张照片(反刷屏)。
  • 最大图像字节数——在超大上传写入磁盘之前将其拒绝。
  • 离线保留天数——控制未送达照片在队列中停留的时间(0 禁用队列)。
  • 跨维度允许/拒绝——如果你愿意,可将分享限制在同一维度内。
  • JPEG 魔数字节验证——只有有效的 JPEG 才能进入收件人的存储;任意字节都会被拒绝。

合成配方

Eye Camera

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

Photo Album

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

配置

Eye Camera 附带两个配置文件,可通过 Mods → Eye Camera → Config 或直接在 config/ 中编辑:

客户端(eyecamera-client.toml)——你的个人拍摄偏好:

  • 拍摄分辨率
  • JPEG 质量
  • 拍摄时隐藏 HUD(开/关)
  • 相册最大容量
  • 拍摄冷却(毫秒)
  • 显示拍摄闪光(开/关)
  • 播放拍摄音效(开/关)

通用(eyecamera-common.toml)——服务器端策略(在单人游戏中,这位于你的存档中):

  • 启用模组(总开关)
  • 每分钟发送速率限制
  • 最大图像字节数
  • 离线保留天数
  • 允许跨维度发送

兼容性

  • Minecraft: 26.1.2(要求精确匹配)
  • 加载器: NeoForge 26.1.2.36-beta 或更新版本
  • Java: 25(随 Minecraft 26.1.2 启动器附带——无需单独安装)
  • 端: 客户端和服务器均需安装。专用服务器必须安装该模组,任何功能才能工作;不支持单端安装。
  • 多人游戏: 完全支持。未安装该模组的原版服务器不受影响(模组根本不会加载)。

安装

  1. 为 Minecraft 26.1.2 安装 NeoForge 加载器。
  2. 将 Eye Camera .jar 放入你的 mods/ 文件夹。
  3. (服务器)在专用服务器的 mods/ 文件夹中重复上述操作。
  4. 启动游戏并制作你的第一台 Eye Camera。

存储与隐私说明

  • 照片以 JPEG 文件形式存储在 <gamedir>/eyecamera/<scope_hash>/ 下。
  • scope 哈希源自世界名称或服务器地址;该模组从不向第三方服务上传任何内容。
  • 发送的照片仅通过你连接的 Minecraft 服务器传输。
  • 离线队列位于服务器文件系统的 <world>/eyecamera/offline_queue/<recipient_uuid>/,并在配置的保留期限后自动清除。
  • 所有照片数据都保留在你和你的玩家同伴的机器上。没有遥测、没有分析、没有外部网络调用。

已知限制

  • 拍摄闪光叠加层目前处于禁用状态,等待 26.1.2 渲染重写稳定下来。拍摄音效和隐藏 HUD 按预期工作。
  • 出于同样的原因,收到的照片通知以系统聊天消息而非弹出提示的形式发送。
  • 这些在源码中作为 ASSUMPTION: 注释进行跟踪,并将在未来版本中重新启用。

许可证

保留所有权利。如果你想再分发或 fork,请联系。


致谢

  • 由 Klausiiiii 制作(de.klausiiiii.eyecamera)。
  • 使用 NeoForge、Mojang 官方映射以及对 26.1.2 API 重写的充分尊重构建。