真正明亮

🌟 极致光明 - 动态光照

你手中的火把应当照亮房间，而不仅仅是你的物品栏。

手持火把 · 掉落灯笼 · 燃烧的生物 · 专为极致黑暗打造 · 原生支持钠 · 兼容机械动力

---

🤝 配套模组

https://www.curseforge.com/minecraft/mc-mods/truly-dark

---

🔦 概述

Minecraft 最快的动态光照模组。2026年7月30日

你走进一个洞穴。你举起火把。在原版 Minecraft 中，火把照亮了……你的快捷栏。洞穴依旧黑暗。三格外的怪物依旧黑暗。你面前的墙壁依旧黑暗。

极致光明解决了这个问题。

你手持的每一支火把、你扔下的每一盏灯笼、每一只着火的苦力怕、你游过的每一只发光鱿鱼——它们都会向周围的世界投射真实的动态光照。光线跟随那些本应发光的事物，而不是你物品栏里的图标。

🌑 作为极致黑暗的配套模组而构建 —— 那个模组将环境天光移除，这个模组则将玩家自身的光线放回，只在你实际拥有光的地方。它们是一对设计组合：先关掉世界的光，然后带上你自己的光。

---

💡 它实际照亮什么

任何本应发光的东西都会发光。开箱即用：

• 🔥 手持物品 —— 火把、灯笼、灵魂灯笼、萤石、海晶灯、红石火把、南瓜灯、熔岩桶、烈焰棒、岩浆块
• 📦 掉落物 —— 相同的列表，以 ItemEntity 形式存在于地面上
• 🖼️ 物品展示框 —— 展示框中的火把依然是火把
• 🐛 发光的生物 —— 发光鱿鱼、岩浆怪、烈焰人
• 🔥 燃烧中的实体 —— 任何当前着火的物体（火焰箭矢、点燃的 TNT、被点着的苦力怕）都会发出 15 级的光
• 💧 水感知 —— 火把在水中会熄灭；海晶灯和萤石会持续发光

每一项物品的亮度、衰减半径和水敏感标志都由数据驱动。模组物品可以通过 JSON 资源包加入支持。

---

⚙️ 引擎亮点

一次构建，处处快速。引擎盖下的一些内容：

• 🚀 从第一天起就原生支持钠 —— 独立的 mixin 路径直接接入 Sodium / Embeddium 的区块构建器，使动态光直接烘焙到你的区块顶点中，而不仅仅是屏幕空间的光照贴图
• 🧵 无锁、线程安全 —— 写入时发布快照架构意味着 Sodium 的工作线程永远不会等待引擎，也永远不会看到不一致的状态
• 📐 精确键空间索引 —— 你的第五支火把永远不会意外照亮你五分钟前走过的洞穴，因为两个单元格坐标恰好共享了一个哈希桶
• 🎚️ 每个光源独立的衰减曲线 —— 线性、平方反比或平滑步进，按光源选择。平滑步进消除了移动火把穿过区块边界时可见的"跳变"
• 🌈 内部 RGB 跟踪 —— 即使输出是单色的，颜色也会流经引擎，因此 Iris/Oculus 路径之后可以拾取它
• 📏 亚方块级插值 —— 写入光照贴图的亮度值具有完整的分数精度，不会被截断为 0-15 的整数等级
• 🔁 增量快照重建 —— 只有指纹自上一帧以来实际变化的光源才会重新分配；相同的帧完全跳过重建

无加载器的引擎，完全单元测试，无需启动 Minecraft。

---

🛞 兼容替换渲染的模组

这是其他动态光照模组悄悄失败的地方。

