Docs · Extensions · Unreal Engine

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.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
4 capabilities
Version
0.1.0
Package id
com.ivanmurzak.unreal-ai-mesh-terrain-water
Engine
Unreal Engine · Unreal Engine 5.8+
Wraps
MeshPartitionWater + Water + MeshPartition
Repository

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

See it in the Unreal Engine catalog →

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-cliunreal-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.

Not sure if it's installed? Ask the agent to run rql-schema — the meshTerrainWaterBodies source only exists when the package is present.

Example prompts

Copy-pasteable first requests. Start with one, verify it in the editor, then build up.

  1. Add an ocean at height 0 around the Island Mesh Terrain.
  2. Create a lake with a 30 m radius at (12000, -8000, 300) on Island that carves a 4 m deep bed.
  3. 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.

Keep going