Docs

Celestial Bodies

The Sun, every planet, the Moon, Pluto and five seeded fictional worlds at true scale in Unreal Engine: displaced terrain, a 64K Earth with volumetric clouds, sky atmospheres, rings, star fields, Sequencer shots and a flyable descent from orbit to the ground. For Unreal Engine 5.6, 5.7 and 5.8.

Earth from orbit at the terminator: clouds over Europe and Africa, city lights on the night side
In five minutes: enable Exaro Celestial Bodies in Edit → Plugins, turn on Show Plugin Content in the Content Browser's settings, open ExaroCelestial Content/Maps/L_SolarSystem and press Play. Fly with the mouse and W A S D; the number keys switch demo levels. Everything below is detail.

1. Install

Celestial Bodies is one Unreal code plugin, ExaroCelestial, with its C++ source and all of its content inside it (levels, Blueprints, materials, meshes, textures and sequences). It needs no other plugin.

  • From Fab: install the plugin to your engine (5.6, 5.7 or 5.8) from the Epic Games Launcher, then enable it in a project under Edit → Plugins and restart the editor.
  • From the Exaro store: one zip holds the ExaroCelestial plugin (content saved in 5.6, so 5.7 and 5.8 open it too) and a Binaries for UE 5.x folder per engine. Copy ExaroCelestial into your project's Plugins folder (create it next to your .uproject file if it is not there), copy the Binaries folder for your engine into it, then open the project.

The content is under the plugin's mount point, /ExaroCelestial: in the Content Browser it appears as ExaroCelestial Content once Show Plugin Content is on. Place the Blueprints in your own levels or open the demo levels directly; nothing has to be copied into your Content folder.

Tested on Windows (DirectX 12); the C++ module is built for Win64. With Visual Studio installed you can also let Unreal build the plugin from its source: leave out the Binaries folder and open the project.

