AI Mesh Terrain Water
Experimental Requires Unreal Engine 5.8+; the extension and the engine feature it drives may change between releases.
Experimental water on Mesh Terrain for Unreal Engine 5.8+ (Mesh Partition Water) — create lakes and rivers whose water modifiers carve their bed and shores into a Mesh Terrain, and the ocean around an island; attach a water body placed another way to a terrain, detach or delete it; size the water zone; and read whether each body shapes its terrain and renders, or what to call to fix it.
At a glance
What the agent can do with it
Adds no MCP tools: it contributes an RQL module with the meshTerrainWaterBodies, meshTerrainWater sources and adapters for WaterBody, MeshPartition. That powers 4 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →
- Lakes, rivers & ocean
Create a lake (center, radius, bed depth) or a river through points (width, depth) whose water modifier carves its bed and shores into a Mesh Terrain, or the ocean around an island; each call places the body like the Place Actors panel (material, waves), and a lake or river returns when the terrain is rebuilt.
meshTerrainWater | call CreateLake(unreal.find("Island"), "Lake", [12000, -8000, 300], 3000) - Attach, detach & delete
Give a water body placed another way the water modifier of its kind bound to a terrain, move it to another terrain, take the modifier off, or delete the body and restore the ground; each in one undo step.
meshTerrainWater | call Attach(unreal.find("WaterBodyLake"), unreal.find("Island")) - Water zone & material
Size and place the water zone that renders the water (grown to cover every Mesh Terrain with a 25% margin, or an exact size), set a body’s water material, and enable the Mesh Terrain water plugins in the project.
meshTerrainWater | call SetZone(0) - Readiness & problems
List water bodies with their terrain, modifier, surface height, bed depth, material and zone, and whether each one shapes its terrain and renders (Ready) or what to call to fix it (Problem); wait for a terrain build.
meshTerrainWaterBodies | select Label MeshTerrainWater
Install
Requires the base plugin UnrealMCP 0.31.3 or later. The extension ships as C++ source: rebuild the project (or pass --build) before opening the editor; then the RQL module loads with the package — the agent sees it in rql-schema.
unreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-mesh-terrain-water <UEProject>When to ask the AI for it
Ask for water on a Mesh Terrain in a UE 5.8+ level — an ocean around an island, a lake that digs its own basin, a river that cuts its channel from the hills to the sea, or a check why a water body does not show or does not shape the ground.
Example prompts
Copy-pasteable first requests. Start with one, verify it in the editor, then build up.
Add an ocean at height 0 around the Island Mesh Terrain.Create a lake with a 30 m radius at (12000, -8000, 300) on Island that carves a 4 m deep bed.Run a 15 m wide river on Island from the hills at (-20000, 0, 600) down to the coast at (20000, 0, 0), then tell me whether every water body is ready.