Orbs / ORB-24

ORB-24

a Minecraft Earth — a perfect voxel sphere whose seasons cycle it through lush, cherry-grove, ice, mesa and desert worlds

WebGPU isn't available in this browser

Open in playground

Installation

bash

npx expo install react-native-shader-orbs react-native-webgpu react-native-reanimated react-native-worklets

Usage

typescript

import { ShaderOrb, orb24 } from "react-native-shader-orbs";

typescript

<ShaderOrb orb={orb24} size={280} state="idle" interactive />

Props

Component props

The props you'll use most. The ShaderOrb reference lists all of them.

Prop	Type	Default	Description
`state`	`"idle" \| "thinking" \| "speaking"`	`"idle"`	The mood. Eases the parameters toward that preset.
`size`	`number`	`280`	Width and height in points.
`params`	`Record<string, number>`		Parameter overrides by key, clamped to each range. See the shader params below.
`colors`	`Record<string, string>`		Hex colors by key. See the colors below.
`volumes`	`{ input?: number; output?: number }`		Levels from 0 to 1 that the shader reads as input and output loudness.
`interactive`	`boolean`	`false`	Tap pulses the orb; holding makes it swell.
`quality`	`"auto" \| "low" \| "medium" \| "high" \| number`	`"auto"`	Render scale. Lower is cheaper and softer.
`maxFps`	`number`	`60`	Frame cap.
`paused`	`boolean`	`false`	Stops drawing and keeps the last frame.
`onReady`	`() => void`		Called once the first frame is on screen.
`onError`	`(error: Error) => void`		Called if the orb can't start. Without it the error is logged once.

Shader params

Pass these through params. Values are clamped to the range shown. integrated parameters are phase clocks: the shader accumulates them over time, so the value acts as a rate.

Key	Label	Range	Step	Default
`spin`	Spin integrated	0 to 5	0.03	0.22
`tilt`	Tilt	0 to 4	0.02	0.45
`drift`	Terrain drift integrated	0 to 10	0.05	0.12
`season`	Season rate integrated	0 to 10	0.05	0.3
`shuffle`	Ember rate integrated	0 to 20	0.1	0.8
`radius`	Radius	0.15 to 3	0.015	1.15
`blocks`	Blocks	16 to 96	1	64
`rough`	Mountains	0 to 0.8	0.01	0.45
`scale`	Terrain scale	0.5 to 8	0.05	2.4
`sea`	Sea level	0 to 1	0.01	0.5
`trees`	Trees	0 to 1	0.01	0.75
`cave`	Caves	0 to 1	0.01	0.4
`ore`	Ore density	0 to 0.6	0.01	0.12
`glow`	Ore glow	0 to 5	0.03	0.9
`core`	Molten core	0 to 1	0.01	0.5
`texture`	Texture grain	0 to 1	0.01	0.6
`light`	Key light	0 to 3	0.015	1
`gain`	Gain	0.05 to 5	0.05	1
`contrast`	Contrast	0.15 to 10	0.05	1

Colors

Pass these through colors as hex strings.

Key	Label	Default
`grass`	Grass	`#6abe30`
`dirt`	Mud	`#6f4a2f`
`stone`	Stone	`#8a8a90`
`sand`	Sand	`#dbcf9c`
`water`	Water	`#2f66d0`
`leaf`	Leaves	`#3e8f27`
`ore`	Ore	`#4de3ff`
`lava`	Lava	`#ff7b26`

Moods

This orb ships presets for idle, speaking, thinking. Choosing a state eases the parameters toward that preset; anything you pass in params still wins.

Credits

Based on original work by XorDev, via shadercn. The shader is licensed for non-commercial use with attribution; see Licensing and credits.

Ported to React Native by @msobkyy.

Want to change something? Open ORB-24 in the playground.