01 光影由客户端渲染
Minecraft Java 光影通过玩家本地渲染环境运行。升级租用服务器不会自动出现光影菜单，也不会让自己 GPU 上的高负载光影包变快。先区分本地游戏实例、光影渲染器、光影包和远端世界软件。
Official Iris page / Iris 官方说明 ↗ 列出 Java 光影及加载器兼容，当前支持 Fabric 和受支持的 NeoForge 版本，并明确不支持 Forge。不能把 Forge 与 NeoForge 混为一谈；Forge 整合包应按作者当前渲染说明配置，不能强放不兼容文件。
02 把渲染器装到实际启动的客户端实例
已有 Forge 1.20.1 整合包时，可以核对 Oculus author release page / Oculus 作者发布页 ↗，其列有对应版本与加载器的客户端发行版。遵循具体文件依赖和整合包作者兼容说明，不据此声称支持所有新版 Forge。Oculus 问题应向其维护者反馈，而不是上游 Iris。
- 记录客户端版本、加载器及已有渲染模组。
- 选择匹配组合的渲染器发行版。
- 采用官方安装器或整合包作者指定方法。
- 启动被修改的实例，确认出现光影包控件。
- 将兼容光影包放入该实例 shaderpacks 目录，在菜单选择并应用。
除非作者要求，否则保留原分发格式。CurseForge 实例目录可能与启动器默认目录不同，应使用打开文件夹功能。没有光影菜单时先解决实例和渲染器问题，不急着下载更多包。
03 叠加渲染模组前先检查兼容
Iris 文档指出部分渲染系统不兼容，具体光影包也未必支持所有设备和功能组合。先使用简单且受支持的“渲染器＋光影包”基线，正常后再逐一加入远视距、资源或其他渲染组件。
Java Iris 方法不适用于手机或主机基岩画面。基岩玩家应使用设备支持的图形功能与内容。Geyser 允许加入 Java 世界，不等于在基岩客户端安装 Java 渲染模组。
改动渲染后无法启动时，保留错误并恢复可用实例，按 Crash diagnostics / 崩溃流程 排查，而不是调不相关的服务端内存。
04 区分低 FPS 与服务器慢 tick
| 测试结果 | 建议检查 |
|---|---|
| 只有自己开光影后 FPS 下降 | GPU 负载、光影设置和客户端兼容。 |
| 不用光影的人也动作延迟 | 服务端负载或网络证据。 |
| 只有一名玩家看到地形缺失 | 重连或 Java 区块刷新。 |
| 干净客户端正常，整合包失败 | 该实例的渲染组合。 |
这些观察用于选择下一轮测试，不能直接保证诊断。对照同一场景开关光影。服务器取证用 spark，Java 显示刷新看 F3+A guidance / F3+A 指南。区分检查对象，避免因画面偏好而无谓迁服。