SunWell

Ai Used for the disctiption  ( Not in the mod other than normal asisstant)

Join for Sunwell Help

☀️ Sunwell

A portable hole in the ceiling. Real sky light underground — on your terms.

Sunwell adds craftable Sunwell Lanterns that project true Minecraft sky light into enclosed spaces. Crops grow, Dynamic Trees survive, daylight sensors respond, rain and snow fall through, and lightning cracks down the column in a storm.

Like open sky — except you hang it from a ceiling. Pack makers get a tag-driven engine: register any block as a simple grow lamp or a full weather-aware sunwell, no Java required.

✨ Why not just a torch?

🏮 The Sunwell Lantern

• 🪝 Vanilla lantern placement — stands on the floor or hangs from a ceiling.
• 🔦 Projects sky light in a downward-widening cone — hang it higher to light a wider pool of floor. Like a small sun.
• 🌗 The orb mirrors the sky it stands in for — sun, moon, cloud or thunderhead (see below).
• 🧪 Recipe: Quartz ×3 · Iron Bars ×4 · Glowstone · Glass.

⚠️ Upgrading from 2.0.x — the Soulwell Lantern has been removed (one lamp now presents every sky). Placed Soulwell Lanterns will not survive the update, and anything referencing sunwell:soulwell_lantern must be updated.

🌤️ The orb is a window

Look into the lantern and you see the sky it stands in for. It changes when the sky changes and as fast as the sky changes.

⛅ Weather in the cone

Tag a lantern for full weather (or use the default Sunwell Lantern) and the sky comes down with it:

• 🌧️ Rain falls through the whole lit pool and splashes where it lands — a light drizzle while it rains, a heavy downpour while it storms.
• ❄️ Snow in cold biomes drifts down and gradually piles up into snow layers on the floor, whitening the lit area over time.
• ⚡ Lightning strikes down the column in thunderstorms. It lands somewhere in the pool and leans toward the tallest target — a tree, a mob, a player — while staying random. A lightning rod anywhere in the pool catches it harmlessly and powers its redstone. Far more likely to strike near a rod.
  

🏷️ Tag-driven behavior

Every sunwell block needs #sunwell:sunwell_source. That alone is a static grow light — always-on virtual sky, no weather, no rain. Opt into more with extra tags:

The Sunwell Lantern ships with all four. Full weather presentation (sky-mirroring orb, rain/snow, snow buildup, lightning) needs both dynamic_exposure and rain_through.

📦 Register your own block (datapack & KubeJS)

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

ServerEvents.tags('block', event => {
  // static grow lamp
  event.add('sunwell:sunwell_source', 'yourmod:ceiling_lamp')

  // full treatment
  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)
})

⚙️ Full config reference

📦 Supported versions

Both builds are feature-complete — lantern, VFX, tag system and Amendments wall/hand-lantern compat. On 1.21.1 the datapack folders are singular (tags/block, recipe, loot_table).

📜 Credits & license

Sunwell is an original mod by SdataG — all code, models, textures and VFX authored for this project; no assets ported. The ceiling-skylight idea is familiar in modding (e.g. Ferreus Veritas's Skylight Lanterns); Sunwell is an independent reimplementation.