聚焦革命

Focus Revolution

适用于 Iris 着色器的手动对焦控制

Focus Revolution 是一款客户端 Minecraft 模组，可让你手动控制 Iris 着色器的景深对焦。它专为直播、游戏电影、电影化录制和截图而设计。

着色器包通常会自动对焦到屏幕中心附近的对象。这在常规游戏中运作良好，但在拍摄时可能不便，因为对焦会随着你移动准星而改变。Focus Revolution 让你掌控对焦，将其平滑地移动到想要的位置，并在完成后恢复自动对焦。

使用 Complementary Reimagined 拍摄

功能

功能	描述
手动对焦拉动	使用按键将近处或远处对焦。按住按键可平滑移动对焦。
自动 / 手动切换	切换到手动模式时会保留着色器当前的对焦位置，防止视觉突然跳变。切换回去后，着色器重新控制对焦。
平滑对焦移动	对焦会逐渐移向目标，而不是立即改变，从而产生更自然的镜头效果。
无限远锁定	移动超过最大距离可将对焦锁定在无限远，用于远景。
屏幕对焦显示	左上角的小型 HUD 显示当前对焦距离和模式。它会自动淡出，也可以设置为保持可见。
安全失败行为	如果没有激活着色器包或 Iris 版本不兼容，该功能会自动禁用并显示原因。它不会导致客户端崩溃。
可配置设置	调整对焦步长、平滑度、HUD 行为、最大距离，以及启动时是否恢复上次对焦状态。

要求

项目	要求
Minecraft	26.1、26.1.1、26.1.2 或 26.2
模组加载器	Fabric Loader 0.19.0 或更新版本
必需模组	Fabric API
必需模组	Iris 1.11.0 或更新版本
必需模组	Sodium

Focus Revolution 是仅客户端的。请勿将其安装到服务器上。仅在你用于游玩或录制的 Minecraft 客户端中安装它。

着色器包设置

Focus Revolution 需要启用景深的着色器包。着色器包还必须使用其自动对焦模式。

Complementary Reimagined

以下设置推荐用于 Complementary Reimagined：

1. 打开着色器设置。

2. 打开 Camera Settings。

3. 打开 World Blur Settings。

4. 将 WORLD_BLUR 设置为 2 (Depth Of Field)。

5. 将 WB_DOF_FOCUS 设置为 0 (Auto)。

其他着色器包如果其景深功能使用自动对焦，也可能以相同方式工作。如果着色器包设置为其自身的固定对焦或手动对焦模式，它可能会忽略 Focus Revolution 的对焦值。

安装

1. 为 Minecraft 26.1.x 或 26.2 安装 Fabric Loader。

2. 下载 Fabric API、Sodium、Iris 和 Focus Revolution。

3. 将相应的 .jar 文件放入你的 Minecraft mods 文件夹。

4. 使用 Fabric 配置文件启动 Minecraft。

5. 在 Iris 中激活着色器包，并按上述说明配置其景深设置。

控制

所有控制均可在选项 → 控制 → Focus Revolution 下更改。默认控制如下：

操作	默认按键	描述
切换自动 / 手动	F6	在自动和手动对焦之间切换。切换到手动模式时会保留当前对焦。
对焦更近	[	将对焦移近。按住 Shift 进行粗调。
对焦更远	]	将对焦移远。按住 Shift 进行粗调。
切换 HUD 常亮	未绑定	保持对焦显示永久可见，而不是让其淡出。
切换自动回读	未绑定	更改使用自动模式时对焦显示的更新频率。

[ 和 ] 键的物理位置和显示名称取决于你的键盘布局。如果默认按键不便，请从控制菜单中重新绑定。

在手动模式下，HUD 会显示类似以下信息：

[Camera] Focus: 5.2m (Manual)

当对焦锁定在无限远时，距离显示为 ∞。

在自动模式下按下对焦键不会改变对焦。HUD 可能会显示以便你检查当前状态，但误按键不会破坏录制。

配置

首次在安装该模组的情况下启动游戏时，会创建一个名为 config/focus_revolution.json 的配置文件。大多数用户可以使用游戏内控制，无需编辑此文件。如果你要编辑它，请先关闭 Minecraft。

设置	描述
fineStep	正常操作时每次按键移动的对焦距离。默认值为 0.1 米。
coarseStep	按住 Shift 时每次按键移动的对焦距离。默认值为 1.0 米。
lerpTau	对焦移动的平滑度。较小的值移动更快；较大的值移动更慢。值为 0 时对焦立即改变。
maxDistance	最大手动对焦距离。默认值为 512 米。移动超过此距离会将对焦锁定在无限远。
hudFadeSeconds	对焦改变后 HUD 保持可见的时间。默认值为 3 秒。
hudAlwaysOn	设置为 true 可使对焦显示永久可见。
autoReadbackEveryFrame	设置为 true 可每帧更新自动模式显示。默认设置对性能更友好，适合大多数用户。
restoreOnLaunch	设置为 true 可在 Minecraft 启动时恢复之前的模式和焦点距离。

上次的模式和对焦距离会在游戏退出时自动保存。

故障排除

如果对焦不改变，请首先检查 Iris 和 Sodium 是否已正确安装，以及着色器包是否处于激活状态。然后确认景深已启用，并且着色器包正在使用自动对焦。

如果对焦仍然没有响应，着色器包可能不支持 Focus Revolution 所使用的自动对焦方法。检查着色器包是否有固定对焦或手动对焦选项，如有可用选项，将其切换为自动对焦。

如果所需环境缺失或不兼容，Focus Revolution 会自动禁用并显示原因。如果发生这种情况，请检查 Minecraft、Fabric Loader、Fabric API、Iris 和 Sodium 的版本。

许可证

Focus Revolution 在 MIT 许可证下发布。