IOC 0.1 in action (Youtube).
Read the docs.
đź“– Overview
Instant Organic Caves (IOC) is a small plugin designed to generate massive, seamless, and organic cave and/or rock systems procedurally at runtime. Unlike traditional marketplace assets that rely on static meshes or Blueprint construction scripts, IOC utilizes a "Metal C++" approach.
It builds geometry directly using Unreal's `FDynamicMesh3` core math libraries, bypassing overhead from the Blueprint VM and intermediate wrapper libraries. The result is a system that can generate infinite, seamless, Nanite-enabled environments suitable for high-fidelity production.
✨ Key Features
*Pure C++ Architecture:** No dependency on Blueprint logic, PCG Graphs, or external assets. The geometry is calculated mathematically from scratch.
*Direct Dynamic Mesh Manipulation:** Operates directly on `UE::Geometry::FDynamicMesh3` for maximum performance.
*Infinite World Generation:** Supports seamless chunk tiling using world-space Perlin Noise.
*Organic Smoothing:** Implements custom, stable Laplacian Smoothing to convert blocky voxel grids into smooth, eroded cavern walls.
*Welded Topology:** Custom meshing algorithm ensures watertight geometry with no internal faces, preventing shading artifacts and mesh tearing.
*Nanite & Lumen Ready:** programmatically enables Nanite support on generated meshes.
🚀 Quick Start
Single Chunk Generation
1. In a New Scene, open the Place Actors panel.
2. Search for `IOCProceduralActor` in Plugins.
3. Drag it into the viewport.
4. A cave chunk will generate immediately. Use the Details Panel to adjust settings like `Seed`, `Roughness`, and `Cave Size`.
Use LeftAlt+LMB to duplicate the generated chunk in any direction. Chunks can be seamlessly merged. More sophisticated options to extend the structures will come in the next version.
Infinite World Generation (WIP, coming soon)
1. Search for `IOCWorldGenerator` in the Class list.
2. Drag it into the level.
3. In the Details Panel:
Set *Chunk Class** to `IOCProceduralActor`.
Set *Render Distance** (e.g., `2` for a 5x5 grid).
Set *Update Interval** (e.g., `0.5` seconds).
4. Press Play. As the camera moves, new cave chunks will form ahead of you seamlessly.
Please note: the plugin needs the PCG and GeometryScripting modules enabled.
Hybrid PBR Pipeline: Upgraded the Master Material with a Use PBR Texture switch, instantly swapping between Pure Math and traditional Textures.
Seamless Biome Textures: Packaged three new 4K tileable rock textures directly into the plugin: Obsidian Flow, Limestone Crawl, and Alien Hive. (More to come later.)
Triplanar Projection: Implemented automatic Box Mapping to prevent texture stretching on generated vertical cave walls.
Vector Documentation: Overhauled the shipped Manual. Replaced static screenshots with clean, responsive SVG vector illustrations and added comprehensive guides for the new Hybrid Texture workflow.
Pure Math Material (updated): Developed 
Performance — carve latency 200 ms to 118 ms (1.7x)
Breaking
Content — everything re-authored on the 5.5 floor
Fixed — cave materials
Added — two routes in that need no setup
A tutorial ships: 
Changed — the Setup Wizard
Network
Added — carving and instrumentation
Verification
Structure
Additional changes
At a glance
Cave meshes face into the cave. Collision, scatter and lighting now match the surface you see.
Player carving: 
Biome blending: 
Fixes: capsule carves, spline bends, carve falloff, runtime biome volumes,
Illustrated demo guide: 
Verified: automation suite 35/35 green on UE 5.8 and on the 5.5 floor, 0 ensures; every
Stalactites now grow along +Z from their base. Scatter layers that place 
Capsule carving components carve a capsule. They used to carve everything within the
Spline tunnels are sealed on the outside of every bend. Tunnels whose bends showed slits
Console: 
Tutorial: the two demo levels, the tour’s zones and controls, 
Known
A dark level, in its own rock — and every surface rebuilt at 2K. The Warren is a second
Organic Warren preset — a tight, heavily warped bore: a burrow rather than a bore hole.
Five new props — roots, a fungal shelf, an egg sac, a bone pile and a membrane, plus a wet
2K rock, world-aligned — obsidian, limestone, alien, cave floor and the six Warren sets are
A better-mannered setup wizard — it keeps the lights already in your level, stays in front
Platforms: Win64, Linux and Android. The modules’ 
Mac is no longer listed. The modules’ 
The package is larger: plugin content grows from about 27 MB to about 209 MB, almost all of it
Built from six cave actors: three tight spline tunnels and three solid blocks whose rooms
Lit by the flashlight. The level places four lights in 346 m: the fungus, the dying lamp,
Scripted moments, no creature. A collapse that drops rubble behind you with a stutter of
Gullet — wet, folded, flesh-toned rock, glossy in the creases.
Nest — dark stone laced with pale fungal threads and flecked with spores.
Throat — cracked shale with rust weeping from the cracks.
Weep — dark wet stone with teal and white mineral seeps that glisten under the torch.
Use it on your own caves: set 
Both new base materials are two-sided and flagged for instanced static meshes, like every
It no longer puts a second sun in a lit level. Set up lighting always spawned a
It stays in front of the editor. It was an unowned window, so the moment the editor took
Preset names are no longer cut off. At the wizard’s default size every style card clipped
After Undo Added Actors, the Finish page stops describing the undone setup. Its “Spawned new
The validation report no longer mentions Python helpers that don’t ship. It said Python was
A scripted event could fire where the player stands rather than where it belongs. The
Carves that sank below a chamber’s floor left steps nobody could climb. Sphere and capsule
The interactive tour and the Warren now share their cave-building helpers
