Photografy

# 📸 摄影

### 将 Minecraft 物品变成照片、录音、视频、证据、道具、过场动画，以及更多内容。

**摄影**是一款适用于 Minecraft 1.21.1 的 Fabric 模组，专为冒险地图、恐怖地图、RPG、悬疑作品、ARG、角色扮演服务器和剧情体验而打造。

这个想法最初很简单：

> 如果一个普通的 Minecraft 物品可以打开一张真实图片，会怎么样？

如今，摄影能做的远不止这些。

一张纸可以变成照片。  
一本书可以收录视频。  
重命名后的物品可以变成 VHS 录像带。  
一把钥匙可以拥有自定义纹理。  
玩家可以在调查日志中收集证据。  
命令方块可以触发全屏电影式过场动画。  
Twitch 直播流也可以在 Minecraft 中播放。

而且，几乎所有功能都围绕**原版 Minecraft 物品堆叠**设计，因此地图作者可以自由决定这些物品代表什么。

—

# 🖼️ 图片与 GIF

将图片直接附加到现有的 Minecraft 物品上。

支持格式：

– PNG
– JPG
– JPEG
– 动态 GIF
– 本地文件
– 在线 URL
– 子文件夹

图片查看器包含：

– 鼠标滚轮缩放
– 拖动与平移
– 动态 GIF 播放
– Minecraft 风格界面

适用于：

– 照片
– 文档
– 证据
– 地图
– 绘画
– 海报
– 便条
– 谜题线索

本地文件存放在：

`mods/photography/image/`

—

# 🎵 音频

将 Minecraft 物品变成可播放的录音。

支持格式：

– MP3
– OGG

音频播放器包含：

– 播放 / 暂停
– 拖动进度
– 进度显示
– 时长
– 音量控制
– Minecraft 风格界面

可用于：

– 音频日志
– 语音录音
– 无线电消息
– 角色对白
– 音乐
– 恐怖录音带
– 环境叙事

本地音频存放在：

`mods/photography/audio/`

—

# 🎬 视频

摄影可以直接在 Minecraft 内播放真实视频。

支持的视频来源包括：

– 本地 MP4 文件
– 可直接访问的在线视频源
– Twitch
– 通过可选的 WATERMeDIA YouTube Extension 播放 YouTube

视频播放器包含：

– 播放 / 暂停
– 前后跳转 ±10 秒
– 可点击的进度条
– 音量控制
– 时长显示
– LIVE 检测
– 在线元数据
– 安全加载与故障处理

本地视频存放在：

`mods/photography/video/`

视频播放由 **WATERMeDIA** 驱动。

—

# 🔴 YouTube 与 Twitch

摄影通过 WATERMeDIA 支持在线媒体。

## YouTube

播放 YouTube 需要可选组件：

**WATERMeDIA YouTube Extension**

摄影可以显示可用的元数据，例如：

– 视频标题
– 频道 / 创作者
– 来源

如果缺少该扩展，摄影会显示明确的错误提示，而不会崩溃或一直加载。

## Twitch

摄影通过 WATERMeDIA 直接支持 Twitch 直播流。

摄影会自动检测 LIVE 内容并调整播放器行为：

– `● LIVE` 指示标记
– 不显示虚假的时长
– 视情况禁用拖动进度
– 可用时显示频道 / 来源信息

—

# 🎞️ 全屏过场动画

摄影内置了专为地图作者设计的命令驱动电影式动画系统。

示例：

`/video play “intro.mp4” @a skip false`

过场动画支持：

– 玩家选择器
– 多人游戏
– 命令方块
– `/execute`
– 数据包函数
– 控制台执行
– 可跳过／不可跳过的视频
– 自定义初始音量
– 播放速度
– 淡入
– 淡出
– 高级字幕
– 播放完成后执行的命令
– 跳过时执行的命令

示例：

`/video play “intro.mp4” @a skip true volume 40 speed 1.5 fadein 1 fadeout 1 onskip “function story:skip” then function story:continue`

—

# 💬 高级字幕

Photography 使用专为电影式对话设计的 JSON 字幕轨道。

功能包括：

– 开始／结束时间
– 多行文本
– 自定义颜色
– 文字大小
– 顶部／居中／底部位置
– 阴影
– 粗体
– 斜体
– 背景框
– 说话者名称
– 说话者颜色
– 可重复使用的说话者配置
– 打字机效果
– 自定义打字机速度

不同玩家甚至可以使用不同的字幕文件，因此无需复制视频也能制作多语言地图。

字幕文件存放于：

`mods/photography/subtitles/`

—

# 🎞️ 标题与 HUD 覆盖层

Photography 1.2.1 引入了全新的标题覆盖层系统。

可显示：

– 文本
– 本地图片
– 在线图片
– 标题
– 字幕

并可分别设置：

– 淡入
– 淡出
– 持续时间
– 大小

示例：

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

也可以使用图片代替文本。

非常适合用于：

– 章节开场
– 地点提示卡
– 目标通知
– 标志
– 故事转场
– 证据通知

与 GUI 界面不同，覆盖层不会暂停正常游戏。

—

# 📔 调查日志

Photography 1.2.1 新增了**调查日志**，专为悬疑、恐怖和剧情地图设计。

日志可作为持久保存的证据收藏册。

将其装备在专用物品栏槽位后，玩家发现的 Photography 媒体物品会自动记录下来。

功能包括：