• 🟩 Sodium / Embeddium —— 在区块构建器层面处理。你点亮的方块会在 Sodium 的工作线程上烘焙到几何体中，就像原版光照一样
• ⚙️ 机械动力 + Flywheel —— 极致光明挂钩 Flywheel 的每区块 GPU 光照缓冲区，位于 LightDataCollector.collectSection。你的火把会照亮你旁边的动力机械、经过你身边的矿车、三格外的风车。（四年来，lambdynamiclights issue #120 一直在跟踪同样的架构不匹配问题，且没有修复——极致光明在我们这边修复了它。）
• 🛩️ 机械动力：航空学 —— 飞行器 contraption 通过 Flywheel 渲染，因此它们被自动覆盖。你飞艇甲板上的火把实际上照亮了甲板。
• 🎨 Colorwheel（Iris × Flywheel 桥接）—— 它的 ClrwlEngine 实例化了相同的 LightStorage，因此相同的挂钩透明地覆盖了它
• 🌃 Iris / Oculus 光影 —— 见下方章节

✅ 无需特殊配置。 直接放入 jar 文件即可。我们在加载时检测 Flywheel，并且仅在其存在时才应用兼容 mixin——在没有它的环境上不会出现 NoClassDefFoundError。

---

⚠️ 模组开发者（API 访问）

我们为有志于为其最终用户集成极致光明支持的模组开发者提供了公开 API 文档：

https://github.com/dylanjkl/TrulyBrightAPI

---

🌑 为极致黑暗而设计

这两个模组围绕相同的世界感受构建：

	极致黑暗	极致光明
职责	将环境光线 移除	将玩家的光线 放回
层面	天空 / 雾 / 云 / 洞穴阴影	世界方块网格上的方块光照
当……时你会感受到	午夜真正地黑暗	你放置的火把真正照亮了墙壁
多人游戏安全	✅ 仅客户端	✅ 仅客户端
钠兼容	✅	✅

将它们一起使用，以获得它们被设计时的完整体验：除了你选择放置光线的地方之外，到处都是真正的黑暗。

也可以单独使用任何一个——它们都能独立存在。

---

🛠️ 加载器与版本兼容性

	1.20.1	1.21.1
Forge	✅	—
NeoForge	✅	✅
Fabric	✅	—
Quilt	✅	—

✅ 功能上仅客户端 —— 在客户端运行，无服务端游戏玩法更改 ✅ 专用服务器安全 —— 门控初始化器允许 jar 文件放置在服务器上以保持模组列表一致，而不会触碰渲染代码 ✅ 多人游戏安全 —— 无数据包、无协议更改，每个玩家都看到自己的动态光照 ✅ 无必需依赖（Fabric / Quilt 上除 Fabric API 外）

随着加载器的发展，更多 1.21.x 移植版本将会推出。

---

⚠️ 关于光影（Iris / Oculus）

光影包替换了 Minecraft 的光照管线。当光影包激活时，极致光明的效果有可能被绕过 —— 这与极致黑暗指出的架构不匹配相同，只是从亮度一侧而非黑暗一侧。

*请注意，某些光影包将原生兼容，因为简单的光影包（Sildur's Lite、默认配置的 BSL、原版增强）会在其合成阶段采样光照贴图纹理——这会拾取我们变亮的像素，效果会免费呈现。而那些从原始方块光照值重建光照的重型光影包则不会。这取决于光影包——试试看并发表评论，帮助其他人了解哪些可用。*

一个带有彩色 RGB 输出的一流 Iris/Oculus 路径已列入路线图——引擎已经在内部端到端跟踪颜色，因此当光影侧接线完成时，无需更改引擎。

tl;dr —— 与极致黑暗相同的免责声明：试试你的光影，效果可能因人而异。

---

🚫 它不是

• ❌ 不是手电筒模组 —— 它照亮本应已经发光的事物，而不是相机方向
• ❌ 不是内容模组 —— 不添加物品、方块或配方
• ❌ 不是服务端游戏玩法更改 —— 其他玩家看到自己的光
• ❌ 不是光影 —— 无需光影也能工作，也不试图替代光影
• ❌ 不激进 —— 每一项物品的亮度和衰减都是可调的、JSON 驱动的，并且可以公开注册

仅此而已：你手中的火把确实在履行它的职责。

---

携带黑暗。携带光明。

模组作者：Dylan · 保留所有权利

配套模组：🌑 极致黑暗