Screenshot Overhaul

截图大修

通过内置画廊、元数据、自定义名称、预览、全景图和地图集成来改进 Minecraft 截图
。

特性

• 可从标题界面和暂停菜单访问的内置截图画廊。
• 全屏截图查看器，支持导航、删除和复制操作。
• 画廊中的搜索、排序和收藏筛选。
• 持久化收藏，以及从兼容地图中隐藏特定截图的选项。
• 为截图添加 PNG 元数据：位置、维度、生物群系、种子、世界、服务器、版本、资源包、光影和时间戳。
• 可直接从画廊编辑元数据。
• 可配置的截图目录，支持子文件夹。
• 使用标记（<datetime>、<worldname>、<shader> 等）自定义截图文件名。
• 截图后的动画预览。
• 仅在截图时隐藏 HUD、聊天栏或手的选项。
• 可选在进度解锁时自动截图。
• 使用专用按键绑定进行全景图捕捉。
• 全景图画廊，并支持将捕捉的全景图用作标题界面背景。
• 可选与 Xaero的世界地图 和 旅行地图 集成，以在地图上显示截图。
• 兼容 Iris，可将当前光影保存到元数据和文件名标记中。
• 支持 Fabric 和 NeoForge。

代码库中存在照片模式，但由于该功能

仍处于开发阶段，因此被SCREENSHOT_OVERHAUL_ENABLE_PHOTO_MODE限制。

快速使用

• 从标题界面或暂停菜单打开截图画廊。
• 按 F9 拍摄全景截图。
• 使用标题界面上的 Change panorama 按钮选择已捕捉的全景图作为背景。
• 从画廊打开设置，在 Fabric 上通过模组菜单打开，或从 NeoForge 的模组配置界面打开。

配置

配置文件会在首次启动时自动创建：.minecraft/config/screenshot_overhaul.json。

通用

| 选项 | 描述 |
|———————————–|—————————————————————–|
| enableWholeMod | 启用或禁用该模组的功能。 |
| showScreenshotsOnXaerosWorldMap | 如果安装了该模组，则在 Xaero的世界地图 上显示截图。 |
| showScreenshotsOnJourneyMap | 如果安装了该模组，则在旅行地图上显示截图。 |

截图

| 选项 | 描述 |
|——————————–|——————————————————————————————-|
| screenshotsFileName | 用于命名截图的格式。可包含标记和子文件夹。 |
| screenshotsDir | 保存截图的目录。 |
| showChatMessage | 截图后显示 Minecraft 聊天消息。 |
| showPreview | 截图后显示动态预览。 |
| hideHudOnScreenshot | 截图时隐藏 HUD。 |
| hideChatOnScreenshot | 截图时隐藏聊天栏。启用 hideHudOnScreenshot 后，此选项不可用。 |
| hideHandOnScreenshot | 截图时隐藏玩家的手。 |
| grabScreenshotOnAdvancement | 解锁进度时自动截图。 |
| advancementScreenshotDelay | 进度截图前的延迟时间，以刻为单位。限制在 0 至 100 之间。 |

全景图

| 选项 | 描述 |
|—————————|——————————————————————————–|
| panoramaFolderName | 用于命名全景图文件夹的格式。 |
| panoramaResolution | 每个全景图面的像素分辨率。限制在 256 至 4096 之间。 |
| rotationSpeed | 标题界面全景图的旋转速度。限制在 0 至 100 之间。 |
| rotationDirection | 全景图的旋转方向。可选值：TO_LEFT、TO_RIGHT。 |
| verticalAngle | 全景图的垂直角度。限制在 -180 至 180 之间。 |
| startingHorizontalAngle | 全景图的初始水平角度。限制在 0 至 360 之间。 |

拍照模式

仅当在模组环境中启用拍照模式时，此类别才可用。

| 选项 | 描述 |
|———————|———————————-|
| freezeInPhotoMode | 在拍照模式下冻结世界。 |
| showPlayer | 在拍照模式下显示玩家。 |
| showNametags | 在拍照模式下显示玩家名牌。 |

界面保存的数据

这些值由模组保存，但并非主要的游戏选项。

| 选项 | 描述 |
|————————|———————————————————|
| screenshotSortOrder | 截图图库的已保存排序顺序。 |
| panoramaSortOrder | 全景图图库的已保存排序顺序。 |
| selectedPanoramaUUID | 当前用作标题界面背景的全景图。 |

命名标记

screenshotsFileName 和 panoramaFolderName 选项支持以下标记：

| 标记 | 描述 |
|—————|——————————————————|
| <datetime> | Minecraft 为文件名设置格式的日期和时间。 |
| <year> | 四位数年份。 |
| <month> | 两位数月份。 |
| <day> | 两位数日期。 |
| <hour> | 两位数小时。 |
| <minute> | 两位数分钟。 |
| <second> | 两位数秒数。 |
| <worldname> | 单人游戏世界名称；多人游戏时为空。 |
| <serverip> | 服务器地址；单人游戏时为空。 |
| <version> | Minecraft 版本。 |
| <shader> | 安装 Iris 时显示当前使用的光影，否则为空。 |

示例：

<year>/<month>/<datetime>
<worldname>/screenshot_<datetime>
<serverip>/<datetime>_<shader>

兼容性

| 模组 | 集成 |
|——————-|————————————————————|
| Mod Menu | 在 Fabric 上访问设置。 |
| Xaero’s World Map | 在地图上显示可选截图。 |
| JourneyMap | 在地图上显示可选截图。 |
| Iris | 检测当前使用的光影，用于元数据和文件名标记。 |