Iron's Spells: Light Pollution

Iron's Spells: Light Pollution

An addon for Iron's Spells 'n Spellbooks that brings astronomical phenomena, sword formations, magical domains and flight to Minecraft.

Summon a black hole, unfold a nebula, shelter your allies beneath the World Tree, or take to the sky with Astral Wings. Many spells draw their appearance from real celestial objects, with distinct casting sequences and ways to respond through distance, timing and positioning.

Explore the official Wiki · Browse spells and gameplay videos

The bilingual Wiki covers 48 spells, each with a real Minecraft gameplay video, alongside illustrated crafting recipes, material names and source mods, spell levels, mana costs and cooldowns. It also includes installation, equipment, flight and configuration guides, on desktop and mobile.

The videos were recorded in development builds without an external shader pack. The catalogue includes upcoming content, marked on its pages; check the version notes against your installed release.

Spells, flight and equipment

• Astronomical magic. Black holes, accretion disks, nebulae, stellar eruptions and quasar jets, with different sequences of attraction, sustained effects and final bursts.
• Sword formations and vortices. Nine Heavens Sword Art assembles layered formations and sends seeking volleys toward nearby enemies. Tornado, Waterspout and Water Tornado each have their own cloud and water structures.
• Domains and support. Shape a local battlefield with containment, suppression and allied bonuses. World Tree heals allies and grants absorption, with configurable protection against magic, projectiles and fire.
• Astral Wings. Take off, hover, turn, boost and descend with animated wings and matching player poses. Double-tap jump to take off; use jump and sneak to ascend and descend, and forward plus sprint to boost. Retracting the wings in midair begins a controlled landing.
• Magical equipment. Charge the Star-Magnet Bow through Magnetic Imbuement to fire arrows that form pulling singularities. Astral staves combine animated stellar materials with spellcasting bonuses.

Development previews

The Wiki also previews the next update:

• Tesseract Fold: a rotating hypercube that turns inside out, releasing three pulses and a final burst.
• Thunder Reprisal: a low storm ceiling, four waves of lightning and nine final bolts.
• Absolute Extinction: a celestial gateway, a stellar beam and a planet-fracturing detonation sequence.
• World-Devouring Celestial Dragon: a Chinese dragon passing through cosmic portals in a large-scale animated sequence.

Absolute Extinction and the dragon retain their visual effects and animation without changing actual terrain. Their planets, fractures and debris are visual elements; player buildings and world blocks are not destroyed by these sequences. The development update also refines Astral Wings' layered feathers, flapping and flight transitions.

Lighting and rendering

Real-time coloured spell lighting and ray-traced shadows, without requiring a shader pack.

• Spell light follows each effect's colour, brightness and phases, illuminating nearby terrain.
• A world-anchored 64×64×64-block volume supports shadow tracing at 1/8-block precision. Detailed openings in fences, trapdoors and iron bars contribute to light and shadow patterns.
• Soft shadows use multiple light samples, temporal accumulation and spatial filtering.
• Three-dimensional filaments, spherical bodies and volumetric effects give spells visible depth. Screen-space gravitational lensing bends the view of terrain and sky around black holes.
• Accretion flows, Doppler colour shifts, magnetic-field structures and jets draw on astronomical models to shape their motion and appearance.

Getting started and customisation

Craft scrolls, find them in supported structure loot, and inscribe them into spellbooks using Iron's usual systems. Scrolls support levels I–III: an amethyst shard upgrades I to II, and an echo shard upgrades II to III. The Wiki shows individual recipes with item textures; hover or tap a material to see its name and source mod.

Seven optional tooltip styles use each spell's colours. Select one with /lightpollution frame <style> or tooltipStyle; the vanilla tooltip is the default. Floating damage numbers are off by default, merge rapid hits on the same target, and can be enabled with /lightpollution damage on or floatingDamage.

Server settings control gameplay values such as damage, mana and cooldowns. Client settings control appearance and lighting. The Wiki explains their locations and available options.

Requirements and compatibility

• Minecraft 1.20.1, Forge 47.x.
• Iron's Spells 'n Spellbooks 1.20.1-3.16.1 or newer and Iron's Lib 1.20.1-1.1.0 or newer, with their required dependencies.
• Install Light Pollution and its required mods on both client and server.
• Includes Oculus shader-pack integration; see the Wiki for the tested setup and performance options.
• Dynamic spell lighting is independent of vanilla block light levels, so it does not change mob spawning conditions.
• In-game languages: English, Simplified Chinese and Literary Chinese. The Wiki supports English and Simplified Chinese.