Iridium 是一款面向 Minecraft 1.21.1 的现代 Fabric 优化模组,旨在补充 Sodium 和 Lithium 尚未涵盖的优化项——包括实体与粒子剔除、区块实体(Block Entity)剔除、漏斗/爆炸/村民 AI/投射物的服务端节流机制,以及游戏窗口失去焦点时的动态 FPS。
Iridium 是 Sodium 和 Lithium 的配套模组,而非替代品。当检测到 Sodium 时,冲突的渲染 Mixin 会在加载时自动禁用;此外,Iridium 还会检测 EntityCulling、MoreCulling、ImmediatelyFast 和 Dynamic FPS:重叠的功能会自动让出,从而避免重复工作或因重复挂钩导致的卡顿。
它同时适用于客户端和专用服务器。当环境不适用时,各功能集将变为空操作(no-ops)。
性能表现
在 Minecraft 1.21.1 环境下测试,以 Sodium + Lithium 为基线(这是任何专注于优化的玩家的合理起点)。场景完全相同,包含大量可见的实体、粒子和区块实体。
| 配置 |
平均帧率 |
1% 低帧率 |
0.2% 低帧率 |
| Sodium + Lithium |
454.7 |
133.6 |
80.4 |
| Sodium + Lithium + Iridium |
499.0 |
139.7 |
89.8 |
平均帧率提升 +9.7% · 1% 低帧率提升 +4.6% · 0.2% 低帧率提升 +11.7%
最大的增益体现在 0.2% 低帧率百分位——即最差的那些帧。Iridium 的主要贡献在于平滑包含大量实体、粒子和区块实体场景中的卡顿,而非进一步提高已经很高的平均帧率上限。
注意: 性能表现因硬件、软件及渲染场景而异。上述数据来自我们在以下配置下的内部基准测试:
硬件: Intel Core i7-10700, NVIDIA RTX 5060, 32 GB DDR4-2933, Windows 11
软件: Java 21, Fabric Loader 0.15.11, Sodium 0.6.x, Lithium 最新版
欢迎复现测试和反向测试——请在 GitHub 上提交包含你的场景和数据的 Issue。
✨ Iridium 的功能
客户端侧(渲染)
- 实体剔除(Entity Culling) —— 跳过相机视锥体外的实体。
- 粒子剔除与上限控制(Particle Culling + Cap) —— 对粒子进行视锥剔除,并限制活跃数量(烟花有单独的上限)。
- 区块实体剔除(Block Entity Culling) —— 跳过视锥体外的箱子、熔炉、信标和潜影盒。
- 动画剔除(Animation Culling) —— 跳过屏幕外实体的客户端动画步骤。
- 信标光束剔除(Beacon Beam Culling) —— 当其柱体位于视锥体外时,跳过信标光束的渲染。
- 手持物品剔除(Held Item Culling) —— 跳过屏幕外生物的手持物品渲染。
- 名牌缓存(Nametag Cache) —— 在帧之间缓存渲染的名牌文本;内容变更时失效。
- 地图纹理缓存(Map Texture Cache) —— 当地图数据未更改时,跳过地图纹理的重新上传。
- 动态 FPS(Dynamic FPS) —— 当窗口最小化或失去焦点时大幅降低帧率(切换标签页时节省约 90% 的 CPU/GPU 资源)。
服务端侧(Tick)
- 漏斗节流(Hopper Throttle) —— 闲置的漏斗减少 Tick 频率(可配置)。
- 爆炸射线缓存(Explosion Ray Cache) —— 缓存同时发生的附近爆炸的射线检测结果。
- 随机 Tick 节流(Random Tick Throttle) —— 跳过没有玩家附近的区块内的方块随机 Tick。
- 物品实体合并节流(Item Entity Merge Throttle) —— 合并扫描每 N 个 Tick 运行一次,而非每个 Tick 都运行。
- 村民 AI 节流(Villager AI Throttle) —— 当没有玩家在范围内时,降低传感器/大脑的运行频率。
- 火势蔓延节流(Fire Spread Throttle) —— 减缓没有玩家附近区块内的火势传播速度。
- 投射物 Tick 节流(Projectile Tick Throttle) —— 远处的投射物每 3 个 Tick Tick 一次,并附带短距离前瞻射线检测保护,以确保命中检测保持完整。
生活质量改进
- 游戏内配置界面(集成 ModMenu)。
- 默认设置针对开箱即用的最大性能进行了调整;每个功能均可单独开关。
- 调试叠加层显示被剔除的实体、粒子、漏斗以及预估的性能节省(在“控制”中绑定热键)。
- 可选的热键用于切换实体剔除、粒子剔除和动态 FPS。
/iridium reload 命令可在不重启的情况下重新加载 config/iridium.json。
? 视觉质量
Iridium 绝不会为了提升 FPS 而降低视觉质量。没有基于距离的剔除,没有自适应 LOD,也没有“低 FPS 时降低画质”的投机取巧。仅跳过相机视锥体之外的几何结构——这在定义上是你看不到的部分。服务端节流仅在没有任何玩家在范围内观察差异时才会激活。
此规则贯穿整个代码库,并非一个可以关闭的配置选项。
?️ 路线图
Iridium 0.1.0 仅针对 Minecraft 1.21.1。在此之上,以下是未来版本的方向——方向而非带有日期的承诺:
- 更广泛的 Minecraft 版本支持。 一旦 0.1.0 稳定,Iridium 将扩展到最受欢迎且生命周期较长的 Minecraft 发行版,使用 Stonecutter 使单个源代码树能够为多个 MC 版本生成构建。计划的目标首先是 1.21.4(冬季更新)作为试点,然后是 1.20.1(在 Create 和 Cobblemon 等大型整合包生态系统中仍占主导地位的版本)。短期的小版本(1.21.2 / 1.21.3)可能会被跳过。
- 新的优化空白。 功能的添加基于实际的性能收益,而非炒作。设计理念保持不变:填补 Sodium 和 Lithium 留下的特定空白,绝不为了提升 FPS 而降低视觉质量。欢迎通过 GitHub Issues 提出社区建议。
- 不变的部分。 无网络调用、无遥测、无着色器、无基于距离的剔除、无自适应画质技巧。这些是由设计强制执行的,而不是你需要关闭的开关。
1.20.1 之前的版本不在计划之中——维护成本随着支持三个以上版本的增长速度快于预期的收益。
✅ 兼容性
Iridium 旨在与 Fabric 优化生态系统中的其他组件共存。
| 模组 |
状态 |
| Sodium 0.6.x |
冲突的渲染混合器(mixins)会在加载时自动禁用。其他所有功能保持开启。 |
| Lithium |
无冲突。Iridium 弥补了 Lithium 未覆盖的空白(漏斗、村民 AI、火焰、投射物)。 |
| EntityCulling (tr7zw) |
实体与区块实体剔除会自动让步。不会产生双重剔除的性能开销。 |
| MoreCulling |
信标光束剔除会自动让步。 |
| ImmediatelyFast |
地图纹理缓存会自动让步。 |
| Dynamic FPS (juliand665) |
动态 FPS 功能会自动让步,以防止重复的帧率节流。 |
| Starlight |
无冲突。 |
| FerriteCore |
无冲突。 |
| ModernFix |
无冲突。 |
| ModMenu |
可选。用于游戏内配置界面。 |
无网络调用。无遥测数据。无阴影处理。 根据 PolyForm Shield 1.0.0 发布 —— 这与 Sodium 使用的同源可用许可证相同。
需要更多的性能提升?
设计上,Iridium 仅填补特定的空白。为了获得最佳的整体效果,我们建议将其与 Sodium(渲染管线)和 Lithium(游戏逻辑)一同安装。它们覆盖了 Iridium 未涉及的部分。
? 整合包政策
你可以完全自由地将 Iridium 包含在任何整合包中——无论是公开或私有、免费或付费。无需署名或授权。
PolyForm Shield 许可证唯一不允许的是将 Iridium 的源代码重新打包成具有竞争关系的优化模组。正常的整合包使用始终是被允许的。
? 安装方法
- 为 Minecraft 1.21.1 安装 Fabric Loader 0.15.11 或更高版本。
- 将 Fabric API 放入你的
mods/ 文件夹。
- 将 Iridium 的
.jar 文件放入 mods/ 文件夹。
- (推荐) 添加 Sodium 和 Lithium 以获得最佳效果。
- (可选) 添加 ModMenu 以获取游戏内配置界面。
启动游戏。配置文件将在首次运行时生成于 config/iridium.json。
? 如何报告问题
请使用 问题追踪器 来报告错误、崩溃和意外行为。在提交问题时,请包含:
- Minecraft 版本、Fabric Loader 版本以及 Iridium 版本
- 已安装的其他模组(尤其是其他优化类模组)
- 崩溃日志或
latest.log(如果适用)
- 复现步骤
Iridium is a modern Fabric optimization mod for Minecraft 1.21.1, designed to complement Sodium and Lithium by covering optimizations they do not include — entity and particle culling, block-entity culling, server-side throttles for hoppers, explosions, villager AI, projectiles, and dynamic FPS when the game window is unfocused.
Iridium is a companion to Sodium and Lithium, not a replacement. Conflicting rendering mixins auto-disable at load time when Sodium is detected — and beyond Sodium, Iridium also detects EntityCulling, MoreCulling, ImmediatelyFast and Dynamic FPS: overlapping features automatically yield so there is no double-work or stutter from duplicate hooks.
It works on both client and dedicated server. Each feature set no-ops when the environment doesn't apply.
Performance
Tested on Minecraft 1.21.1 with Sodium + Lithium as the baseline (the realistic starting point for any optimization-focused player). Identical scene, with many entities, particles, and block entities visible.
| Setup |
Avg FPS |
1% low |
0.2% low |
| Sodium + Lithium |
454.7 |
133.6 |
80.4 |
| Sodium + Lithium + Iridium |
499.0 |
139.7 |
89.8 |
+9.7% avg FPS · +4.6% 1% low · +11.7% 0.2% low
The largest gain is in the 0.2% low percentile — the worst frames. Iridium's main contribution is smoothing stutter in scenes with many entities, particles, and block entities, not raising an already-high average ceiling.
Note: Performance varies depending on hardware, software, and the scene being rendered. The numbers above come from our internal benchmark on the following configuration:
Hardware: Intel Core i7-10700, NVIDIA RTX 5060, 32 GB DDR4-2933, Windows 11
Software: Java 21, Fabric Loader 0.15.11, Sodium 0.6.x, Lithium latest
Reproductions and counter-tests are welcomed — open an issue with your scene and your numbers.
✨ What Iridium does
Client-side (rendering)
- Entity Culling — skips entities outside the camera frustum.
- Particle Culling + Cap — frustum-culls particles and caps active counts (separate cap for fireworks).
- Block Entity Culling — chests, furnaces, beacons, shulkers outside the frustum are skipped.
- Animation Culling — skips client-side animation steps for off-screen entities.
- Beacon Beam Culling — skips the beacon beam when its column is outside the frustum.
- Held Item Culling — skips item-in-hand render for off-screen mobs.
- Nametag Cache — caches rendered nametag text between frames; invalidated on change.
- Map Texture Cache — skips map texture re-upload when map data hasn't changed.
- Dynamic FPS — drops frame rate drastically when the window is minimized or unfocused (~90% CPU/GPU saved on Alt-Tab).
Server-side (tick)
- Hopper Throttle — idle hoppers tick less frequently (configurable).
- Explosion Ray Cache — caches raycasts for simultaneous nearby explosions.
- Random Tick Throttle — skips random block ticks in chunks with no nearby player.
- Item Entity Merge Throttle — merge scans run every N ticks instead of every tick.
- Villager AI Throttle — reduces sensor/brain frequency when no player is within range.
- Fire Spread Throttle — slows fire propagation in chunks with no nearby player.
- Projectile Tick Throttle — far projectiles tick 1-in-3, with a short-lookahead raycast guard so hit detection stays intact.
Quality of life
- In-game config screen (ModMenu integration).
- Defaults tuned for maximum performance out of the box; every feature individually toggleable.
- Debug overlay showing culled entities, particles, hoppers and estimated savings (bind hotkey in Controls).
- Optional toggle hotkeys for Entity Culling, Particle Culling and Dynamic FPS.
/iridium reload command reloads config/iridium.json without restart.
? Visual quality
Iridium never reduces visual quality to gain FPS. No distance-based culling, no adaptive LOD, no "drop quality when FPS is low" tricks. Only geometry outside the camera frustum — which by definition you can't see — is skipped. Server-side throttles only activate when no player is in range to observe the difference.
This rule is enforced throughout the codebase and is not a config option you can turn off.
?️ Roadmap
Iridium 0.1.0 targets Minecraft 1.21.1 only. Beyond that, here's the direction for future versions — directions, not dated promises:
- Broader Minecraft version support. Once 0.1.0 stabilizes, Iridium will expand to the most popular long-lived Minecraft releases using Stonecutter so a single source tree can produce builds for multiple MC versions. Planned targets: 1.21.4 (Winter Drop) first as a pilot, then 1.20.1 (the version still dominant in large modpack ecosystems like Create and Cobblemon). Short-lived minors (1.21.2 / 1.21.3) will likely be skipped.
- New optimization gaps. Features are added based on measured wins, not hype. The design philosophy stays the same: fill specific gaps left by Sodium and Lithium, never reduce visual quality to gain FPS. Community suggestions via GitHub issues are welcome.
- What will not change. No network calls, no telemetry, no shading, no distance-based culling, no adaptive quality tricks. These are enforced by design, not toggles you have to turn off.
Versions older than 1.20.1 are not planned — maintenance cost beyond three supported releases grows faster than the expected benefit.
✅ Compatibility
Iridium is designed to coexist with the rest of the Fabric optimization ecosystem.
| Mod |
Status |
| Sodium 0.6.x |
Conflicting rendering mixins auto-disable at load time. All other features stay on. |
| Lithium |
No conflicts. Iridium covers gaps Lithium doesn't (hopper, villager AI, fire, projectiles). |
| EntityCulling (tr7zw) |
Entity and block-entity culling auto-yield. No double-culling overhead. |
| MoreCulling |
Beacon beam culling auto-yields. |
| ImmediatelyFast |
Map texture cache auto-yields. |
| Dynamic FPS (juliand665) |
Dynamic FPS feature auto-yields to prevent duplicate frame throttling. |
| Starlight |
No conflicts. |
| FerriteCore |
No conflicts. |
| ModernFix |
No conflicts. |
| ModMenu |
Optional. Used for the in-game config screen. |
No network calls. No telemetry. No shading. Released under PolyForm Shield 1.0.0 — the same source-available license used by Sodium.
Need even more performance?
By design, Iridium only fills specific gaps. For the best overall result we recommend installing it alongside Sodium (rendering pipeline) and Lithium (game logic). They cover the parts Iridium does not.
? Modpack Policy
You are completely free to include Iridium in any modpack — public or private, free or paid. No credit or permission required.
The only thing the PolyForm Shield license does not allow is repackaging Iridium's source code into a competing optimization mod. Normal modpack usage is always fine.
? Installation
- Install Fabric Loader 0.15.11 or newer for Minecraft 1.21.1.
- Drop Fabric API into your
mods/ folder.
- Drop the Iridium
.jar into mods/.
- (Recommended) Add Sodium and Lithium for best results.
- (Optional) Add ModMenu to get the in-game config screen.
Launch the game. The config file is generated at config/iridium.json on first run.
? How to report issues
Please use the issue tracker to report bugs, crashes and unexpected behavior. When opening an issue, include:
- Minecraft version, Fabric Loader version, and Iridium version
- Other mods installed (especially other optimization mods)
- Crash log or
latest.log if applicable
- Steps to reproduce
评论 0
登录后参与评分
还没有评论,来抢沙发吧