Three project settings matter. New projects have the first one already; the Exaro zip's INSTALL.txt has the same list.

  • Project Settings → Platforms → Windows → D3D12 Targeted Shader Formats includes SM6. Without it, Nanite draws every planet as a coarse polygon.
  • Project Settings → Engine → Rendering → Virtual Textures is on. Maps above 16K (Earth's 64K surface, its 32K clouds and night lights) only load as virtual textures.
  • Nanite is on (it is by default). Terrain relief has real height when you fly low: Earth's mesh is built from its measured height map, and the Moon, Mercury and Pluto use Nanite tessellation.

The plugin's content is about 6 GB, most of it Earth. Content is sorted by asset type (Blueprints, Maps, Materials, Meshes, Sequences, Textures), each with a folder per body. To drop a body you do not need, delete its folder inMaterials, Meshes and Textures along with its Blueprint and map.

2. The demo levels

Open any map in ExaroCelestial Content/Maps. Three are made to play; five hold a finished Sequencer shot; the rest show one body each.

MapWhat it shows
L_SolarSystemThe Sun and every planet lined up at compressed distances but true sizes and tilts. Press Play and fly between them.
L_AtmosphericEntryEarth and the Moon. Dive into Earth: plasma glow on the way in, then volumetric clouds and streamed satellite imagery near the ground.
L_NewWorldsThe five fictional worlds side by side: an ocean world, a desert world, an ice world, a volcanic world and a warm gas giant.
L_EarthMoon, L_EarthSunrise, L_EarthEntry, L_MoonPass, L_SaturnFlybyCinematic shots. Open the level sequence in ExaroCelestial Content/Sequences to play or render it.
L_Earth, L_Mars, L_Saturn and the restOne body each, lit, to look at before you use it.
Earth in the foreground with Mars, Jupiter, Saturn and its rings, Uranus and Neptune beyond
SolarSystem from Earth: Mars, Jupiter, Saturn, Uranus and Neptune beyond, every one at its true size.

In the playable levels:

  • Mouse looks, W A S D fly, Space and Ctrl rise and sink, Q and E roll.
  • Speed follows your height above the nearest body: fast between planets, slow near the ground. The mouse wheel scales it.
  • The number keys 1, 2, 3 open the demo levels; Esc quits a packaged game.

3. Put a body in your level

Every body is a Blueprint in ExaroCelestial Content/Blueprints: BP_Earth, BP_Mars, BP_Saturn and the rest, each one Exaro Celestial Body actor carrying its meshes, materials, texture sets and sky atmosphere.

  1. Drag the body's Blueprint into your level and move it where you want it.
  2. For light, drag in BP_SunLight (a directional light set up for space: per-pixel atmosphere transmittance and cloud shadows) and rotate it. A body with no Sun set finds the level's sun light by itself, so its night side, ring shadows and cloud shadows follow the light with nothing to wire.
  3. For a sky, drag in BP_StarDome: the 16K star field and Milky Way, with brightness and rotation in its Details panel.

Bodies are true size: Earth is 6,371 km across its radius, so a camera that sees the whole planet sits thousands of kilometres away. Unreal's large-world coordinates handle this; keep everything within about 40 million km of the origin.

Unreal draws one sky atmosphere per level. If you place two bodies that both have air (Earth and Mars, say), untick Use Atmosphere on all but the one the camera gets close to. Unreal also caps an atmosphere at 10,000 km, so the gas giants use a glow in their material instead.

4. Change the look

Select a body and open the Celestial → Look sections in the Details panel. Every value is keyable in Sequencer. The ones you will use most:

SettingWhat it does
Day Gain, Colour GainBrightness of the daylit surface.
Relief StrengthHow strongly the surface's relief catches light (0 flat, 1 as measured).
Ocean Roughness, Ocean SpecularThe sun glint on open water.
Night Intensity, Night Tint, Night SharpnessCity lights (or lava glow) on the night side, and how sharply they fade in past the terminator.
Cloud Opacity, Cloud Shadow, Cloud BrightnessHow much cloud, how dark its shadows on the ground and how bright it is in sunlight.
Cloud Forward Scatter, Cloud Scatter GThe silver lining on cloud edges with the sun behind them.
Ring Shadow, Ring Forward ScatterThe rings' shadow on the planet and their glow seen from the unlit side.
Brightness, Granule Speed, Corona IntensityThe Sun's surface, its boiling granulation and its corona.
Atmosphere HazeHow much the air hazes the surface seen through it.
Saturn with its rings casting a shadow across the planet
Ring shadows and the planet's shadow on the rings follow the Sun.

5. Texture resolution

Celestial → Resolution → Texture Resolution switches a body between the texture sets it ships with, from 2K up to 64K for Earth. Higher looks sharper close up and costs memory; a missing tier falls back to the next one down. Large maps stream as virtual textures, so only the parts on screen are loaded.

6. Spin, tilt and time

  • Axial Tilt Deg leans the pole; every body ships with its real tilt.
  • Rotation Period Hours turns the body in play; Time Scale speeds the clock up (3,600 is one hour a second).
  • Spin Deg and Shell Drift Deg set the turn and the cloud drift by hand. Key them in Sequencer for a shot.

7. Stars

The Exaro Star Dome actor draws the star field and the band of the galaxy behind everything. Set Intensity to taste (stars are faint next to a sunlit planet, as a real camera sees them) and turn the sky with Yaw Deg and Pitch Deg. The star fields are generated, so you can use them anywhere.

8. Flying, entry and close-up ground

Set your level's GameMode Override to Exaro Space Game Mode to fly with the Exaro Space Fly Pawn, or use the pawn's settings as a starting point for your own. On the pawn, Speed Per Height, Floor Km and Buffet Deg set how fast it flies, how low it can go and how hard re-entry shakes the camera.

The edges of the view glowing orange and pink with plasma during a descent through Earth's upper atmosphere
Coming in fast: the plasma glow builds between about 120 and 35 km and fades as the craft slows.

Re-entry. Earth's Celestial → Entry section holds the post-process material a descending camera wears, the heights where heating starts and ends, and the speed that gives full heat. Clear Entry Material to switch the effect off.

Streamed ground imagery. Below 200 km, Earth can download sharper satellite imagery for the ground under the camera and blend it over its own map. The default source is NASA's Landsat mosaic: public domain, cloud-free and about 30 m a pixel, against about 600 m for the 64K map. Settings are on the body's Imagery component:

  • Enabled turns streaming on or off.
  • Tile Url is the imagery server (any WMTS server in geographic tiling; use only imagery you have the right to use).
  • Start Km, Max Level and Grid set where streaming starts, the finest detail and the size of the sharp patch.

Streaming needs an internet connection; without one, the body keeps its own maps. Open water always uses the body's own map, because the satellite mosaic has no data over the sea.

Alpine valleys with fields and villages under snow-capped peaks, seen from 8 km
The Alps from 8 km with streamed imagery on displaced terrain.

9. Fictional worlds

The five worlds in NewWorlds are made from a seed: terrain, oceans, colour and clouds all come from numbers, so none of them is a real place. Use them as they are, or copy one into your level and change its look settings to make it your own.

A fictional ocean world with green continents and swirling cloud
KeplerTerra, one of the five fictional worlds.

10. Rendering shots

The five cinematic maps each have a level sequence in ExaroCelestial Content/Sequences. Open one and press Play in Sequencer, or render it with Window → Cinematics → Movie Render Queue. Give Movie Render Queue a few warm-up frames (Anti-aliasing → Engine Warm Up Count, 64 is plenty) so virtual textures and Nanite stream in before the first frame you keep.

11. Credits and licences

Real bodies use public-domain maps from NASA, USGS and NOAA. The star fields, the Sun, Saturn's rings, the cloud layers of Venus, Saturn, Uranus and Neptune, Pluto's colour and all five fictional worlds are generated by Exaro. You may ship all of it in your games and films. The sources (also in CREDITS.txt in the Exaro zip):

  • Moon: NASA's Scientific Visualization Studio, CGI Moon Kit; LRO LROC WAC (NASA/GSFC/Arizona State University) and LOLA data.
  • Earth: NASA Earth Observatory (Blue Marble Next Generation by Reto Stockli, NASA GSFC; Black Marble 2016 by Joshua Stevens; cloud composite).
  • Jupiter: NASA/JPL/Space Science Institute (PIA07782).
  • Mars, Mercury, Venus, Pluto (mosaics and elevation): U.S. Geological Survey Astrogeology Science Center; NASA PDS. Pluto: NASA/JHUAPL/SwRI/LPI (New Horizons Team).
  • Earth relief: ETOPO1, NOAA NGDC (Amante & Eakins 2009, NOAA TM NESDIS NGDC-24).
  • Water mask: Made with Natural Earth. Free vector and raster map data @ naturalearthdata.com.
  • Streamed at runtime (optional, not packaged): NASA GIBS, Landsat WELD annual true-colour mosaic (USGS/NASA; Roy et al. 2010). Any other WMTS server you set must be one you have rights to.
  • Generated by Exaro: star field and galactic band, Saturn/Uranus/Neptune/Venus cloud maps, Saturn's rings, the Sun, fictional worlds, Pluto colour, filled polar and unimaged regions.

Exaro Celestial Bodies is not affiliated with or endorsed by NASA, ESA, USGS or NOAA.