Docs · Extensions · Unreal Engine

AI Landscape

Landscape and Water authoring — create, sculpt and paint landscapes; create oceans, lakes and rivers (one routed downhill along the ground); and query landscapes, water bodies and water zones.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
4 capabilities
Version
0.3.0
Package id
com.ivanmurzak.unreal-ai-landscape
Engine
Unreal Engine · Unreal Engine 5.7+
Wraps
Landscape + Water
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with the landscapes, waterBodies, waterZones, landscape, water sources and adapters for LandscapeProxy, WaterBody. That powers 4 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Create landscapes

    Create a landscape at a size with a layer-blend material made from named, coloured paint layers.

    landscape | call Create("Terrain", [0, 0, 0], 100, "/Game/Landscape/M_Terrain")
  • Sculpt & paint

    Raise or lower smooth circular areas, paint layers with a soft edge, and rebuild a landscape edited elsewhere; the ground is updated when the call returns.

    landscape | call Sculpt(unreal.find("Terrain"), [2000, 1500, 0], 1200, 600)
  • Oceans, lakes & rivers

    Create an ocean, a lake, a river through points or a river along the lowest ground between two places, set the water material and zone, and enable Water for packaged games.

    water | call CreateOcean("Ocean", 0)
  • Inspect terrain & water

    List landscapes (sections, paint layers, bounds), water bodies and water zones, and read the ground height, slope and normal at a point.

    landscapes | select Label Sections PaintLayers LandscapeMaterial

See it in the Unreal Engine catalog →

Install

Requires the base plugin UnrealMCP 0.26.0 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-landscape <UEProject>

When to ask the AI for it

Ask for terrain and water in a level — an island with hills and painted layers, an ocean around it, or a river from the mountains to the sea.

Not sure if it's installed? Ask the agent to run rql-schema — the landscapes 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. Create a landscape called Terrain with a Grass and Rock layer material, raise a hill at (2000, 1500), and paint it with Grass.
  2. Add an ocean at height 0 and a river that flows along the lowest ground of Terrain to the coast.
  3. List every landscape with its paint layers and every water body.

Keep going