Photografy

# 📸 Photography 1.2.1 — Storytelling Tools Update

Photography 1.2.1 expands the mod beyond media playback with new tools designed specifically for adventure maps, RPGs, horror maps and story-driven experiences.

---

## 🎨 Custom Item Textures

Added per-ItemStack custom textures.

New commands:

`/photography texture item <source>`

`/photography texture remove`

`/photography texture info`

Features:

- Local PNG textures
- Online PNG textures through URLs
- Per-ItemStack textures
- Transparency support
- Subfolder support
- Online caching
- Safe fallback to the original Minecraft item texture
- Resolution validation
- Supported resolutions from 16×16 up to 256×256
- Maximum texture file size protection
- Custom textures can exist without Photography media
- Custom textures can coexist with Image, Audio and Video items
- Investigation Journal evidence preserves custom item textures

Added folder:

`mods/photography/item_textures/`

This allows map creators to create custom props such as VHS tapes, keycards, photographs, documents, keys and other story items without creating completely new Minecraft items.

---

## 📔 Investigation Journal

Added the new **Investigation Journal** item.

The Journal acts as a persistent evidence collection for Photography media items.

Features:

- Dedicated Journal inventory slot
- Automatic Photography evidence collection
- Original items are never removed
- Evidence is stored inside the Journal ItemStack
- Evidence persists when the Journal is dropped, stored or transferred
- Vanilla-inspired chest-style interface
- 27 evidence entries per page
- Maximum of 270 evidence entries
- Pagination controls
- Left click to open evidence
- Right click to delete evidence
- Delete confirmation screen
- Deleted evidence names remain blocked from that Journal
- Duplicate evidence prevention
- Custom Investigation Journal item texture
- Compatible with custom Photography item textures

---

## 🎞️ Photography Title Overlay

Added a new command-driven HUD title system.

Example:

`/photography title "CHAPTER I" fadein 1 fadeout 1 duration 5 size 2`

Supported content:

- Text
- Local images
- Online images

Title settings include:

- Fade-in
- Fade-out
- Duration
- Size
- Player selectors

Titles can also contain an independent subtitle:

`/photography title "CHAPTER I" fadein 1 fadeout 1 duration 5 size 2 subtitle "The Beginning" fadein 1 fadeout 1 duration 4 size 1`

Added:

`/photography title stop`

New titles automatically replace previous Photography title overlays.

The system renders as a HUD overlay, allowing players to continue normal gameplay while it is visible.

---

## ✨ Fade Improvements

Improved fade behavior across Photography.

Fixed:

- Title text briefly flashing before fade-in
- Title text briefly flashing after fade-out
- Image titles ignoring fade alpha
- Image fade-in / fade-out
- Video cutscene flashes around end-of-file transitions

Fade progression is now smoother and more reliable.

---

## 🔒 Adventure Mode Protection

Added protections for adventure-map environments.

Players in Adventure Mode can no longer:

- Remove books from Lecterns
- Edit Signs
- Edit Wall Signs
- Edit Hanging Signs
- Edit Wall Hanging Signs

Lectern books can still be opened, read and navigated normally.

Survival and Creative behavior remain unchanged.

---

## 📷 Optional Camerapture Integration

Added optional compatibility with Camerapture.

When Camerapture is installed, players in Adventure Mode cannot modify protected Camerapture picture frames.

Protection includes actions such as:

- Editing
- Rotating
- Configuring
- Breaking picture frames

Camerapture is **not required** to use Photography.

Photography continues to load normally when Camerapture is not installed.

---

## 📔 Journal Interface Improvements

Several visual and usability fixes were made during development:

- Fixed Journal screen being blurred by Minecraft's background rendering
- Redesigned the Journal around a vanilla-style container interface
- Improved panel sizing
- Improved text contrast
- Removed inappropriate text shadows from light panels
- Fixed text escaping outside the Journal interface
- Fixed confirmation buttons leaving the panel
- Fixed separator lines crossing buttons
- Improved instruction spacing
- Added safe truncation for long evidence names
- Improved Delete Evidence confirmation layout

---

## 🧩 Compatibility

Photography 1.2.1 preserves all Photography 1.2.0 features, including:

- Images and animated GIFs
- Audio playback
- Local video playback
- HTTP/HTTPS media
- Twitch
- Optional YouTube support
- Online metadata
- Minecraft-inspired media interfaces
- Fullscreen cutscenes
- Fade-in / fade-out
- Volume
- Playback speed
- Advanced subtitles
- Speaker profiles
- Typewriter effects
- `onskip`
- `then`
- Multiplayer cutscene tracking
- Cutscene freeze gamerule
- Cutscene invulnerability gamerule
- `/photography reload`
- Command blocks
- `/execute`
- Datapack functions
- Console execution

---

## 📦 Dependencies

### Required
- Fabric API
- WATERMeDIA 2.1.37

### Optional
- WATERMeDIA YouTube Extension 2.1.2 — required only for YouTube playback
- Camerapture — enables Adventure Mode picture-frame protection

---

## ❤️

Photography 1.2.1 focuses on giving map creators more control over storytelling and custom world interactions.

Create custom props.

Collect evidence.

Display chapter titles.

Protect your adventure map.

And turn ordinary Minecraft items into whatever your story needs them to be.