04Coming soon

Procedural Black Hole

A procedural black hole for Unity (URP and HDRP): the shadow, the accretion disk seen over and under it, the photon ring, Doppler shift and jets, in six presets and one component. Every seed gives the disk a pattern of its own; presets are editable and you can make your own.

The background is not distorted: the hole does not bend the sky or the scene behind it.

Unity 6.3 LTS or newer · URP and HDRP · Version 1.0.0

A black hole with a tilted accretion disk and a photon ring

What it is

Procedural Black Hole draws a black hole in real time: the round shadow, the accretion disk seen directly and as the image bent over and under the shadow, the photon ring, Doppler brightening and redshift, a halo and, on two looks, jets. The preset sets the design of the look, the seed generates the pattern of the disk (streaks and dust), different for every seed; radius, quality and time are set per hole. Presets are adjustable: every value in the preset inspector can be changed, and a duplicated preset is a look of your own.

A shader traces every pixel from lookup tables that ship with the package and a small disk texture that the GPU bakes once per look, or that you store as an asset. The hole is a transparent object in every camera, with no renderer feature, no custom pass and no setup.

The background is not distorted. The hole is traced correctly, the scene behind it is not bent: the sky, the stars and other objects stay as your scene draws them. The hole is made to be seen from a distance, as the centre of a galaxy, a hazard or the light of a system.

What it draws

Everything is traced per pixel; none of it is a texture of a picture.

Shadow and photon ring

The round shadow and the thin bright ring at its edge.

Accretion disk

Seen directly and as the image over and under the shadow, with streaks, dust lanes, spiral arms and a veil.

Doppler and redshift

The side moving towards you is brighter and bluer, the other dimmer and redder.

Halo and jets

A glow at the shadow’s edge; two jets with moving knots on Torus and Quasar.

Time

The disk turns and the knots travel; Time Scale sets the speed.

A quasar-type black hole with both jets
Jets

Six presets

A preset only sets the design of a look; each combines with any seed, and every seed gives the disk its own pattern. Every value can be changed per hole, and a duplicated preset is a look of your own.

Amber

The default: a warm, bright disk with streaks and dust.

Physical

A thick disk coloured by blackbody temperature, full Doppler shift.

Torus

A thick, narrow torus with a bright halo and two jets.

Quasar

A hot blue-white disk with a strong halo and long jets.

Nebula

A wide disk with three spiral arms and strong dust lanes.

Dormant

A small, thin, dim disk.

The six presets next to each other
The six presets

Inclination

Rotate the object and the disk tilts with it. The image over and under the shadow follows.

One black hole tilted 5 degrees
5 degrees
The same black hole tilted 30 degrees
30 degrees
The same black hole tilted 80 degrees
80 degrees

The hole as a light

Black Hole Light drives a regular Unity light from the hole: colour from the disk, intensity from its brightness and area. Put a sun component of Procedural Planets or Procedural Gas Giants on it and the planets and gas giants around the hole are lit by it.

Spheres around a black hole, lit by it
The hole as the light of a scene

Quality levels

Four levels. Ultra is the tuned look; the lower levels cap the disk crossings, rays and taps and switch halo and jets off at Low.

LevelDisk crossingsRays per pixelHalo and jets
Ultraas tunedas tunedyes
Highat most 3at most 2yes
Mediumat most 3at most 1yes
Lowat most 2at most 1no

A hole that fills the screen height at 1080p costs 0.04 to 0.11 ms in URP and 0.04 to 0.15 ms in HDRP (AMD Radeon RX 9070 XT class; all presets and levels; Amber at Ultra 0.07 ms in URP). The disk texture is 2.7 MiB, shared by holes with the same seed and pattern.

Five black holes with different presets, sizes and tilts in one scene
Several holes in one scene

Works together with Procedural Stars, Planets and Gas Giants

The packages install side by side and share no code.

A star, a planet with a moon, a gas giant with a ring and a black hole in one scene

How it works

  1. 01

    Add the hole

    One menu entry adds a black hole and the light it casts.

  2. 02

    Pick a look

    Drop a preset on the component, tilt the object, change any value per hole.

  3. 03

    Keep the camera out

    One call keeps your camera at least 2.2 Schwarzschild radii away.

Requirements

Unity
6.3 LTS or newer
Render pipeline
URP and HDRP
Graphics API
Compute shaders to bake the disk texture: Direct3D 12, Vulkan or Metal. A stored disk texture needs none. Direct3D 11 is not supported.
Holes per scene
Any number; holes with the same seed and pattern share one 2.7 MiB texture.
Platforms tested
Linux (Vulkan). Windows (Direct3D 12) is set up but not tested yet.

Good to know

  • The background is not distorted. The sky, the stars and the scene behind the hole are not bent. The disk and the shadow are traced correctly.
  • No exact spin: the shadow is round; the disk turns.
  • The camera cannot come closer than 2.2 Schwarzschild radii.
  • The hole writes no depth: depth of field, motion blur and soft particles do not see it, and it sorts with other transparent objects by distance.
  • A strong bloom lifts the shadow; the documentation lists settings that keep it black.
  • No Pipeline mode, no simulation, no generator.
  • Not tested on mobile or WebGL. Direct3D 11 and macOS are not supported.

FAQ

Does the black hole bend the background?

No. The hole does not distort the sky, the stars or the objects behind it. The disk is traced through the curved space around the hole, which gives the image over and under the shadow and the photon ring; the scene is not.

Which looks are included?

Six presets: Amber, Physical, Torus, Quasar, Nebula and Dormant, each with any seed.

Is the disk a fixed texture?

No. The streaks and dust of the disk are generated from the seed; a preset only sets the design of the look. Shadow and photon ring are the same for every seed.

Can I change a preset or make my own?

Yes. Every value in the preset inspector can be changed and a duplicated preset is a new look. There is no dedicated tuning editor, so extreme values can give a plain disk.

Does it have jets?

Torus and Quasar have jets; an override can add them to any look.

Can the camera fly into the hole?

No. Keep it at least 2.2 Schwarzschild radii away; one call does it.

Why is the shadow not black?

A strong bloom in the render pipeline lifts it. The documentation lists settings that keep it black.

Does it light the scene?

Yes, through Black Hole Light, which drives a regular Unity light.

How much does it cost to draw?

The GPU time per preset and level is listed in the documentation and on this page; a hole that fills the screen height is a fraction of a millisecond.

Do I need a renderer feature or custom pass?

No. A hole is a transparent object in every camera.

Which render pipelines are supported?

Both URP and HDRP.

Does it work with Procedural Stars, Planets and Gas Giants?

Yes. The packages install side by side; see “Works together”.

Does it run on Windows?

Windows (Direct3D 12) is set up but not tested yet.

Procedural Black Hole Coming soon

Every purchase helps fund a space strategy game in development.