摄影 · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

📸 Photography

将Minecraft物品变成照片、录音、视频、证据、道具、过场动画等等。

Photography 是一个适用于Minecraft 1.21.1的 Fabric 模组，专为冒险地图、恐怖地图、RPG、悬疑、ARG、角色扮演服务器和剧情驱动体验而设计。

这个想法起初很简单：

如果一个普通的Minecraft物品能够打开一张真实的图片会怎样？

如今，Photography 能做的远不止于此。

一张纸可以变成一张照片。
一本书可以包含一段视频。
一个重命名的物品可以变成一卷VHS录像带。
一把钥匙可以拥有自己专属的自定义纹理。
玩家可以在调查日志中收集证据。
一个命令方块可以触发全屏过场动画。
一个Twitch直播可以出现在Minecraft中。

而且几乎所有功能都是围绕**普通的Minecraft物品堆（ItemStacks）**设计的，因此地图作者可以决定他们的物品实际上代表什么。

🖼️ 图片与 GIF

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

支持的格式：

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

图片查看器包括：

鼠标滚轮缩放
拖拽平移
动画GIF播放
受Minecraft启发的界面

非常适合：

照片
文件
证据
地图
图画
海报
笔记
谜题线索

本地文件存储在：

mods/photography/image/

🎵 音频

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

支持的格式：

音频播放器包括：

播放 / 暂停
进度拖动
进度显示
时长
音量控制
受Minecraft启发的界面

可用于：

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

本地音频存储在：

mods/photography/audio/

🎬 视频

Photography 可以直接在Minecraft内播放真正的视频。

支持的来源包括：

本地MP4文件
直接在线视频源
Twitch
通过可选的 WATERMeDIA YouTube 扩展支持 YouTube

视频播放器包括：

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

本地视频存储在：

mods/photography/video/

视频播放由 WATERMeDIA 提供技术支持。

🔴 YouTube 与 Twitch

Photography 通过 WATERMeDIA 支持在线媒体。

YouTube

YouTube 播放需要可选的：

WATERMeDIA YouTube 扩展

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

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

如果缺少该扩展，Photography 会显示清晰的错误提示，而不是崩溃或无休止地加载。

Twitch

Twitch 直播通过 WATERMeDIA 直接支持。

Photography 会自动检测直播（LIVE）内容并改变播放器行为：

显示 ● LIVE 指示器
不显示虚假时长
在适当时禁用进度拖动
在可用时显示频道/来源信息

🎞️ 全屏过场动画

Photography 包含一个由命令驱动的电影系统，专为地图作者设计。

示例：

/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 新增了调查日志（Investigation Journal），专为悬疑、恐怖和剧情地图设计。

该日志作为一个持久化的证据收集系统。

将其装备到专属的背包槽位中，玩家发现的 Photography 媒体物品将被自动记录。

功能包括：

专属日志背包槽位
自动证据收集
证据存储在日志本身内
丢弃、存储或转移时证据保持持久
每页 27 个证据条目
最多 270 个条目
分页
直接从日志打开已保存的媒体
带确认提示的删除证据
已删除的证据名称仍会被该日志屏蔽
自定义日志纹理
受原版启发的容器界面

原始物品永远不会被移除。

日志会存储证据的快照。

这允许玩家在整个冒险过程中建立真实的照片、视频、录音和剧情物品收藏。

🎨 自定义物品纹理

Photography 1.2.1 还为单个物品堆引入了自定义纹理。

这意味着你可以拿一个普通的Minecraft物品，完全改变该特定物品的外观。

示例：

/photography texture item "keycard.png"

或通过 URL：

/photography texture item "https://example.com/keycard.png"

支持：

PNG
透明度
本地文件
在线URL
子文件夹
每个物品堆独立纹理
安全回退到原版纹理
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 "旧照片" item "photo.png" ocultar true

音频

/photography audio "录音#4" item "recording.mp3" ocultar true

视频

/photography video "安全录像带" 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 扩展 2.1.2

仅播放 YouTube 时需要。

Camerapture

可选集成，用于冒险模式下的相框保护。

❤️ Photography

Photography 最初是为了在Minecraft内显示图片而诞生的。

它已经成长为一个用于创作故事的工具包。

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

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