batihandev/unity-mcp-skills/terrain

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

Use when users want to create terrain, set heights, paint textures, or add trees.

Install

npx vskill@latest install batihandev/unity-mcp-skills/terrain

SKILL.md

Unity Terrain Skills

Overview

Note: Terrain operations require an existing Terrain in the scene, or use terrain_create to generate one.

Common Mistakes

DO NOT (common hallucinations):

terrain_set_texture does not exist → use terrain_paint_texture with layer index and brush parameters
terrain_add_tree / terrain_add_grass do not exist → these require Unity Terrain tools or custom scripts
terrain_set_size does not exist → terrain dimensions are set at creation via terrain_create
terrain_import_heightmap / terrain_set_heights do not exist → use terrain_set_heights_batch with a 2D heights array ([z][x] values 0-1)

Routing:

For terrain material → use material module on terrain's material
For objects on terrain → use gameobject module to create/place objects

Skills Overview

Skill	Description
`terrain_create`	Create new Terrain with TerrainData
`terrain_get_info`	Get terrain size, resolution, layers
`terrain_get_height`	Get height at world position
`terrain_set_height`	Set height at normalized coords
`terrain_set_heights_batch`	Batch set heights in region
`terrain_add_hill`	⭐ Add smooth hill with radius and falloff
`terrain_generate_perlin`	⭐ Generate natural terrain using Perlin noise
`terrain_smooth`	⭐ Smooth terrain to reduce sharp edges
`terrain_flatten`	⭐ Flatten terrain to target height
`terrain_paint_texture`	Paint texture layer at position

Skills

terrain_create

Create a new Terrain GameObject with TerrainData asset.

Parameter	Type	Required	Default	Description
`name`	string	No	"Terrain"	Terrain name
`width`	int	No	500	Terrain width (X)
`length`	int	No	500	Terrain length (Z)
`height`	int	No	100	Max terrain height (Y)
`heightmapResolution`	int	No	513	Heightmap resolution (power of 2 + 1)
`x`, `y`, `z`	float	No	0	Position

Returns: {success, name, instanceId, terrainDataPath, size, position}

terrain_get_info

Get terrain information.

Parameter	Type	Required	Description
`name`	string	No*	Terrain name
`instanceId`	int	No*	Instance ID

*If neither provided, uses first terrain in scene

Returns: {success, name, size, heightmapResolution, alphamapResolution, terrainLayerCount, layers}

terrain_get_height

Get terrain height at world position.

Parameter	Type	Required	Description
`worldX`	float	Yes	World X coordinate
`worldZ`	float	Yes	World Z coordinate
`name`	string	No	Terrain name

Returns: {success, worldX, worldZ, height, worldY}

terrain_set_height

Set height at normalized coordinates.

Parameter	Type	Required	Description
`normalizedX`	float	Yes	X position (0-1)
`normalizedZ`	float	Yes	Z position (0-1)
`height`	float	Yes	Height value (0-1)
`name`	string	No	Terrain name

Returns: {success, normalizedX, normalizedZ, height, pixelX, pixelZ}

terrain_set_heights_batch

⚠️ BATCH SKILL: Set heights in rectangular region.

Parameter	Type	Required	Description
`startX`	int	Yes	Start X pixel index
`startZ`	int	Yes	Start Z pixel index
`heights`	float[][]	Yes	2D array [z][x] with values 0-1
`name`	string	No	Terrain name

Returns: {success, startX, startZ, modifiedWidth, modifiedLength, totalPointsModified}

See `../../recipes/terrain/<command>.md` for C# templates.

terrain_add_hill

⭐ RECOMMENDED: Add a smooth, natural-looking hill to the terrain.

Parameter	Type	Required	Default	Description
`normalizedX`	float	Yes	-	X position (0-1)
`normalizedZ`	float	Yes	-	Z position (0-1)
`radius`	float	No	0.2	Hill radius (0-1, relative to terrain size)
`height`	float	No	0.5	Hill height (0-1)
`smoothness`	float	No	1.0	Smoothness factor (higher = smoother)
`name`	string	No	null	Terrain name

Returns: {success, centerX, centerZ, radius, height, affectedArea}

See `../../recipes/terrain/<command>.md` for C# templates.

terrain_generate_perlin

⭐ RECOMMENDED: Generate natural-looking terrain using Perlin noise algorithm.

Parameter	Type	Required	Default	Description
`scale`	float	No	20.0	Noise scale (lower = larger features)
`heightMultiplier`	float	No	0.3	Height intensity (0-1)
`octaves`	int	No	4	Detail layers (more = more detail)
`persistence`	float	No	0.5	Amplitude decrease per octave
`lacunarity`	float	No	2.0	Frequency increase per octave
`seed`	int	No	0	Random seed (0 = random)
`name`	string	No	null	Terrain name

Returns: {success, resolution, scale, heightMultiplier, octaves, persistence, lacunarity, seed}

See `../../recipes/terrain/<command>.md` for C# templates.

terrain_smooth

⭐ Smooth terrain heights to reduce sharp edges and create natural transitions.

Parameter	Type	Required	Default	Description
`normalizedX`	float	Yes	-	X position (0-1)
`normalizedZ`	float	Yes	-	Z position (0-1)
`radius`	float	No	0.1	Smoothing radius (0-1)
`iterations`	int	No	1	Number of smoothing passes
`name`	string	No	null	Terrain name

Returns: {success, centerX, centerZ, radius, iterations, affectedArea}

See `../../recipes/terrain/<command>.md` for C# templates.

terrain_flatten

⭐ Flatten terrain to a specific height in a region.

Parameter	Type	Required	Default	Description
`normalizedX`	float	Yes	-	X position (0-1)
`normalizedZ`	float	Yes	-	Z position (0-1)
`targetHeight`	float	No	0.5	Target height (0-1)
`radius`	float	No	0.1	Flatten radius (0-1)
`strength`	float	No	1.0	Flatten strength (0-1)
`name`	string	No	null	Terrain name

Returns: {success, centerX, centerZ, targetHeight, radius, strength}

See `../../recipes/terrain/<command>.md` for C# templates.

terrain_paint_texture

Paint terrain texture layer. Requires terrain layers already configured.

Parameter	Type	Required	Default	Description
`normalizedX`	float	Yes	-	X position (0-1)
`normalizedZ`	float	Yes	-	Z position (0-1)
`layerIndex`	int	Yes	-	Terrain layer index (0-based; use `terrain_get_info` to query available layers)
`strength`	float	No	1.0	Paint strength
`brushSize`	int	No	10	Brush size in pixels
`name`	string	No	null	Terrain name

Returns: {success, layerIndex, layerName, centerX, centerZ}

Example Usage

See `../../recipes/terrain/<command>.md` for C# templates.

Recipe path rule: ../../recipes/terrain/<command>.md

Security

Security scanPassed, 90 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/terrain/SKILL.md

Popularity

7-day trend score: 0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Embed badge

vskill VERIFIED badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/batihandev/unity-mcp-skills/terrain/badge)](https://verified-skill.com/skills/batihandev/unity-mcp-skills/terrain)

Something wrong with this skill or its page? Tell us.