眼相机
以你自己的视角——字面意义上的——捕捉世界。
Eye Camera 是一款面向 Minecraft 26.1.2 的 NeoForge 模组,它将你的角色变成一台行走的相机。制作一个 Eye Camera,进行手术植入(是的,真的),然后通过单次按键记录你的冒险之旅。在时尚的相册中浏览照片,并与其它已植入玩家分享你最喜欢的照片——即使他们处于离线状态。
该模组为 Minecraft 26.1.2 及新的渲染管线从零构建,支持完整的多玩家功能、可配置的服务端限制以及按世界隔离的照片存储,确保你的单人游戏截图不会泄露到生存服务器的相册中。
功能特性
植入物
- 使用紫水晶碎片、玻璃、红石、末影之眼和铁锭制作 Eye Camera。
- 右键并长按以进行植入。动画复用望远镜的姿势,耗时 5 秒。
- 植入是永久性的——直到你死亡。死亡会移除植入物;你会保留物品栏中的内容,但会失去相机能力,直到你重新制作并植入一个新的。(这是有意为之的设计选择——增加了冒险探索的风险感。)
- 已植入的玩家获得拍摄、发送和删除照片的能力。如果没有植入物,相册仅处于只读状态。
拍照功能
- 按 K(可重新绑定)截取截图。
- 支持自定义捕获分辨率和 JPEG 质量。
- 可选择在捕获时隐藏 HUD,确保照片不会显示快捷栏或生命值。
- 可选择启用捕获音效,并设置可配置的冷却时间以防止频繁触发。
- 截图操作在后台工作线程执行,避免拍摄过程中帧率卡顿。
相册
-
使用皮革、纸张、书和红石制作相册。
-
右键点击以打开当前世界或服务器中所有照片的4列缩略图网格。
-
点击任意照片可全屏查看,自动缩放以适应屏幕。
-
单张照片支持的操作:发送(发送给其他已植入的玩家)和删除(需确认)。
-
接收到的照片会显示 “来自 <玩家>”,方便你记住是谁发送的。
-
该相册支持配置最大容量,并采用先进先出(FIFO)裁剪机制——当超出限制时,最旧的照片会被自动清除。
分享照片
- 可以从世界任何地方向任意其他在线且已植入的玩家发送照片。
- 可搜索的收件人列表会显示当前在线的符合条件的玩家。
- **离线队列:**如果收件人处于离线状态,照片将在服务器端暂存,并在其下次登录时送达。保留时长可配置(设置为
0 以完全禁用队列功能)。
- **跨维度策略:**服务器管理员可以允许或禁止在不同维度之间(主世界 ↔ 下界 ↔ 末地)发送照片。
- 收件人会收到一条系统消息,通知他们有新照片到达。
按世界/服务器隔离
- 照片存储在
<gamedir>/eyecamera/<scope>/ 中,其中 scope 是世界名称(单人模式)或服务器地址(多人模式)的哈希值。
- 这意味着:
- 你的单人截图仅保存在单人模式中。
- 每个服务器拥有独立的相册——你访问的不同服务器之间不会发生数据泄露。
- 切换世界或加入不同的服务器时,相册视图会随之干净地切换。
- 如果索引文件损坏,系统会自动将其备份到
index.json.bak 并重新构建——你的照片永远不会无声无息地丢失。
服务器管理员控制
该模组从一开始就是为共享服务器设计的:
- 总开关 (
enableMod) — 如果你在安装后改变主意,可以禁用整个服务器的所有模组功能。
- 发送速率限制 — 限制玩家每分钟可发送的照片数量(防止垃圾信息)。
- 最大图像字节数 — 在上传文件触及你的磁盘之前拒绝过大的图片。
- 离线保留天数 — 控制未送达的照片在队列中保留多久(设为
0 则禁用队列功能)。
- 跨维度允许/禁止 — 如果你希望,可以限制分享仅在同一个维度内进行。
- JPEG 魔数验证 — 只有有效的 JPEG 文件才会到达接收者的存储;任意字节将被拒绝。
合成配方
Eye Camera
A G A
R E R
I
- A = 紫水晶碎片 (Amethyst Shard)
- G = 玻璃 (Glass)
- R = 红石粉 (Redstone)
- E = 末影之眼 (Ender Eye)
- I = 铁锭 (Iron Ingot)
Photo Album
L
P B P
R
- L = 皮革 (Leather)
- P = 纸 (Paper)
- B = 书 (Book)
- R = 红石粉 (Redstone)
配置
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 启动器提供——无需单独安装)
- 运行环境: 客户端和服务器均需安装。专用服务器必须安装此模组才能生效;不支持单侧安装。
- 多人游戏: 完全支持。未安装此模组的原版服务器不受影响(模组将直接不加载)。
安装
- 为 Minecraft 26.1.2 安装 NeoForge 加载器。
- 将 Eye Camera
.jar 放入你的 mods/ 文件夹中。
- (服务器)在专用服务器的
mods/ 文件夹中重复此操作。
- 启动游戏并制作你的第一台 Eye Camera。
存储与隐私说明
- 照片以 JPEG 文件 形式存储在
<gamedir>/eyecamera/<scope_hash>/ 目录下。
- scope hash 由世界名称或服务器地址生成;该模组 绝不会 向任何第三方服务上传数据。
- 发送的照片仅通过你当前连接的 Minecraft 服务器进行传输。
- 离线队列位于服务器文件系统上的
<world>/eyecamera/offline_queue/<recipient_uuid>/,并在配置的保留期结束后自动清除。
- 所有照片数据均保留在你和你其他玩家所在的机器上。不存在遥测、数据分析或任何外部网络调用。
已知限制
- 由于等待 26.1.2 渲染重写完成,目前 禁用 了捕获时的闪光覆盖效果。捕获音效和 HUD 隐藏功能按预期正常工作。
- 接收到的照片通知以 系统聊天消息 形式发送,而非弹出式提示,原因同上。
- 这些问题在源代码中以
ASSUMPTION: 注释标记,将在未来版本中重新启用。
许可证
保留所有权利。如需重新分发或创建分支,请联系作者。
致谢
- 由 Klausiiiii (
de.klausiiiii.eyecamera) 制作。
- 基于 NeoForge、Mojang 官方映射表构建,并对 26.1.2 API 重写保持充分尊重。
Eye Camera
Capture the world through your own eyes — literally.
Eye Camera is a NeoForge mod for Minecraft 26.1.2 that turns your character into a walking camera. Craft an Eye Camera, surgically implant it (yes, really), and start documenting your adventures with a single keystroke. Browse your photos in a stylish Photo Album, and share favourites with other implanted players — even when they are offline.
Built from the ground up for Minecraft 26.1.2 and the new rendering pipeline, with full multiplayer support, configurable server-side limits, and per-world photo isolation so your singleplayer screenshots never bleed into your survival server's gallery.
Features
The Implant
- Craft an Eye Camera from amethyst shards, glass, redstone, an ender eye and an iron ingot.
- Right-click and hold to implant. The animation reuses the spyglass pose and takes 5 seconds.
- The implant is permanent — until you die. Death removes the implant; you keep what is in your inventory but lose the camera ability until you craft and implant a new one. (Intentional design choice — adds weight to risky expeditions.)
- An implanted player gains the ability to capture, send, and delete photos. Without an implant, the Photo Album is read-only.
Taking Photos
- Press K (rebindable) to capture a screenshot.
- Configurable capture resolution and JPEG quality.
- Optional HUD hide on capture so your photos do not show hotbars or hearts.
- Optional capture sound and a configurable cooldown to prevent spam.
- Captures run on a worker thread so your framerate does not stutter mid-shot.
The Photo Album
- Craft a Photo Album from leather, paper, a book and redstone.
- Right-click to open a 4-column thumbnail grid of every photo from the current world or server.
- Click any photo to view it full-size, scaled to fit the screen.
- Per-photo actions: Send (to another implanted player) and Delete (with confirmation).
- Received photos show "from <player>" so you remember who sent what.
- The album has a configurable maximum size with FIFO trimming — when you exceed the limit, the oldest photo gets cleared automatically.
Sharing Photos
- Send any photo to another online, implanted player from anywhere in the world.
- A searchable recipient list shows eligible players currently online.
- Offline queue: if your recipient is offline, the photo is held server-side and delivered when they next log in. Configurable retention period (set to
0 to disable queueing entirely).
- Cross-dimension policy: server admins can allow or block sending photos across dimensions (Overworld ↔ Nether ↔ End).
- Recipients get a system message notifying them that a new photo arrived.
Per-World / Per-Server Isolation
- Photos are stored in
<gamedir>/eyecamera/<scope>/, where the scope is a hash of the world name (singleplayer) or server address (multiplayer).
- This means:
- Your singleplayer screenshots stay in singleplayer.
- Each server has its own gallery — no leakage between servers you visit.
- Switching worlds or joining a different server cleanly switches the album view.
- A corrupted index file is automatically backed up to
index.json.bak and rebuilt — your photos are never silently lost.
Server Admin Controls
The mod is built for shared servers from the start:
- Master switch (
enableMod) — disable all mod features server-wide if you change your mind after install.
- Send rate limit — cap how many photos a player can send per minute (anti-spam).
- Max image bytes — reject oversized uploads before they hit your disk.
- Offline retention days — control how long undelivered photos sit in the queue (
0 disables queueing).
- Cross-dimension allow/deny — restrict sharing to within the same dimension if you want.
- JPEG magic-byte validation — only valid JPEGs make it to the recipient's storage; arbitrary bytes are rejected.
Crafting Recipes
Eye Camera
A G A
R E R
I
- A = Amethyst Shard
- G = Glass
- R = Redstone
- E = Ender Eye
- I = Iron Ingot
Photo Album
L
P B P
R
- L = Leather
- P = Paper
- B = Book
- R = Redstone
Configuration
Eye Camera ships with two config files, edited via Mods → Eye Camera → Config or directly in config/:
Client (eyecamera-client.toml) — your personal capture preferences:
- Capture resolution
- JPEG quality
- Hide HUD on capture (on/off)
- Maximum album size
- Capture cooldown (ms)
- Show capture flash (on/off)
- Play capture sound (on/off)
Common (eyecamera-common.toml) — server-side policy (in singleplayer this lives in your save):
- Enable mod (master switch)
- Send rate limit per minute
- Max image bytes
- Offline retention days
- Allow cross-dimension sending
Compatibility
- Minecraft: 26.1.2 (exact match required)
- Loader: NeoForge 26.1.2.36-beta or newer
- Java: 25 (shipped with the Minecraft 26.1.2 launcher — no separate install needed)
- Sides: Required on both client and server. Dedicated servers must have the mod installed for any features to work; single-side installs are not supported.
- Multiplayer: Fully supported. Vanilla servers without the mod are not affected (the mod simply does not load).
Installation
- Install the NeoForge loader for Minecraft 26.1.2.
- Drop the Eye Camera
.jar into your mods/ folder.
- (Server) Repeat on the dedicated server's
mods/ folder.
- Launch the game and craft your first Eye Camera.
Storage and Privacy Notes
- Photos are stored as JPEG files under
<gamedir>/eyecamera/<scope_hash>/.
- The scope hash is derived from the world name or server address; the mod never uploads anything to a third-party service.
- Sent photos transit only through the Minecraft server you are connected to.
- The offline queue lives at
<world>/eyecamera/offline_queue/<recipient_uuid>/ on the server's filesystem and is auto-purged after the configured retention period.
- All photo data stays on the machines of you and your fellow players. There is no telemetry, no analytics, no external network calls.
Known Limitations
- The capture flash overlay is currently disabled while waiting for the 26.1.2 rendering rewrite to settle. Capture sound and HUD hide work as expected.
- Received-photo notifications are delivered as system chat messages rather than toast popups for the same reason.
- These are tracked in source as
ASSUMPTION: comments and will be re-enabled in a future release.
License
All Rights Reserved. Reach out if you want to redistribute or fork.
Credits
- Made by Klausiiiii (
de.klausiiiii.eyecamera).
- Built with NeoForge, the Mojang official mappings, and a healthy respect for the 26.1.2 API rewrite.
评论 0
登录后参与评分
还没有评论,来抢沙发吧