Description
Cosmic Breach
Something fell from the sky last night. It is still humming, and it wants to go home.
Free to play, include in modpacks (link to this page, don't re-upload), and make videos and streams, monetized ones included.
Cosmic Breach is an action-RPG dimension mod for NeoForge 1.21.1. On your first night a star falls near you. Build a ring of copper around it, step into the hole it opens, and fall up into Aetheria: a shattered sky realm stacked in four levels, four bosses, from sunlit islands down to a black void with the Breach itself at the bottom. The combat is rebuilt for it: committed attacks, dashes with invulnerability, parries, and telegraphs you can read.
Getting there (about 20 minutes into a new world)
- The Starfall. At your first sunset a Starfall Shard streaks across the sky and lands nearby under a beam of light. Break it by hand and you get the Starfall Codex, the in-game guide, open at "Build a ring".
- The Breach Ring. Eight frames of copper and stone, laid flat in a ring. Use the shard on it and the ground opens onto a sky. Step in and fall up.
- Fallen Rifts. Small meteor craters in the Overworld hold a half-buried ring and a chest.
No iron, no diamonds, no rare drops: any seed gets you there.
Level 1: the Upper Reach
Floating islands in full daylight under a ringed gas giant. Shattered Spires, Sunfield Terraces, and herds of Lumen Stags that you can tame, saddle and ride. Shardlings, crystal pack hunters, are meant to be hard with a vanilla sword.
Spire Reliquaries: hollow spires with Shardling dens on the climb and a Lens Array at the top, a puzzle of mirrors, splitter prisms and sunlight. Light every crystal with its own colour and the vault opens.
Boss: the Prism Colossus. A crystal giant fused into the pillar at the top of the Crown Spire. Parry its Prism Slam, dash through its Facet Sweep, and turn the crown crystals to bounce its own laser back into its core. At zero health it shatters into three shards that you have to kill fast.
Level 2: the Drift
Asteroid belts drifting under a starry sky, with open lanes between them. Your weight thins here: everything falls at less than half speed, you jump higher, and the gaps become part of the fight. Tame a Drift Manta, a stingray the size of a boat that flies, by answering its song with a Resonance Chime, then ride it across the gaps. Level 2 feeds you as well: Manta Fillets, Starhide, Rimeglass and Nebulite.
Gyre Observatories: watchtowers grown through asteroids, with gravity lifts instead of stairs, near-invisible Kinetic Tripwires that fire if you cross them faster than a walk, and a Gyre Knight at the top: a flying suit of armour with three blades orbiting on spinning rings.
Boss: the Thalassine Leviathan. A sky whale as long as a river, circling inside its Rift. Its song tells you what it will do next: breach dives along a glowing wake, a pulling song, and a moment when it moors itself round the central stone and you can leap onto its back to strike its song glands. If you fall below its arena, the air under it catches you and lifts you back up.
Level 3: the Deep
The bottom of Aetheria and the only dark place in it: black arches and needles of Umbral Basalt over a void that does not give back what falls in. Light comes from magenta and teal Neon Lichen and from what you bring, so bring torches. Four zones, each with its own ground and coloured air: the Spans, the Lichen Gardens, the Hanging Wood and the Shattered Field.
- Hollow Stalkers: thin void shapes in porcelain masks. They travel through darkness, prefer your back, and freeze when you look at them. A torch is a wall to them.
- Drift Jellies: gentle three-block bells you can bounce on, higher than a slime block.
- Eclipsium Ore for the forge's third tier, and Umbral Caps to eat.
- Hollow Crypts: labyrinths of a dozen rooms over two or three levels, with traps that answer to how you move (vanishing void tiles, crushing gravity plates, tripwires), a Choir Floor music puzzle and a vault at the heart. Since 1.2.3 the Choir Floor takes your answer at any pace: step on the pads in the order the statue sang them.
Boss: the Unsung. Three porcelain masks, Alto, Tenor and Bass, sharing one life and singing one song that never ends. Only the singing mask can be hurt, and the song passes between them every eight beats. Alto's notes follow you, Tenor sweeps the floor, Bass throws you back, and when all three harmonize only the circles of silence on the floor will save you. Everything lands on the beat, so keep your Music volume up.
Level 4: the Breach Sanctum
At the centre of the Deep the Breach itself opens, three hundred blocks across, and the Choir's last hall floats over it. Beat the Unsung and its gate opens for you and your party. Solve both wings of the antechamber (the greatest Lens Array, and the hardest Choir Floor), forge the Dying Star Heart, and set it on the empty throne.
Final boss: the Hollow Heliarch. A ring of armoured plates round a burning core, with two great hands. As Regent it fights with the sun it remembers: parry the gold ring, jump the fire band, step aside from the locked red line. Hollowed, its plates stand in the arena as monoliths, its core becomes an eclipse out of reach, and you fight its tendrils while hiding from the beam. Break its Nova shield before the light fills, then survive the Collapse as the floor falls away into the Breach. Each player opens their own Reliquary at the end.
The Astral Forge and gear
One crafting station that tiers up as you beat each boss. The forge screen has tabs for weapons, armour, tools, mount gear and other, and full tooltips on everything. The forge accepts level materials in place of overworld ones, so you never have to go back to the Overworld for food, leather, string or tools.
- Weapons, each adding a verb to how you fight, all reforgeable to the fourth tier: Meridian (starsteel blade), Comet Maul (a greathammer that doesn't flinch), Binary Edges (twin sickles with a thrown tether), Choir Astrolabe (star bolts that link foes into a constellation), and from the final boss, Last Light (a solar glaive that parries everything for a moment) and Umbra Cantor (a longbow whose notes form silencing chords).
- Armour sets with two- and four-piece bonuses and a set ability: Starfall Vanguard (falling becomes a weapon), Driftweave (extra dashes and afterimages), Choir Regalia (abilities that echo).
- Accessories: two rings, a necklace and a charm, from vaults and bosses.
- Familiars: hatch a Star Egg from a vault into an Emberwisp, a Gravikin or a Prism Moth that fights beside you from its lantern.
Combat and systems
- Dash (Left Alt) with invulnerability frames. Parry (V) anything that glints gold.
- Resonance fills as you fight and powers your weapon. The world is the meter: your blade and armour glow instead of the HUD filling with bars.
- Attunement (K): level up, spend stat points across four virtues, unlock tiers.
- Set abilities (Z) on armour sets.
- Mounts: the Stable Crystal stows a tamed mount with everything on it and sets it down again where you want it.
- Every boss speaks, with on-screen captions. They react to how you fight.
- A shrine at every boss. Right-click one to save your place. While a shrine is your respawn, dying in the mod's levels keeps your inventory and experience. A golden current beside it carries you back up a level.
- Cosmic weather: Solar Flares, Meteor Showers and Gravity Tides, each with a warning first.
- The Codex finds things: sneak and use it to point at the nearest boss you haven't beaten; use it again to point at the nearest unsolved puzzle room.
All keys can be changed under Options, Controls, Key Binds, "Cosmic Breach".
Multiplayer
Built for co-op and tested on a dedicated server. Loot, XP and attunement are per player, so nobody fights over drops, every vault opens once for each player, and boss health scales with the number of players.
Servers: set allow-flight=true in server.properties. The mod's movement (dashes, mounts, the fall up through the ring) can look like flying to vanilla's anti-fly check, and without the setting players get kicked. Everyone on a server, and the server, needs the same version.
Requirements
Required mods (the CurseForge app installs them for you):
- GeckoLib
- Curios API
- GuideME
- playerAnimator
NeoForge 21.1.252 or newer on Minecraft 1.21.1, Java 21. Needed on both client and server.
Known to work with Sodium, and Better Combat with Combat Roll. A shader pack changes how some places look, so play with shaders off for the intended look.
Practice arena: with cheats on, /cosmicbreach sandbox builds an arena in the sky above you and sends waves at you. It moves your spawn and turns on keepInventory, so try it in a spare world.
How it was made
Cosmic Breach was built by Claude Opus 5.5 in Claude Code: the design document, the code, the textures, the models and animations, the boss AI, and a hidden test client that played the mod and checked its own screenshots. Nate gave it the idea, played it with friends, and steered every release.
Textures, models and most of the sound and music are generated by code in the repository. Voice lines were made with ElevenLabs v4, and some sound effects with ElevenLabs (elevenlabs.io), under a paid plan with a commercial licence. Voices by ElevenLabs. Full credits are in CREDITS.md, inside the jar and in the source repository.
Licence and permissions
- Free to play, include in modpacks (link to this page, don't re-upload), and make videos and streams, monetized ones included.
- Code: MIT.
- Assets (textures, models, animations, sounds, music, text): All Rights Reserved. Please don't re-upload them, redistribute them outside modpacks, or sell them.
- Excluded from the MIT grant: the ElevenLabs audio (credited, covered by ElevenLabs' terms) and one modified Minecraft shader file, which stays under Mojang's terms.
Full text: https://github.com/CalmDownNova/cosmic-breach/blob/main/LICENSE
Minecraft is a trademark of Mojang Studios. This is not an official Minecraft product and is not approved by or associated with Mojang or Microsoft.