– 专用日志物品栏槽位
– 自动收集证据
– 证据直接储存在日志中
– 丢弃、存放或转移日志时，证据仍会保留
– 每页可记录 27 条证据
– 最多可记录 270 条
– 分页
– 可直接从日志打开已保存的媒体
– 确认后删除证据
– 已删除证据的名称仍会被该日志屏蔽
– 自定义日志材质
– 原版风格的容器界面

原始物品不会被移除。

日志会另行保存一份证据快照。

这样，玩家就能在冒险过程中收集并保存照片、视频、录音和剧情物品。

—

# 🎨 自定义物品材质

Photography 1.2.1 还为单个 ItemStack 引入了自定义材质。

这意味着你可以使用普通的 Minecraft 物品，并彻底改变该特定物品的外观。

示例：

`/photography texture item “keycard.png”`

也可以使用 URL：

`/photography texture item “https://example.com/keycard.png“`

支持：

– PNG
– 透明效果
– 本地文件
– 在线 URL
– 子文件夹
– 单个 ItemStack 的独立材质
– 安全回退至原版材质
– 在线材质缓存
– 从 16×16 到 256×256

本地材质存放于：

`mods/photography/item_textures/`

自定义材质**不要求**物品中包含媒体。

这意味着 Photography 也可用于创建自定义剧情道具，例如：

– 门禁卡
– VHS 录像带
– 拍立得照片
– 文件
– 软盘
– 钥匙
– 证物袋
– 对讲机
– 任务物品
– RPG 道具

自定义材质仍可与 Photography 的图片、音频或视频功能共存。

例如，外观像 VHS 录像带的自定义物品，实际上可以打开视频。

—

# 🔒 冒险模式保护

Photography 1.2.1 专门为冒险地图加入了保护功能。

处于冒险模式的玩家无法：

– 从讲台上取下书
– 编辑普通告示牌
– 编辑墙上告示牌
– 编辑悬挂式告示牌
– 编辑墙上悬挂式告示牌

讲台上的书仍可正常阅读。

## Camerapture 集成

如果安装了 **Camerapture**，Photography 也会在玩家处于冒险模式时保护它的相框。

玩家无法修改、旋转或破坏受保护的相框。

Camerapture 完全是可选的。

不安装它，Photography 也能正常运行。

—

# 🧊 过场动画游戏规则

Photography 提供了用于电影式场景的可选游戏规则。

### 冻结玩家

`/gamerule photographyFreezeDuringCutscenes true`

Photography 过场动画播放期间，玩家会保持原地不动，但仍可以环顾四周。

### 使玩家免受伤害

`/gamerule photographyInvulnerableDuringCutscenes true`

过场动画播放期间，玩家不会受到普通伤害。

这两条游戏规则默认均为禁用。

—

# ⏭️ onskip & then

Photography 为地图脚本提供了回调功能。

## `onskip`

在允许跳过的过场动画确实被跳过时运行。

`onskip “function story:skip”`

## `then`

在过场动画成功播放完毕后运行。

`then function story:continue`

在多人游戏中，Photography 会等待所有目标玩家完成后再运行 `then`。

—

# 🧰 普通 Minecraft 物品

Photography 不会强制你使用特殊的媒体物品。

手持现有的 Minecraft 物品，即可为其添加相应功能。

### 图片

`/photography image “Old Photograph” item “photo.png” ocultar true`

### 音频

`/photography audio “Recording #4” item “recording.mp3” ocultar true`

### 视频

`/photography video “Security Tape” item “camera04.mp4” ocultar true`

### 自定义材质

`/photography texture item “vhs.png”`

物品代表什么，由你决定。

—

# 🔄 重载系统

Photography 提供了以下命令：

`/photography reload`

在地图开发过程中很实用。

重载可以刷新：

– 本地媒体
– 物品材质
– 字幕数据

甚至可以在过场动画播放期间重载正在使用的字幕轨道。

—

# 📁 Photography 文件夹

Photography 使用以下文件夹：

`mods/photography/image/`

`mods/photography/audio/`

`mods/photography/video/`

`mods/photography/subtitles/`

`mods/photography/item_textures/`

—

# 🗺️ 为讲述故事而设计

Photography 旨在让地图创作者拥有充分的自由。

可用于：

– 冒险地图
– 恐怖地图
– RPG
– ARG
– 悬疑地图
– 密室逃脱
– 角色扮演服务器
– 故事类服务器
– 电影式项目
– 解谜地图
– 音频日志
– 伪纪录片影像
– 安保录像
– 角色对话
– 证物系统
– 调查玩法
– 自定义任务物品
– 直播画面
– 自定义道具
– 开场 / 结尾过场动画

它的目标不是告诉你该如何制作地图。

而是为你提供工具，让你实现任何想法。

—

# 📦 运行要求

### 必需

– Minecraft 1.21.1
– Fabric Loader
– Fabric API
– WATERMeDIA 2.1.37

### 可选

**WATERMeDIA YouTube Extension 2.1.2**
– 仅在播放 YouTube 内容时需要。

**Camerapture**
– 可选集成，为冒险模式下的画框提供保护。

—

# ❤️ 摄影

摄影最初是为了在 Minecraft 中展示图像。

如今，它已发展成一套创作故事的工具。

照片。  
音频。  
视频。  
直播。  
过场动画。  
字幕。  
证据。  
自定义物品。  
冒险模式保护。

**你的物品。你的媒体。你的故事。**