焦点革命

Focus Revolution

Iris 着色器的手动对焦控制

Focus Revolution 是一个客户端 Minecraft 模组，允许你手动控制 Iris 着色器的景深对焦。它专为直播、Machinima、电影式录制和截图而设计。

着色器包通常会自动对焦到屏幕中心附近的物体上。这在常规游戏过程中效果很好，但在拍摄时可能会带来不便，因为当你移动准星时，对焦可能会发生变化。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. 打开相机设置。
3. 打开世界模糊设置。
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 许可证发布。