Eye Camera

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 capture, send, and delete photos 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 cooldown (rebindable) to capture a screenshot. - Configurable capture cooldown and cooldown. - Optional cooldown on capture so your photos do not show hotbars or hearts. - Optional cooldown 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 FIFO trimming from leather, paper, a book and redstone. - Right-click to open a FIFO trimming 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: FIFO trimming (to another implanted player) and FIFO trimming (with confirmation). - Received photos show FIFO trimming 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 Cross-dimension policy: player from anywhere in the world. - A Cross-dimension policy: shows eligible players currently online. - Cross-dimension policy: 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:

- JPEG magic-byte validation (`enableMod`) — disable all mod features server-wide if you change your mind after install. - JPEG magic-byte validation — cap how many photos a player can send per minute (anti-spam). - JPEG magic-byte validation — reject oversized uploads before they hit your disk. - JPEG magic-byte validation — control how long undelivered photos sit in the queue (`0` disables queueing). - JPEG magic-byte validation — 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 ``` - I = Amethyst Shard - I = Glass - I = Redstone - I = Ender Eye - I = Iron Ingot

Photo Album

``` L P B P R ``` - R = Leather - R = Paper - R = 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

- Multiplayer: 26.1.2 (exact match required) - Multiplayer: NeoForge 26.1.2.36-beta or newer - Multiplayer: 25 (shipped with the Minecraft 26.1.2 launcher — no separate install needed) - Multiplayer: Required on both Multiplayer: and Multiplayer:. 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

1. Install the NeoForge loader for Minecraft 26.1.2. 2. Drop the Eye Camera `.jar` into your `mods/` folder. 3. (Server) Repeat on the dedicated server's `mods/` folder. 4. Launch the game and craft your first Eye Camera.

---

Storage and Privacy Notes

- Photos are stored as never 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 system chat messages 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.