Procedural Planet Generation & Interactive Environmental Simulation Platform
Live Demo • Key Features • Scientific Models • Visualization Modes • Quick Start • Export & OBJ
WORLD ENGINE is a procedural planet creation and interactive scientific simulation platform. Rather than generating a simple random terrain mesh, WORLD ENGINE maintains a strongly-typed planetary data model where spherical geology, continental tectonics, hydrological drainage networks, thermodynamic atmospheric circulation, and ecological biomes are coupled deterministically.
Built with React, TypeScript, Three.js, and Tailwind CSS, it runs entirely client-side with 60 FPS WebGL rendering, real-time geographic raycasting, and zero external server dependencies.
flowchart TD
subgraph Core ["Deterministic Core"]
PRNG["Seeded PRNG (Mulberry32 & MurmurHash3)"]
Geo["Spherical Coordinates & Solid-Angle Area Integration"]
end
subgraph Geology ["Tectonic & Terrain Engine"]
Plates["Spherical Voronoi Plates & Kinetic Drift"]
Noise3D["3D Domain-Warped Simplex & Ridged Multifractals"]
Erosion["Hydraulic & Fluvial Sediment Redistribution"]
end
subgraph Hydro ["Hydrology Subsystem"]
SeaLevel["Hypsometric Sea Level & Coastline Classification"]
D8["D8 Downhill Drainage & Upstream Catchment Extraction"]
end
subgraph ClimateSys ["Atmospheric Climate Engine"]
Insolation["Latitudinal Insolation & Obliquity (Axial Tilt)"]
Lapse["Atmospheric Lapse Rate (-6.5°C/km)"]
Hadley["Hadley Cells, Prevailing Winds & Orographic Rain Shadows"]
end
subgraph Bio ["Ecosystem Classification"]
Whittaker["Whittaker / Holdridge Biome Envelope Matrix"]
end
subgraph Render ["Rendering & Export Pipeline"]
Mesh3D["Three.js Displaced 3D Sphere & Fresnel Atmosphere"]
Map2D["Equirectangular WGS-84 Planar Projection"]
ObjExport["Wavefront .OBJ 3D Mesh & GeoJSON Exporters"]
end
Core --> Geology
Geology --> Hydro
Geology --> ClimateSys
Hydro --> ClimateSys
ClimateSys --> Bio
Hydro --> Bio
Bio --> Render
- Deterministic & Reproducible: 100% reproducible planetary generation driven by 32-bit seeds and independent sub-streams for terrain, climate, and hydrology.
- 3D Physical Relief Extrusion: Spherical geometry vertices are physically displaced outward along mountain peaks and recessed into ocean trenches.
- Interactive Multi-View Workspace:
3D Globe Explorer: 3D WebGL sphere with Fresnel outer rim glow, dynamic day/night sunlight, and procedural clouds.2D Planar Map: Full Equirectangular WGS-84 projection with interactive graticule, gold Equator, and cyan Prime Meridian.Scientific Laboratories: Hypsometric elevation frequency curve, latitudinal climate gradients, and terrestrial biome area rankings.Planet Comparison Lab: Side-by-side benchmarking with real-time Net Delta calculations.
- Real-Time Geographic Raycasting: Hover or click anywhere on the globe to query exact latitude, longitude, physical elevation in meters, slope angle, local mean temperature, precipitation, and biome definition.
- Live Sea-Level Slider: Modify sea level to observe live coastal transgression/regression and real-time spherical land/water coverage updates.
- 10 Scientific Visualization Modes: Photorealistic true-color, hypsometric elevation, thermal scale, annual precipitation, biomes, aridity index, slope relief, tectonics, bathymetric depth, and elevation contours.
- Export Pipeline: Download project configuration JSON, 2D equirectangular heightmap PNGs, printable scientific HTML dossiers, or 3D Wavefront
.OBJmeshes ready for Blender, Maya, Unreal Engine, and 3D printing.
Cartesian coordinates
Planetary temperature considers latitudinal solar insolation, seasonal swings from axial tilt
Warm air holds exponentially more moisture (Clausius-Clapeyron relation). Prevailing zonal winds (Trade Winds and Westerlies) carry moisture against mountain barriers:
- Windward Slopes: Air rises, cools adiabatically, and condenses into intense precipitation.
- Leeward Slopes: Descending dry air creates an arid rain shadow on the opposite side of mountain ranges.
Surface runoff follows the steepest downhill gradient to its neighboring cells:
| Mode | Colormap Ramp | Scientific Data Represented |
|---|---|---|
| Natural | Biome True Color | Photorealistic biomes, alpine snowcaps, bathymetric shelf depths, and day/night sunlight terminator. |
| Elevation | Bathymetry |
Deep ocean indigo ( |
| Thermal | Diverging Scientific |
|
| Rainfall | Arid Ochre |
Annual rainfall in mm/year ( |
| Biomes | Discrete Categorical | 16 discrete Whittaker/Holdridge ecological classification biomes. |
| Moisture | Aridity |
Ratio of precipitation to potential evapotranspiration (PET index |
| Slope | Gradient Relief | Terrain slope angle from |
| Tectonics | Lithospheric Plate ID | Discrete colored tectonic plates with highlighted collision and rift boundaries. |
| Bathymetry | Marine Depth Zones | Shallow sunlit shelves ( |
| Contours | Topographic Isolines | Isolines rendered every |
-
Earth-like (Terra): Balanced habitable terrestrial sphere with dynamic continents, deep oceans, moderate tilt (
$23.44^\circ$ ), and river networks. - Ocean World (Pelagia): Vast global ocean dotted with volcanic island chains and submerged continental shelves.
- Desert World (Dune): Hyper-arid continental super-desert with vast dune seas, canyonlands, and minimal surface water.
- Frozen World (Cryos): Snowball planet with runaway glacial ice sheets, permafrost tundra, and frozen seas.
- Archipelago World (Sirena): Intricate chains of coral atolls, fragmented coastlines, and shallow turquoise shelves.
-
Mountain World (Titan Peak): Massive continental collision belts, extreme orogeny peaks (
$14,500\text{ m}$ ), and steep gorges. - Volcanic World (Ignis): Basaltic shield volcanoes, dense greenhouse atmosphere, hot geothermal basins, and sulfurous terrain.
-
Exoplanet (Aethelgard): Alien biosphere with violet vegetation, high axial tilt (
$41^\circ$ ), and labyrinthine terrain.
WORLD ENGINE includes an automated mathematical and scientific test suite verifying core physical laws:
================================================================
WORLD ENGINE — SCIENTIFIC & MATHEMATICAL VALIDATION SUITE
================================================================
[✓ PASS] Test 1: Seed Reproducibility
Details: Identical seeds yielded identical elevation fields and surface statistics.
[✓ PASS] Test 2: Spherical Coordinate Conversion
Details: Tested Equator, North Pole, South Pole, and Antimeridian successfully.
[✓ PASS] Test 3: Land/Water Classification
Details: Raising sea level reduced land from 49.5% to 10.6%; lowering increased land to 93.2%.
[✓ PASS] Test 4: Surface Coverage Solid Angle Calculation
Details: Land + Water equals exactly 100.00% (510,064,472 km²).
[✓ PASS] Test 5: Elevation Extremes & Distribution
Details: Min: -10,301m, Max: +8,848m, Mean: 448m.
[✓ PASS] Test 6: Slope Gradient Angle Calculation
Details: All slopes within [0, π/2] radians; max slope is 73.5°.
[✓ PASS] Test 7: Hydrological D8 Drainage Pathways
Details: 100.0% of flow directions strictly downhill towards coastal base levels.
[✓ PASS] Test 8: Climate Physical Relationships
Details: Solar insolation cooled equator (20.3°C) to pole (-3.2°C); lapse rate cooling verified.
[✓ PASS] Test 9: Ecological Biome Classification Matrix
Details: Verified tropical rainforest, glacial ice, hot desert, and ocean biome classification bounds.
[✓ PASS] Test 10: Subsystem Dependency Invalidation
Details: Selective sea level update preserved raw terrain elevation arrays without wasteful recalculation.
================================================================
RESULTS: 10 / 10 Tests Passed (100%)
================================================================
- Node.js 18+ or 20+
- npm / pnpm / yarn
# Clone the repository
git clone https://github.com/OwXMaybe/world-engine.git
# Navigate to project directory
cd world-engine
# Install dependencies
npm install
# Start development server
npm run devOpen http://localhost:5173 in your browser.
npm testnpm run buildThe optimized bundle will be created in the dist/ directory.
The repository includes a GitHub Actions workflow (.github/workflows/deploy.yml):
- Push this repository to GitHub.
- In your repository settings, navigate to Settings
$\rightarrow$ Pages. - Under Build and deployment, select Source: GitHub Actions.
- Every push to
mainwill build, test, and publish the live site tohttps://owxmaybe.github.io/world-engine/.
Click the Export button in the top bar to generate:
- 3D Wavefront Mesh (
.OBJ): Displaced spherical polygon mesh with baked vertex colors for Blender, Maya, Unreal Engine, and 3D printing. - Heightmap & Surface PNGs: High-resolution equirectangular raster maps.
- Configuration JSON: Full planetary parameters and deterministic seed metadata.
- Scientific Dossier (HTML): Printable planetary report detailing physical dimensions, crustal hypsometry, and climate metrics.
This project is licensed under the MIT License — see the LICENSE file for details.