太阳井

☀️ Sunwell

一款可以悬挂在天花板上的便携天窗。在地下也能享受真实的天空光照——一切由你掌控。

Sunwell 添加了可合成的 太阳井灯笼，能够将真正的 Minecraft 天空光照 投射到封闭空间中。农作物可以生长，动态树木得以存活，日光传感器会响应，雨水和雪花会飘落而下，闪电也会在暴风雨中劈穿光柱。

就像露天环境一样——只不过你可以将它挂在天花板上。整合包作者可以获得一个 基于标签的引擎：无需编写 Java 代码，即可将任何方块注册为简单的生长灯或功能完整的天气感知太阳井。

✨ 为什么不用火把？

🏮 太阳井灯笼

• 🪝 与原版灯笼放置方式一致 —— 可放置于地面或悬挂在天花板上。
• 🔦 以向下扩大的光锥投射天空光照 —— 挂得越高，照亮的地面范围越广。宛如一个小太阳。
• 🌗 球体实时映射其所代表的天空 —— 太阳、月亮、云层或雷暴云（见下文）。
• 🧪 合成配方： 石英 ×3 · 铁栏杆 ×4 · 萤石 · 玻璃。

⚠️ 从 2.0.x 升级 —— 灵魂井灯笼已被移除（现在一个灯笼即可呈现所有天空状态）。已放置的灵魂井灯笼将无法通过升级保留，任何引用 sunwell:soulwell_lantern 的内容都需要更新。

🌤️ 球体是一扇窗户

看向灯笼内部，你会看到它所代表的天空。它会随着天空的变化而同步变化。

⛅ 光锥内的天气

为灯笼添加完整天气标签（或使用默认的太阳井灯笼），天空便会随之降临：

• 🌧️ 雨水 会穿过整个被照亮区域，并在落地处溅起水花 —— 下雨时是细雨绵绵，暴雨时则是倾盆大雨。
• ❄️ 寒冷生物群系中的降雪会缓缓飘落，并在地面上逐渐堆积成雪层，随着时间推移使光照区域变得银装素裹。
• ⚡ 雷暴天气中，闪电会劈穿光柱。闪电会随机落在光池中的某个位置，但倾向于击中区域内最高的目标 —— 无论是树木、生物还是玩家。光池中任意位置的避雷针都能无害地接住闪电，并为其红石电路提供能量。避雷针附近的闪电概率会显著提高。

🏷️ 基于标签的行为机制

每个太阳井方块都需要 #sunwell:sunwell_source 标签。仅需此标签即可成为静态生长灯 —— 始终开启的虚拟天空，无天气效果，无降雨。通过添加额外标签可解锁更多功能：

太阳井灯笼 默认集齐全部四种标签。完整的天气呈现效果（天空映射球体、雨/雪、积雪堆积、闪电）需要同时具备 dynamic_exposure 和 rain_through 两种标签。

📦 注册你自己的方块（数据包 & KubeJS）

{
  "replace": false,
  "values": [
    "yourmod:ceiling_lamp"
  ]
}

ServerEvents.tags('block', event => {
  // 静态生长灯
  event.add('sunwell:sunwell_source', 'yourmod:ceiling_lamp')

  // 完整功能
  const block = 'yourmod:solar_panel'
  event.add('sunwell:sunwell_source',   block)
  event.add('sunwell:dynamic_exposure', block)
  event.add('sunwell:undead_burning',   block)
  event.add('sunwell:rain_through',     block)
})

⚙️ 完整配置参考

📦 支持版本

两个版本功能完整 —— 包括灯笼、视觉效果、标签系统以及 Amendments 墙壁/手持灯笼兼容性。在 1.21.1 版本中，数据包文件夹名为单数形式（tags/block、recipe、loot_table）。

📜 致谢与许可

Sunwell 是 SdataG 的原创模组 —— 所有代码、模型、纹理和视觉效果均为本项目原创；未移植任何素材。天花板天窗的创意在模组界并不陌生（例如 Ferreus Veritas 的 Skylight Lanterns）；Sunwell 是一个独立的重新实现。