Use when working with a Unity project via MCP — creating or editing scenes, GameObjects, components, prefabs, materials, UI, lighting, navmesh, animations, terrain, C# scripts, or any other Unity Editor task.

2026-07-034

unity-test

batihandev/unity-mcp-skills

Use when users want to run Unity tests or read test results.

2026-05-294

unity-editor

batihandev/unity-mcp-skills

Use when users want to enter play mode, select objects, undo/redo, or execute menu commands.

2026-05-264

unity-script

batihandev/unity-mcp-skills

Use when creating, reading, editing, searching, validating, or deleting C# scripts in a Unity project.

2026-05-264

unity-tooling

batihandev/unity-mcp-skills

Use when about to write or install a custom Editor script, add a [MenuItem], build a custom Editor window, or create a one-off Editor helper — to check whether a ready-to-paste template already exists in tooling/<domain>/ before reaching for Unity_CreateScript.

2026-05-264

unity-ui

batihandev/unity-mcp-skills

Use when users want to create Canvas, Button, Text, Image, or other UI elements.

2026-05-264

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

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}