unity-terrain
Operate on Unity Terrain
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-terrainIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The unity-terrain skill by besty0728 enables an AI agent to manage Unity Terrain assets via a local REST API. It supports creating terrain, sculpting heightmaps, and painting textures. The skill is primarily focused on Unity Editor automation and includes basic validation for input parameters. No malicious content or security vulnerabilities were found.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Unity Terrain Skills
Create terrain and edit its heightmap and texture layers. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.
When to use
- Creating or editing terrain
- Sculpting or smoothing the heightmap
- Painting terrain texture layers
Rules
- Sculpt and paint operations need an existing Terrain in the scene. Create one with
terrain_create. - Heights and positions are normalized (0-1) unless a skill says it takes pixel indexes (
terrain_set_heights_batchstartX/startZ). - Every skill except
terrain_createpicks its terrain withname,entityId,instanceIdorpath; useentityIdwhere the Editor supports it. - For the terrain material use the material module. To place objects on the terrain use the gameobject module.
- To remove a terrain, delete its asset with
asset_delete.
Pitfalls
terrain_set_texturedoes not exist. Useterrain_paint_texturewith a layer index.terrain_add_treeandterrain_add_grassdo not exist. Trees and grass need the Unity Terrain tools or custom scripts.terrain_set_sizedoes not exist. Terrain dimensions are set at creation, interrain_create.terrain_import_heightmapandterrain_set_heightsdo not exist. Useterrain_set_heights_batchwith a 2D array indexed[z][x]of values 0-1.
Skills Overview
| Skill | Purpose |
|---|---|
terrain_create | Create a Terrain with TerrainData |
terrain_get_info | Get size, resolution and layers |
terrain_get_height | Get the height at a world position |
terrain_set_height | Set the height at normalized coordinates |
terrain_set_heights_batch | Set heights over a rectangular region |
terrain_add_hill | Add a smooth hill (recommended) |
terrain_generate_perlin | Generate terrain from Perlin noise (recommended) |
terrain_smooth | Smooth heights to reduce sharp edges (recommended) |
terrain_flatten | Flatten a region to a target height (recommended) |
terrain_paint_texture | Paint a texture layer at a position |
Workflow
Terrain operations support workflow undo. Start a session with workflow_session_start, run the terrain skills, then workflow_session_end. Undo the whole session with workflow_session_undo. See the workflow module.
Example
Quick terrain: create it, then generate its base shape with Perlin noise, then add a hill:
curl -s "http://localhost:<port>/skill/terrain_create?expectProject=<project>" -d '{"name":"MyTerrain","width":200,"length":200,"height":50}'
curl -s "http://localhost:<port>/skill/terrain_generate_perlin?expectProject=<project>" -d '{"scale":20,"heightMultiplier":0.4,"octaves":5}'
curl -s "http://localhost:<port>/skill/terrain_add_hill?expectProject=<project>" -d '{"normalizedX":0.3,"normalizedZ":0.6,"radius":0.2,"height":0.5}'
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-terrain">View unity-terrain on skillZs</a>