
CogaCosmos
Space and celestial pieces: planets, stars, nebulae, galaxies, an observatory, glowing marble, alien plants, travel beacons, speed tunnels, gravity wells, utility beams and a prism light show. All generated by code, no asset files.Coga Cosmos
Space and celestial pieces for the hammer, in Valheim's own style: planets, stars, nebulae, galaxies, an observatory, glowing marble, and light that moves you around your base. Every piece is generated by code when the game starts: the package has no model or texture files (see How it's made below).
Cosmos tab
- Planet lamps: Terra, Gas Giant, Moon, Ember, Frost, Ocean, Dune and Toxic, each in normal, Large and Giant.
- Space objects: Orrery and Grand Orrery, Black Hole, Comet, Asteroid, Asteroid Belt, Meteorite, Spiral Galaxy, Binary Worlds.
- Cosmos Move (first entry): select it and click a Cosmos piece to pick it up and move it. See Building below.
- Light and decor: Star Canopy, Star Cluster, Aurora Curtain, Constellations, Amethyst Cluster, Frost Crystal Cluster, Sunstone Cluster, Armillary Sphere, World Map Table (a map of the world you are in), Living Constellation, Observer's Dais, Celestial Chandelier, Starfall, Nebula Rift (violet, blue, green, yellow or red; decoration only).
- Searchlight (Moonlight, Amber, Red, Orange, Gold, Green, Cyan, Blue, Violet, Pink): a crystal lamp sweeping a long cone of light, with a real spotlight.
- Bright Sun: a distant sun, a white-gold glowing ball in layers of light with turning corona rays. Lights up its surroundings.
- Fiery Sun: a burning sun wrapped in licking flames, with flame jets and flying embers.
- Polychrome: a crystal prism that puts on a light show. Sixteen club and cosmic scenes cycle on their own, crossfading between them: Spectrum Sweep, Mirror Ball, Scanner (which locks onto the nearest player within 30 m), Chase, Lighthouse (two beams sweeping the horizon), Laser Grid, Aurora, Heartbeat, Twin Rotors, Spiral Galaxy, Sunrise, Colour Pop, Fireworks, Pendulum Wave, Breathing Prism and Nebula Wash. The prism turns to steer the light, wearing a crown of rainbow crystal shards. Everyone sees the same scene at the same moment. Hover it to see what is playing. Press E to lock it to the scene you like (Alt+E goes back), and press it until it says Auto to let it cycle again.
- Laser Link (Red, Green, Cyan, Violet): a crystal node that draws a laser to the nearest node of the same colour within 30 m.
Cosmos Utility tab
Pieces that do something. Beams change height with Shift + [ / ] (only the column stretches, and the effect follows it).
- Light Beacon (Gold, Azure, Violet, Emerald): a crystal pedestal with a pillar of light. Press E to travel to the next beacon of the same colour within range; Shift+E names it (beacons are visited in name order). Each colour is its own network. Everything can travel, ores included. You arrive on the small glowing ring in front of the beacon, facing the way its arrows point.
- Hyperlight Tunnel (Cyan, Violet, Gold): a 4 m tube of light you walk through. Run the way its spiral of light races and you go faster. Segments snap end to end into one continuous spiral.
- Gravity Well (Azure, Violet, Emerald): a 12 m beam of low gravity. Float up like in water; Jump rises faster, Crouch sinks, and you steer freely. No fall damage for a moment after you leave. A spiral of light climbs the column.
- Slowfall Well (Null, Dusk, Ash): a 12 m column of nullified gravity. Inside it you fall slowly, like wearing a feather cape; Crouch drops at normal speed. A pale spiral and "minus" marks sink slowly down it.
- Clearlight Beam (Pale, Azure, Violet): clears the Mistlands mist around it, like a Wisp light (it uses the game's own mist clearing).
- Warmth Beam (Amber, Rose, Gold): within 5 m you stay warm, like by a fire. Keeps Cold and Freezing away. It does not count as a fire for resting.
- Launch Pad (Lime, Azure, Rose): stand on it and jump about five times higher, with no fall damage for a few seconds after.
- Hard-light Bridge (Cyan, Gold, Violet): a 2 x 4 m slab of solid light you can walk on; snaps end to end and side by side.
Cosmos Celestial tab
Valheim's black-marble building set in four glowing styles: Star-veined, Starfield (twinkling), Pulsing and Aurora. Each style has all 16 shapes: Floor 2x2, Floor Triangle, Floor Tile 1x1, Floor 8x8, Wall 2x2, Wall 2x4, Block 1x1, Block 2x1, Block 2x2, Column, Column Wide, Arch, Stair, Slope 1x2, Plinth and Cornice (for example Aurora Wall 2x4). They snap, support and break like vanilla black marble.
Also here: the Planetarium Floor (a 6 m disc with a star map), the Star-veined Pillar and the Star-veined Floor Tile.
Cosmos Observatory tab
Twelve skies each: Rose Nebula, Teal Nebula, Gold Nebula, Gaseous Clouds, Aurora, Black Starfield, Galaxy Core (a spiral galaxy overhead whose glow breathes), Milky Way, Twilight (a warm glowing horizon), Star Nursery (two nebulae mixing, with drifting dust), Cosmic Storm (lightning flashes) and Deep Field (distant galaxies). Inside a dome the sky slowly wheels overhead, and some skies have shooting stars.
- Sky Dome (8 m) and Small Sky Dome (4 m): domes on a 2 m drum that you walk inside (about 6 m and 4 m tall). Dark worked iron on the outside, scattered with twinkling starlight; open sky on the inside. They snap onto the wall tops of an 8 x 8 or 4 x 4 room.
- Sky Ceiling (4 x 4 m) and Small Sky Ceiling (2 x 2 m): panels of sky facing down that snap like floors. Snap them under a roof: from inside you see the sky, from above they are invisible, so your roof looks normal from outside.
For a real open sky: the Open Dome Frame (8 m of iron ribs with a bronze rim and crown, nothing between them) and the Oculus Roof (an 8 x 8 m walkable marble roof with a round opening; leave it open or put a Sky Ceiling under it). Both snap onto wall tops.
- Telescope (Bronze, Celestial): a telescope on a bronze tripod, slowly tracking across the sky.
Structure and instruments, all in dark iron and worn bronze:
- Slit Dome: the classic observatory dome, iron with an open slit you see the real sky through. It slowly turns.
- Round Tower Wall: curved 2 m iron walls; eight make a round tower 8 m across for a dome to sit on.
- Spiral Staircase: one turn of iron steps, 4 m up, with a bronze handrail.
- Bronze Railing (straight 2 m, and curved for a round tower top).
- Constellation Window (one for each constellation): a 2 x 2 m iron-framed window of dark glass with the constellation glowing in it.
- Zodiac Floor: a 4 x 4 m iron floor with an inlaid bronze zodiac ring and compass rose.
- Great Telescope: a 6 m refractor on an iron pier, slowly turning and nodding.
- Astronomical Clock: a working 24-hour clock whose sun hand shows the real time of day; hover it for the day and time.
- Celestial Globe: a turning star globe on a bronze stand.
- Astronomer's Desk: a wooden desk with a star chart, a turning astrolabe and a candle.
Snapping big pieces: while placing, press Q / E to choose which of the piece's snap points follows your cursor (a vanilla feature). Put a dome's corner on your cursor and aim at a wall's top corner.
Cosmos Starlight tab
- Stars: Twinkling Star, Four-Point Star, Eight-Point Star, Pulsar, Binary Stars, Star Burst and Shooting Stars, each in 7 colours: White, Ice Blue, Gold, Rose, Violet, Ember Red and Emerald (for example Pulsar (Ice Blue)).
- Starry waterfalls: Starry Waterfall, Golden Falls, Aurora Falls, Tiered Star Cascade and Spiral Star Falls.
- Nebulae: Nebula Cloud, Nebula Pillars, Ring Nebula, Nebula Veil and Star Nursery, each in 5 palettes: Rose & Violet, Teal & Blue, Amber & Gold, Emerald & Aqua and Crimson & Orange.
- Constellations: a floating chart for each of Orion, the Big Dipper, Cassiopeia, Cygnus, Scorpius, Leo, Lyra and the Southern Cross, plus a Night Sky Ceiling and a Milky Way Band to hang overhead.
Cosmos Deep Space tab
- Asteroid fields: Drifting Asteroids, Burning Asteroids, Frozen Asteroids, Shattered Moon, and plain Asteroids with no burning rocks (Grey Dust, Violet Dust, Bare).
- Meteors: Fiery Meteor, Fireball, Green Fire Meteor, Blue Ice Meteor, Meteor Shower.
- Supernovae: Supernova, Blue Hypernova and Crimson Nova (each swells, bursts and leaves a nebula, on a loop everyone sees in sync), plus a Planetary Nebula.
- Galaxies: Grand Spiral Galaxy, Barred Spiral Galaxy, Starburst Galaxy, Colliding Galaxies.
- Quasar, Blazar, Magnetar, Einstein Ring, Einstein Cross, Lensing Arcs.
Cosmos Flora tab
Glowing interstellar plants for building "galaxy zone" gardens. Each comes in three palettes: Azure, Violet and Aurora (for example Orbweed (Violet)).
- Starbloom: a flower whose crystal petals slowly open and close, shedding glowing pollen.
- Lumen Reeds: a tuft of swaying glowing reeds with sparks at their tips.
- Void Mushrooms: mushrooms with glowing, light-speckled caps, breathing out spores.
- Orbweed: tall swaying stalks, each holding a bobbing orb of light.
- Starfruit Shrub: a bush of crystal leaves hung with glowing fruit, with fireflies.
- Starvines: hang them from a ceiling: swaying strands of crystal leaves with glowing berries.
- Comet Willow: a small tree with weeping crystal strands, dripping starlight.
- Galaxy Tree: a tree with a slowly turning spiral galaxy for a canopy.
Starlight, Deep Space and Flora pieces are made of light, gas and leaves, so you can walk through them.
Building
-
Costs use vanilla materials: marble pieces take Black Marble and Crystal, planets take Surtling Cores and Greydwarf Eyes, starlight takes Greydwarf Eyes and Crystal, plants take Thistle, Blue Mushrooms, Resin or Finewood with Crystal, and brass fixtures add Bronze. A piece shows up in the hammer once you have found every material it needs.
-
Placing: a piece stands where you aim. Floating pieces (lamps, stars, nebulae, suns) rest on the surface instead of sinking into it: on top of the ground, under a ceiling, off a wall. Hold Left Shift to place exactly where you aim. While placing you see the finished piece as a steady hologram, light effects and all.
-
Resize: aim at a Cosmos piece and press ] to grow it or [ to shrink it. The size is saved and everyone sees it. However big a piece gets, its handle (what you aim at to remove, resize or move it) keeps its size and place, so a giant nebula does not get in the way of building around it. With the hammer out, handles are outlined: faint cyan nearby, gold for the one you are aiming at.
-
Move: pick Cosmos Move (the first entry on the Cosmos hammer tab) and left-click a Cosmos piece to pick it up, or press T while aiming at one with the hammer. It follows your crosshair at its current size, on the ground, on floors or under ceilings. While carrying it:
- Scroll (or , and .) turns it 15°.
- Shift + scroll (or Page Up / Page Down) raises or lowers it 0.25 m.
- Arrow keys nudge it 0.1 m for exact placement.
- Ctrl makes any step fine (1°, 0.02 m, 0.025 m), and holding a key repeats it.
- If you use the Gizmo mod, it pauses while you carry a piece, so the two never fight over the scroll wheel.
- Left click puts it down. Backspace puts it back where it was. While Cosmos Move is selected, clicking never places anything.
You can't put a piece down inside someone else's ward, and everyone sees it move.
Install
Every player and the server need it. If the server does not have it, the Cosmos tabs are hidden: nothing can be placed and lost, and you can still join that server. If the server runs an older version, only the pieces it has are shown, so newer pieces cannot be placed there and lost either.
- Players: install it with Gale, r2modman or the Thunderstore Mod Manager. Jötunn is installed with it.
- Dedicated server: install it the same way, or copy
plugins\CogaCosmos.dllinto the server'sBepInEx\plugins\folder and restart the server. Its log should showCoga Cosmos 0.5.0 loaded (headless server: tiny textures).
Settings
The config file is BepInEx\config\com.c0ga.cosmos.cfg. Settings marked server are set by the server (or whoever hosts) and apply to everyone.
| Setting | Default | What it does |
|---|---|---|
Light Beacons.MaxRange (server) |
150 | How far apart two beacons of one colour can be and still link, in metres (5–500). Keeps beacons a base tool rather than a portal replacement. |
Hyperlight Tunnels.SpeedBonusPercent (server) |
50 | Extra speed while running with a tunnel's flow (0–200 %). |
Gravity Wells.RiseSpeed (server) |
2.5 | How fast you drift up in a gravity well, in m/s (0.5–8). |
Launch Pads.JumpBoost (server) |
2.2 | Jump strength on a launch pad, as a multiple of a normal jump (1–4). |
Searchlights.BeamLength / TiltDegrees / SweepSeconds / ConeWidth (server) |
24 / 38 / 16 / 4 | How far the beam reaches (m), how high it points (degrees), seconds per sweep (0 = still), and the cone's width (m). Changes apply live. |
Searchlights.SpotRange / SpotAngle / SpotIntensity (server) |
40 / 14 / 2.2 | The light it actually casts on the world: reach (m), spread (degrees), brightness. |
Slowfall Wells.FallSpeed (server) |
2 | The fastest you fall inside a slowfall well, in m/s (0.5–6). |
Resize.GrowKey / ShrinkKey |
] / [ |
The resize keys. |
Resize.KeepAimSize |
true | Grown pieces keep their original-size aiming shape, in the same place. Off = the aiming shape grows with the piece. |
Placing.RestOnSurface |
true | Floating pieces are placed resting on the surface you aim at instead of half sinking into it. Hold Left Shift to place exactly at the aim point. |
Polychrome.SceneSeconds / FadeSeconds (server) |
20 / 1.5 | How long each light-show scene runs while Polychrome is on Auto, and the crossfade between scenes, in seconds. Set by the server so everyone stays in step. Anyone can still press E on a Polychrome to lock it to a scene. |
Accessibility.CalmLights |
false | Removes flashing for your own game: no lightning in the Cosmic Storm sky, much dimmer supernova and beacon-travel flashes, and Polychrome's pulsing scenes become a slow breath. |
Resize.ShowHandles |
true | With the hammer out, outline nearby pieces' aiming shapes (cyan; gold under the crosshair). Only you see it. |
Moving.MoveKey / CancelKey |
T / Backspace |
Pick up a piece (hammer equipped), and put a carried piece back. |
Moving.TurnLeftKey / TurnRightKey / UpKey / DownKey |
, / . / PageUp / PageDown |
Turn and raise or lower while moving. |
Moving.TurnStep, FineTurnStep, HeightStep, FineHeightStep, NudgeStep |
15, 1, 0.25, 0.02, 0.1 | Step sizes while moving (degrees and metres). |
Moving.MaxReach (server) |
30 | How far from you a moved piece can be put down, in metres (5–60). |
Safety.AllowOnRemoteServers |
false | Not needed on a server that has this mod: the tabs turn on by themselves there. Turning this on forces them on even when the server does not have the mod, and that server would delete any pieces you place. |
How it's made
Cosmos ships no models and no textures. Everything is built by code while the game loads, and every random choice comes from a fixed seed, so every player sees exactly the same piece.
- Planets are painted pixel by pixel from gradient noise sampled on a sphere, so there is no seam and no pinch at the poles. The ball they are wrapped on is built from the same maths, so texture and mesh line up by construction.
- Stars, nebulae, starfalls, galaxies and supernovae are particle systems laid out by code. Some are fixed star fields placed one star at a time, others are emitters shaped into spirals, rings and falls.
- Sky domes are painted by direction rather than by texture coordinates, so the same function paints a seamless dome and a flat ceiling. Nebula clouds, the Milky Way, aurorae and distant galaxies are layered noise.
- Plants grow:
- Stems bend along curved paths.
- Trees branch recursively, with the outer twigs weeping the most.
- Willow strands continue from the tips of real twigs.
- The Shattered Moon is a sphere broken into plates around scattered seed points, given thickness, with a molten core showing through the cracks.
- Observatory pieces (domes, curved walls, stairs, railings, the clock face and the zodiac inlay) are generated meshes and textures, dressed in Valheim's own iron, bronze and wood materials so they get its lighting, wetness and snow.
- Motion is clock-driven: orbits, sweeps, twinkles, the Polychrome show and supernova bursts all run from the world clock, so everyone sees the same moment without the server sending anything extra.
About this mod
-
No asset files. Planets, stars, nebulae, runes and their textures are generated by code when the game starts. The glowing marble pieces use Valheim's own black-marble pieces and materials, read from the game at runtime. No game files or other mods' assets are included in this package.
-
Networking. When you join, the game asks the server whether it has this mod, and the server answers with the list of Cosmos piece names it has (so a newer client never places a piece an older server would delete). Beyond that, everything goes through Valheim's normal world data: piece sizes, beacon names and beacon flares are saved with the world like any other piece state. The server settings above are synced from the server through Jötunn. Nothing is sent anywhere outside the game.
-
Compatibility. Two small Harmony patches on the game:
- A prefix on
Player.UpdatePlacementthat only pauses while you are carrying a Cosmos piece in move mode (or have Cosmos Move selected), so the hammer does not also place, turn or remove. - A postfix on
Player.UpdatePlacementGhostthat lifts a floating Cosmos piece's preview off the surface you aim at. It never touches other pieces, snapped placements, or placements with Left Shift held.
If the Gizmo mod is installed, its placement hook pauses while you carry a piece. Hammer removal is plain vanilla. Otherwise vanilla and other mods run as normal.
- A prefix on
-
Made with AI assistance. The code was written with Claude, an AI assistant, and tested in game by the author and their friends.
-
Source and bugs. The source code is not public yet. Report problems on the Thunderstore page.
Light sensitivity
Cosmos is full of moving, glowing light, so here is what we did about flashing. Nothing flashes faster than about once a second. Every change in brightness eases in and out rather than switching on and off. Nothing strobes white or saturated red, and effects that fill your view (the Cosmic Storm sky inside a dome, the fade when a Light Beacon moves you) are soft swells.
If bright or changing light bothers you, turn on Accessibility.CalmLights. It only changes your own game, so you can use it on any server without affecting anyone else. Please look after yourself, and take a break if anything feels uncomfortable.
Thank you
If you're reading this, thank you. Cosmos started as a few planet lamps for a group of friends, and grew because we kept wanting to see what else we could build: domes you can stand under, beams you can float in, a light show in a prism. We have had a lot of fun learning how Valheim works along the way, and we hope you have as much fun building with it as we had making it.
If the server removes it
Valheim deletes objects it cannot load. A dedicated server only builds objects around the world's starting area, so Cosmos pieces there would be lost. Pieces elsewhere are kept and just turn invisible until Cosmos is back.