# AI Mesh Terrain Water — Unreal Engine Extension

AI Mesh Terrain Water (com.ivanmurzak.unreal-ai-mesh-terrain-water) — 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. An AI Game Developer extension for Unreal Engine that adds 4 capabilities through RQL (no extra MCP tools).

_Last updated: 2026-11-15_

## At a glance

| Field | Value |
| --- | --- |
| Capabilities | 4 capabilities |
| Version | 0.1.0 |
| Package id | com.ivanmurzak.unreal-ai-mesh-terrain-water |
| Engine | Unreal Engine · Unreal Engine 5.8+ |
| Status | Experimental |
| Base plugin | UnrealMCP 0.31.3 or later |
| Wraps | MeshPartitionWater + Water + MeshPartition |
| Repository | https://github.com/IvanMurzak/Unreal-MCP/blob/main/extensions/UnrealAIMeshTerrainWater/README.md |
| RQL sources | meshTerrainWaterBodies, meshTerrainWater |
| RQL functions | — |
| RQL types | WaterBody, MeshPartition |

## How it works

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.

- 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. RQL: `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. RQL: `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. RQL: `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. RQL: `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.

```bash
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.

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

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.

---

Source (HTML): https://ai-game.dev/docs/extensions/unreal/meshterrainwater
