For MTE Pro user, please activate this copy on your machine first.

You can just start using MTE without any installation, but It's recommended for first-time users to read docs about specific function before using it. Also be sure to read following points:

• If you run into problems, please refer to related documentation and FAQ first. If they cannot solve your problem, feel free to contact the author to get support.
• MTE will modify your mesh and related files. Your files may be corrupted under rare conditions. Please, be sure to use a version control system like SVN or GIT to manage files in your project. It's really important to back up your files!
• Do not check Optimize Mesh in the mesh import settings of the obj mesh file when editing with MTE. Such optimization by the mesh importer will possibly change the vertex count and index order. That makes the mesh data inconsistent with the obj file, which leads to many problems when editing the mesh with MTE.
• Editing operations are undoable before saving the mesh. Please note that once auo-save is enabled, when auto-save happened, you can no longer redo/undo.
• Please note that the unit of brush sizes can be adjusted in Settings > Brush unit. (actual brush size) = (bursh size) * (brush unit). So you can adjust the brush unit to a suitable value before starting editing anything. It's recommended to use the same size as one quad of the mesh. (The quad size calculated by MTE may be incorrect for meshes not created by Mesh Terrain Editor.)

Main menu of Mesh Terrain Editor is located at Window/Mesh Terrain Editor. By clicking on an entry of the menu, you can open MTE windows that provides functions to use.

• Mesh Terrain Editor
  
  • Creator: to create one or multiple tiled mesh-terrain as a plane, from a height map or from a curve.
  • Convertor: to create a mesh-terrain from an existing Unity terrain or terrain-like mesh.
  • Editor: to edit a mesh-terrain.
  • Settings: to edit general settings
  • Tools: misc tools for mesh-terrains
  • Support: documentation, welcome window, forum, instant messaging(discord) and bug report & feature request;
  • Debug: debug functions used to check MTE issues
  • Check for Updates
  • ActivationActivate or deactivate MTE Pro license on this machine.
  • Help: open the docs that you are reading
  • About: view MeshTerrainEditor credits and version info.
• Tools
  
  • History Viewer
  • Mesh Statics Viewer a statistics viewer of a mesh-terrain
  • Snapshooter capture a screenshot of a mesh-terrain from a top-down perspective
  • Mesh to Terrain Converter
  • Tools for craft a mesh-terrain by hand. See Reuse an existing mesh for details.
    • Mesh saver
    • Mesh Z-Up to Y-UP Converter
    • Mesh Pivot Adjuster
    • Mesh UV Adjuster
    • Control Texture Creator
    • Texture Adjuster
  • Special tools created for specific users, don't touch these if you don't know the usage.
    • Mesh Tilling Baker
    • Texture Channel Packer
    • Texture Channel Packer Ex
    • Texture2DArray Generator: Note MTE never use this to generate Texture Array, please follow the instruction here.
• Support
  
  • Documentation: open the documentation of Mesh Terrain Editor, which you are reading now.
  • Welcome Window: open the welcome window, which shows up on starting Unity editor
  • Forum: the forum to communicate with the author and other users; Also when a new stable version is released, a notice will be posted here.
  • Instant Messaging: communicate with the author of Mesh Terrain Editor at realtime. It will lead you to the official Discord Channel of Mesh Terrain Editor.
  • Feature Request & Bug Report: to request new features, suggest modifications or report a bug.
• Debug
  
  • Reset Mesh Terrain Editor: reset states of MTE, note this function will trigger a code compilation.
  • Open Editor Log: Open the editor log folder of Unity.

Editor
	└── MTE.dll (main MTE editor lib)
EditorResources (MTE editor resources)
	│	MTE_EDITOR_RESOURCE_LOCATION.txt (MTE Editor resources locator file, don't delete)
    │   mte.ico (MTE icon file)
	├── Brushes (brush mask textures)
	│	├── brush_00.png
	│	├── brush_01.png
	│	│   ...
	│	└── brush_55.png
	├── Details (prototype settings for grass/object painter's list)
	├── Languages (language files)
	│	├── en-US.xml (English, United States)
	│	└── zh-Hans.xml (Chinese (Simplified))
	└── Shaders (shaders used by MTE editor)
Plugins (MTE Plugins code and resources)
    ├── Editor (editor code)
	├── Scripts (runtime code)
	└── Resources
		└── Grass (prototype meshes for creating grass instances)
Shaders
	├── Builtin (legacy standard, surface and unlit shaders)
	├── URP (URP shaders)
	└── MTE Common.cginc (shared code for MTE shaders)
MTE_ReadMe.htm (this file)

Mesh Terrain Editor(MTE) has three main functions:

• The MTE Creator that can create mesh-terrain.
• The MTE Converter that can convert Unity3D terrain component into mesh-terrain(s).
• The MTE Editor that can edit a mesh-terrain, including three height tools, a texture painter, a vertex color painter, an object painter, a grass painter, a flow-map painter and a mesh toolbox.

A mesh-terrain is just a mesh with a special terrain shader. MTE provides shaders with 2/3/4/5 layer textures and 2-12 layer textures based on texture-array. One mesh-terrain only uses one drawcall.

There are two kinds of mesh-terrains that can be created:

• Legacy: mesh-terrain with 2/3/4/5 blended layer textures.
• TextureArray (Beta): mesh-terrain with 2 to 12 blended layer textures. OpenGLES 3.0+ required since it uses texture array.

Texture-array mesh-terrain doesn't support create tiled mesh-terrains or create from a height map, for now.

You can create a texture-array mesh-terrain directly by using the MTE Creator. The MTE Creator can be opened at menu Window/Mesh Terrain Editor/Creator. Then click the TextureArray tab button.

Name	Name of the created mesh-terrain
File Format	File format of created mesh: *.obj, *.asset or *.fbx. It's recommended to use *.asset or *.fbx if the mesh has more than 120*120 vertices.
Output dir	The directory path that the mesh-terrain directory will be created in. All generated contents of the mesh-terrain will be put in OutputDir/Name/. The directory should be a child directory of /Assets
Create prefab	If checked, a prefab of the mesh-terrain will be created and instantiated in the scene. Otherwise the mesh-terrain will be created directly in the scene. It's recommended to create a prefab for the mesh-terrain.
Shader Type	Choose a shader type for the mesh-terrain. Note using wrong type that is not supported by current project will make the created mesh-terrain pink or invisible. For example, don't use URP shader type if you are working in a project using builtin pipeline.
Layer Count	the number of texture layers of mesh-terrain. Only 4 different layer textures can be used in MTF Free.
TextureArray	Albedo: Specify albedo texture array RoughnessNormalAO: Specify Roughness(R) Normal(GB) AO(A) texture array. To create texture arrays, see How to create or modify the albedo/roughness/normal/AO texture arrays?
Weight Map Size	Specify the size of the weight map(s). This determines the quality of the painted texture: bigger size means better quality but more memory will be consumed. This can be adjusted later with the Texture Adjuster.
Layer Texture Tilling	Specify how many times a layer texture will be tiled along a direction. This value can be adjusted later in the material editor of the mesh-terrain.
Vertex Count	Specify the number of vertices along an axis (x/z) direction.
Mesh Size	Specify the size of the mesh-terrain. It is exactly the bounding(AABB) size in x-z plane.
Base Height	The lowest height of the vertices in the mesh-terrain.

Usage Steps

1. Create two texture arrays with PBRTextureArraySettings: one is albedo, another is roughness, normal and AO.
2. Specify the settings
3. Click Create.
4. When finished, the mesh-terrain will be placed in the output dir. And the mesh-terrain will be instantiated in the scene.

You can convert a Unity3D terrain into a mesh-terrain with MTE converter. The MTE Converter can be opened at menu Window -> Mesh Terrain Editor -> Converter. Or just right click on the terrain component header, choose Convert to mesh-terrain.

Name	Name of created mesh-terrain
File Format	File format of created mesh: *.obj, *.asset or *.fbx. It's recommended to use *.asset if the mesh has more than 120*120 vertices.
Output dir	The directory that the mesh-terrain directory will be created in. All generated contents of the mesh-terrain will be put in {OutputDir}/{Name}/. The directory should be a child directory of /Assets.
Mesh Only	Convert the Unity terrain to a mesh object with default material. No MTE shaders applied.
Export Trees	Export trees on original Unity3D terrain.
Use Texture Array	Check this to create texture array based mesh-terrain(s).
Shader Type	Choose the type of shader that will be used.
Shader	Display/Choose a costomized shader.
Vertex Count	Specify the number of vertices along an axis direction.
Split	Check this to split a Unity terrain into 2x2 to 8x8 mesh-terrains.
Overall Vertex Count	The number of all vertices of all tiled meshes that will be created after conversion.
Per-tile Statistics	See mesh-terrain statistics.

Usage Steps

1. Open the MTE Converter and click Terrain.
2. Specify the settings. Check Use Texture Array.
3. Click Begin Converting and wait a moment. It should finish in about 5-15 seconds.
4. When finished, the mesh-terrain will be saved in the output directory. And the prefab of converted mesh-terrain is instantiated in the scene.

You can create mesh-terrains directly by using the MTE Creator. The MTE Creator can be opened at menu Window/Mesh Terrain Editor/Creator, then click the TextureArray tab button. Or just right click in the hierarchy window and select GameObject -> 3D Object -> Mesh Terrain in the context menu.

Name	Name of the created mesh-terrain
File Format	File format of created mesh: *.obj, *.asset or *.fbx. It's recommended to use *.asset or *.fbx if the mesh has more than 120*120 vertices.
Output dir	The directory path that the mesh-terrain directory will be created in. All generated contents of the mesh-terrain will be put in OutputDir/Name/. The directory should be a child directory of /Assets
Create prefab	If checked, a prefab of the mesh-terrain will be created and instantiated in the scene. Otherwise the mesh-terrain will be created directly in the scene. It's recommended to create a prefab for the mesh-terrain.
Shader Type	Choose a shader type for the mesh-terrain. Note using wrong type that is not supported by current project will make the created mesh-terrain pink or invisible. For example, don't use URP shader type if you are working in a project using builtin pipeline.
Layer Count	Specify the number of texture layers of a mesh-terrain. You can only use 4 layers in free version.
Splat textures	Specify splat textures used in the created mesh-terrain.
Normal Maps	Specify corresponding normal maps.
Weight map size	Specify the size of the weight texture(s) formerly known as Control texture. This determines the quality of the painted texture: bigger size means better quality but more memory will be consumed. The size can be adjusted later with the Texture Adjuster
Splat texture tilling	Specify how many times a splat texture will be tiled along a direction. This value can be adjusted per splat texture later in the material editor of the mesh-terrain.
Vertex Count	Specify the number of vertices along an axis (x/z) direction.
Mesh size	Specify the size of the mesh-terrain. It is exactly the AABB size in x-z plane.
Create	Specify how to create the mesh-terrain: as a plane: all vertices of the mesh-terrain will share the same height. Base Height The y position of all the vertices in the mesh-terrain. from a height-map: sample heights from a height-map (in Alpha8 or R8 format) Height-Map The height map texture. Heightmap must be imported as Alpha8 or R8 format. For a single pixel, 0.0 corresponds to base-height and that 1.0 corresponds to base-height plus total-height. Note MTE will map the height map to all meshes as a whole when creating multiple copies with the same number of horizontal and vertical meshes. Base Height The lowest height of the vertices in the mesh-terrain. Total Height The total height of the mesh-terrain. This is used to calculate the actual height because the height-map is always normalized. from a curve: sample heights from a curve. Curve The Curve. Base Height The lowest height of the vertices in the mesh-terrain. Total Height The total height of the mesh-terrain. This is used to calculate the actual height because the curve is always normalized. Horizontal Will the curve along the horizontal(x) direction? Repeat Count How many times will the curve repeat on the created mesh-terrain? Note this won't work if the curve is set to be clamped.
Statistics	Vertex Count number of vertices in created mesh-terrain. Triangle Count number of triangles/faces in created mesh-terrain. Index Count number of indices in created mesh-terrain. It's three times of the triangle count. Cell/Tile Size cell/tile size of the created mesh-terrain. It is influenced by the mesh size and vertex count. It has an influence on how much height detail can be represented by the mesh-terrain. Texel Density Texel density of created mesh-terrain. Texel density means how many texels are displayed in 1 unit in model space when using specified Control texture size, Splat texture tilling and Mesh size. (Texel density) = (control texture size) / (mesh size) * (splat texture tilling).
Create Multiple Copies	If checked, a specified number of mesh-terrains will be created and tiled automatically. Otherwise only one will be created.

Usage steps

1. Specify the settings
2. Click Create. It may takes more than 1 minute to finish if more than 3*3 mesh-terrains are being created.
3. When finished, the mesh-terrain will be placed in the output dir. And the prefab of created mesh-terrain will be instantiated in the scene.

You can convert a Unity3D terrain into a mesh-terrain with MTE converter. The MTE Converter can be opened at menu Window -> Mesh Terrain Editor -> Converter. Or just right click on the terrain component header, choose Convert to mesh-terrain.

Name	Name of created mesh-terrain
File Format	File format of created mesh: *.obj, *.asset or *.fbx. It's recommended to use *.asset if the mesh has more than 120*120 vertices.
Output dir	The directory that the mesh-terrain directory will be created in. All generated contents of the mesh-terrain will be put in {OutputDir}/{Name}/. The directory should be a child directory of /Assets.
Mesh Only	Convert the Unity terrain to a mesh object with default material. No MTE shaders applied.
Export Trees	Export trees on original Unity3D terrain.
Use Texture Array	Check this to create texture array based mesh-terrain(s).
Shader Type	Choose the type of shader that will be used.
Shader	Display/Choose a costomized shader.
Vertex Count	Specify the number of vertices along an axis direction.
Split	Check this to split a Unity terrain into 2x2 to 8x8 mesh-terrains.
Overall Vertex Count	The number of all vertices of all tiled meshes that will be created after conversion.
Per-tile Statistics	See mesh-terrain statistics.

Usage Steps

1. Open the MTE Converter and click Terrain.
2. Specify the settings.
3. Click Begin Converting and wait a moment. It should finish in about 5-15 seconds.
4. When finished, the mesh-terrain will be saved in the output directory. And the prefab of converted mesh-terrain is instantiated in the scene.

If you got a terrain-like mesh that made with 3DSMax or other modeling software, you can convert it into a mesh-terrain using the MTE converter. The MTE Converter can be opened at menu Window -> Mesh Terrain Editor -> Converter.

Name	Name of created mesh-terrain
File Format	File format of created mesh: *.obj, *.asset or *.fbx. It's recommended to use *.asset if the mesh has more than 120*120 vertices.
Output dir	The directory path that the mesh-terrain directory will be created in. All generated contents of the mesh-terrain will be put in {OutputDir}/{Name}/. The directory should be a child directory of /Assets
Use Existing Mesh	If checked, instead of creating a new mesh by scanning, the original mesh will be adjusted per "Reuse an existing mesh". If the result is incorrect, please convert the mesh manually as described in that section.
Create prefab	If checked, a prefab of the mesh-terrain will be created and instantiated in the scene. Otherwise the mesh-terrain will be created directly in the scene. It's recommended to create a prefab for the mesh-terrain.
Shader Type	Specify shader type that will be used on converted mesh-terrain.
Layer Count	Specify the number of texture layers of a mesh-terrain. Only 4 different layer textures can be used in MTF Free.
Weight map size	Specify the size of the weight map(s), formerly known as control texture.
Vertex Count	Specify the number of vertices along an axis direction.
Statistics	See mesh-terrain statistics.

Usage Steps

1. Import your terrain mesh file into a project. Drag it into the hierarchy.
2. Open the MTE Converter and click Mesh.
3. Select the mesh GameObject(the one with a MeshRenderer component)
4. Specify the settings.
5. Click Begin Converting and wait a moment. It should finish in about 10-30 seconds.
6. When it is done, files of the mesh-terrain(including a mesh obj file, a mat file, several control texture file, a prefab file - if you have chosen Create prefab) is placed in the output dir. If Create prefab was checked, the prefab will be instantiated in the scene. Otherwise, a mesh-terrain will be created instead.
7. In the material editor of the mesh-terrain, assign splat textures and adjust the tilling of them.

Note: The actual number of control textures is determined by layer texture number. 2/3/4 layers result in 1 control texture; 5 layers result in 2 control textures.

First, please try using the converter and enable "Use Existing Mesh": it should work most of the time.

You can create a mesh-terrain that can be edited by Mesh Terrain Editor by hand. Here are the requirements:

Requirements for height tools:

• The mesh is an obj or asset file.
• The mesh uses +Y as it's height growing direction, namely y-up.
• The mesh GameObject in the scene has a valid MeshFilter and MeshCollider attached.

Requirements for texture painter and vertex color painter:

• The mesh file should contain a layer of uniformly spread uv.
• The min/max point of the bounding box in x and z should have the min/max uv. min uv: (0,0), max uv: (1,1).
• The mesh object in scene uses a similar shader with those provided by MTE. It is highly recommended that use a material created by MTE creator instead. See also FAQ: Can I change the shader?

Requirements for mesh toolbox:

• The mesh is an obj, asset or fbx file.

To convert your mesh to one that can be edited with MTE, just use the tools provided by MTE as described in the next section.

Many tools are provided to adjust an existing mesh's format, orientation, uv and pivot(origin), as well as tools to create or adjust weight maps.

• Q: What if I'm using .max, .blender or other formats that MTE doesn't support?
  A: Use the Mesh Saver to save your mesh as a supported format by MTE.

  Mesh Saver is a tool that can save a single mesh as *.obj, *.asset or *.fbx file. It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Mesh Saver.
  

  1. Drag your mesh object in scene to "Mesh".
  2. Choose a file format you want to use: *.obj, *.asset or *.fbx. It's recommended to use *.asset if the mesh has more than 120*120 vertices.
  3. Click SaveAs to save the mesh to another file.

• Q: What if my mesh is z-up?
  A: Use Mesh Z-up to Y-up Converter.

  Mesh Z-up to Y-up Converter is a tool that can convert a z-up mesh to a y-up one. It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Mesh Z-up to Y-up Converter
  

  1. Drag your mesh file, or exactly the mesh inside it, in the project window to the converter window.
  2. Click Begin Converting to convert the mesh to y-up.
  3. Click apply to save the mesh to file. Or, if you find something wrong, Click revert to cancel the modification. Again, please always remember to use a version control system to back up your file!

  It just rotates the mesh -90 degrees around z axis. And this operation doesn't work for all kinds of z-up meshes. You can try to rotate the mesh in scene view by assign rotation to (-90, 0, 0) to see if it is y-up after that. If it is, then this converter will work for your mesh.

• Q: What if my mesh's uv is not uniformly spread from (0,0) to (1,1)?
  A: Use Mesh UV Adjuster.

  Mesh UV Adjuster is a tool that can normalize uv of a mesh and invert u or v of a mesh. (uv means the texcoord of a mesh.) It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Mesh UV Adjuster
  

  1. Drag your mesh file, or exactly the mesh inside it, in the project window to the adjuster window.
  2. Click Normalize to normalize uv: spread uv uniformly from (0,0) to (1,1) on the mesh.
  3. Drag your mesh to the scene. Create a temp mesh-terrain and use its material for your mesh. Then try using the texture painter to paint on your mesh object. If the painting position is different from the mouse position. Try Inverting u or v of it:
     • Click Invert U to invert u of mesh texcoord: u becomes 1 - u.
     • Click Invert V to invert v of mesh texcoord: v becomes 1 - v.
  4. Click apply to save the mesh to file. Or, if you find something wrong, Click revert to cancel the modification. Again, please always remember to use a version control system to back up your file!

• Q: What if I want to adjust the pivot point of a converted mesh?
  A: Use Mesh Pivot Adjuster.

  Mesh Pivot Adjuster is a tool that can offset the pivot point, the (0,0,0) point in mesh space, of a mesh. It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Mesh Pivot Adjuster
  

  1. Drag the mesh into the scene first, so you can preview the changes.
  2. Drag the mesh in the project window to the adjuster window.
  3. Click one of the offset buttons to move mesh towards specific directions by its AABB box size in that axis.
  4. Click apply to save the mesh to file. Or, if you find something wrong, Click revert to cancel the modification. Again, please always remember to use a version control system to back up your file!

• Q: Where is Control (RGBA) and Control Extra (R) texture?
  A: Use Control Texture Creator.

  Control Texture Creator is a tool that can create control textures (SplatAlpha 0/1.png) used by MTE shaders. It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Control Texture Creator
  

  1. Select size of the control texture(s). Select the number of splat-textures.
  2. Click Create. Created control textures will be saved to Assets/.

• Q: How to resize/flip an existing control map?
  A: Use Texture Adjuster or click on the Adjust button beside the control map property.

  Texture Adjuster is a tool that can resize or flip a texture. It is located at menu item Window -> Mesh Terrain Editor -> Tools -> Texture Adjuster
  

  1. Select size of the control texture. Use original size if you don't want to resize.
  2. Select a filter mode when resizing.
  3. Drag the weight map to Texture field.
  4. Check "Control Texture", since we are adjust a control/weight map.
  5. Select a flip mode. If you don't want to flip the texture, select None.
  6. Click Begin Converting. Adjusted control texture will be saved to Assets/. You can then replace the old control map with the new one.

• Q: How to create or modify the albedo/roughness/normal/AO texture arrays?
  A: Create a PBRTextureArraySettings asset and create two kinds of texture arrays with it.

  PBRTextureArraySettings is an asset that stores layer texture list and other required information when creating texture arrays. It can be created via menu item Asset > Create > Mesh Terrain Editor > PBRTextureArraySettings
  

  Name	Name of the created texture arrays
  Texture Size	Specify the texture size of the texture arrays. Every texture assigned must have the same size as specified here.
  Layer Number	the number of texture layers inside the texture array. 2 to 12 layers texture array can be created here, but only 4-layer texture arrays can be used in MTE Free.
  Layer Textures List	albedo, roughness, normal and AO textures. One row represents a layer.

  Usage Steps

  1. Specify the settings and assign all textures. All texture slots should be assigned and cannot be empty.
  2. Click Create.
  3. When finished, two texture arrays will be placed aside the settings asset.
  4. Existing texture arrays can be updated, by changing its settings and create again.
     For example, if you want to change one texture in the texture arrays. Just select the settings asset of the texture array, and assign a new texture. Then click Create to update the texture arrays.

  The meaning of each channel of two texture arrays:

  • Albedo texture array: RGB albedo/base color/diffuse
  • RoughnessNormalAO texture array:
    R: Roughness
    GB: Normal, tangent space normal's XY, scaled from [-0.5, 0.5] to [0, 1] to be saved in textures
    AO: ambient occlusion

  Note You can press Ctrl + D to create a copy of this asset to reuse existing texture settings.

  Note Please keep the settings asset file next to the texture array created, its used by MTE editor to find layer textures. Also don't change the Name parameter of texture array settings when you finished creating a texture array, which is also required to find layer textures. Otherwise the texture array painter won't be able to load textures from a mesh-terrain that uses a texture array created from this settings asset.

The mesh-terrain filter is used to determine which GameObject should be considered to be a mesh-terrain that will be edited by MTE. Only mesh-terrains that match the filter, namely have the same layer and tag, will be edited. If no mesh-terrains match, the editor will show a warning message about that.

Usage

1. Set the layer and/or tag of the mesh-terrains you want to edit and click the Refresh Button. And after adding a new mesh into the scene or opening another scene, you need to click the refresh button to re-filter GameObjects in the scene manually.
2. Click the down triangle button, to open a list of GameObjects that passed the filter. You can check if your mesh-terrain passed the filter here.

Note Textures used by filtered mesh-terrains will be collected into the texture list displayed in the texture painter.

MTE Free users can only edit 2 mesh-terrains at once, but which 2 are not determined. Please use a definite tag and layer to make sure your GameObject(s) passed the filter.

Mode

• Filtered: paint on all mesh-terrains that match the tag and layer of the filter.
• Selected: paint on a selected mesh-terrain with custom UV, ignore the filter.

Note: after you have started painting on the same mesh, don't switch mode. The behavior hasn't been well tested and may cause error.

Brushes

Choose a brush from this brush list. When painting a texture, a brush act as a mask when apply the texture to the mesh-terrain.
You can add or remove the brushes by adding/removing the pictures in EditorResources\Brushes. Importer settings for brushes should be like this:

Then click to refresh the brushes.

Textures

Choose a texture from this texture list. When the filter is refreshed, all splat-textures used by mesh-terrains will be collected into the texture list. Only mesh-terrains using the selected texture can be painted. You can change the splat-textures in the material editor of a mesh-terran.

Hotkey is available: press NumPad Number 0/1/.../8 to choose a layer texture quickly.

Importer settings for a control texture (SplatAlpha 0/1.png) should be like this. (After generating control maps, MTE has set the import settings correctly. But some 3rd-party plugins or editor scripts may change the settings.)

Otherwise some error will occur when you trying to paint textures:

• When sRGB(Color Texture) is incorrectly checked:
  Dark area is rendered when two texture meet. Please refer to FAQ 13.
• When Read/Write Enabled is not checked:
  Get error UnityException: Texture 'SplatAlpha 0/1' is not readable, the texture memory can not be accessed from scripts.
• When Format is not set to RGBA:
  Rendering result is abnormal: the mesh becomes very dark or light or some layer has no effect.

Settings

Usage Steps

1. Set settings.
2. Choose a brush and texture.
3. Click and drag mouse to paint chosen texture with the brush on mesh-terrains in the scene view.
4. Changes will be saved instantly.

Related tools

• Snapshooter
  

  Window -> Mesh Terrain Editor -> Tools -> Snapshooter

  Capture a screenshot of a mesh-terrain from a top-down perspective into a png picture.

  A common usage is to create a base-map. It's a lower resolution composite image of the weight-blended layer textures. See this post for more information.

• Mesh to Terrain Converter
  

  Window -> Mesh Terrain Editor -> Tools -> Mesh to Terrain Converter

  Convert a mesh-terrain to a Unity terrain. A Unity terrain asset file will be output to Assets. Only support converting single non-texture-array mesh-terrain.

Note If you want to use a custom control texture not created by MTE, that's really impractical, See FAQ 14.

Brushes

First one is the painter. Second one is the eraser: erase the vertex color to white(R:1.0 G:1.0 B:1.0 A:1.0), the erased color is fixed to white.

Settings

Tools

• Fill Use this to fill all mesh-terrain with the selected color.
• Randomize Use this to fill all mesh-terrain with randomized colors.
• Attach VertexColor Use this to attach vertex color to a mesh-terrain. This tool can also be used to rebuild(clear) the vertex color of a mesh-terrain.

Usage Steps

1. At the beginning, you need to add a VertexColorInitializer component to the gameObject with mesh: Just select the gameObject and click Attach VertexColor.
2. Specify the settings.
3. Click and drag to draw on the vertex-colored mesh-terrains.
4. Changes to vertex colors will be saved instantly.

Warning MTE editor will not paint if the vertex color count in the asset file doesn't match the vertex count of the mesh. See also this post.

Note If you want to save the addition of vertex color component to the prefab, do remember to click Apply and Ctrl+S in the inspector of the mesh-terrain. By clicking Attach VertexColor, the addition only applies to the instance of the mesh-terrain in the scene.

Warning Do not check "Optimize Mesh" in the mesh importer settings, even if you have finished editing the vertex colors. The optimization by the mesh importer will possibly change the vertex count and makes the vertex colors not the same number as the vertex. This causes problems when editing and saving the vertex colors in the vertex color asset file. Also this will make the vertex colors not loaded at runtime.

Grass painter is not provided in MTE Free.

Grasses

Grass detail list

Select a grass detail, which defines the prototype of a grass, to paint.

⚙️Edit Details

Press to add/edit/remove grass details. Material material used on the grasses. MinWidth min width of a grass MaxWidth max width of a grass MinHeight min height of a grass MaxHeight max height of a grass Type Type of grass object OneQuad: each grass object is a quad: commonly used in billboard grass. ThreeQuad (star): each grass object is composed of three quads placed like a star. See GPU Gems Chapter 7. Rendering Countless Blades of Waving Grass.

Settings

Tools

• Create GrassLoader Create a GrassLoader GameObject. This tool will create a Assets/Grass.asset file used to save grass instance data. You can move it around after it is created. See also FAQ: What is done when attaching GrassLoader? This tool is only avaliable when there is no GrassLoader in opened scene.
• Attach GrassLoader Attach a GrassLoader component to selected GameObject, or try to fix the GrassLoader component on it. Note you cannot attach a GrassLoader to a GameObject with a MeshFilter. This tool is only available when there is no GrassLoader in opened scene.
• Bake Point Cloud Convert the painted grass point cloud to actual meshes. You will not be able to modify the point cloud after baking.

Usage Steps

1. Create an empty GameObject as the root of your grasses, then press Attach GrassLoader, choose a proper place (recommended aside the mesh-terrain file) for Grasses.asset, an GrassLoader will be attached to the object.
2. Press ⚙️Edit Details and select Add to add a grass detail.
3. Select a grass detail.
4. Click and drag to paint grasses. Hold Shift to erase grasses.
5. Press PageUp to undo and PageDown to redo.
6. IMPORTANT To save the scene containing any grass, do not press Ctrl + S. Instead, select the gameObject with GrassLoader, click 4. Clear Preview Grassses & Save Scene in the inspector. Otherwise the preview-only grasses will be saved into the scene.
7. To baking lightmap for grasses, use the buttons on the inspector of GrassLoader:
   
   Just press 1. 2. 3. 4. and all is done.

   1. Reload From File	Load GrassLoader's grass list from grasses.asset and re-generate preview grasses.
   2. Bake Lightmap	The same as the Generate Lighting in the Light Window.
   3. Save lightmap data	Save lightmap data to grasses.asset.
   4. Clear Preview Grassses & Save Scene	Remove preview grasses from the scene and save the scene.

Note Only one GrassLoader GameObject is allowed for each scene.

Note The height of grasses will be updated when you change the height of mesh-terrains.

Prefab

Prefab	Select a prefab to paint. MTE Free users can only use two prefabs.
⚙️Edit Prefab	Press to add/edit/remove prefab. Prefab the prefab object that will be used Scale the random scale value in axis X/Y/Z

Settings

Usage Steps

1. Create an empty GameObject as the container of objects and drag it into the Container field in the editor.
2. Press ⚙️Edit Prefab and select Add to add a prefab.
3. Select a prefab from the list.
4. In the scene, Click and drag to paint objects. Hold Shift to erase. Objects will be added as children of the container.
5. Press PageUp to undo and PageDown to redo.

Note Prefab without collider cannot be paint. Please add a collider to the prefab when painting, which can be removed later when finished painting.

Note The height of object will not be updated when you change the height of mesh-terrains, this is to be implemented in a future release.

Flow painter is not provided in MTE Free.

Flow-map used by MTE follows the same convention of Valve Flowmap

Mode

• Directional: Flow direction and strength is fixed.
• Movement: Normalized flow speed and direction is determined by mouse movement.
• Pinching/Inflating: Pinching or inflating flow.
• Vortex: Vortex flow.

Direction (for Direction mode)

	Click/Drag to adjust strength direction.
Strength	normalized flow strength
Angle	direction angle in degrees
	short-cut direction buttons

Settings

Tools

• Create Flowmap Create a flow map using current strength and direction. Created flow-map is output to FlowMap.png. Created flow-map is now fixed to 512x512. More options will be added in a future release.

Usage Steps

1. Make sure the material of the water surface contains a property named _FlowMap. And it is Read/Write Enabled in its import settings. MTE will edit this flow-map.
2. Also make sure that your direction is designed like this: +z is the north direction(90°). +x is the east direction(0°). If you found the flow direction is the opposite in Z, try adjusting the shader. Please refer to shader MTE/Legacy/WaterFlow provided by MTE.
3. • Directional: Select/Input a strength and direction. You can also hold Ctrl and scroll to adjust the direction.
   • Movement: Select/Input a strength.
   • Pinching/Inflating: Select/Input a strength. PressSpace to toggle between pinching and inflating.
   • Vortex: Select/Input a strength. PressSpace to toggle the direction of rotation.
4. Click and drag to paint flow.

Note Remember to move created FlowMap.png to a proper place, otherwise it will be overwritten when after pressing Create Flowmap.

Note Flow strength is shared among all modes.

Warning If auto-save is enabled, your changes to the mesh will be saved instantly and can never be undone. It is recommended to turn off auto-save when using mesh-toolbox.

Settings

Tools

MTE shaders are categorized by the rendering pipeline: Built-in and URP.

Builtin (shaders for built-in render pipeline)
   ├── Standard (standard shaders using partial PBR shading model)
   │      ├── 2/3/4/5Textures (2-5 layer shaders: support per-layer diffuse map, normal map and smoothness map/value. The 5th layer shares tilling/offset with 4th layer.)
   │      ├── 6/7/8Textures (6-8 layer shader: don't use as the performance is very bad)
   │      ├── Packed (experimental height-blending shader support 4 or 8 layers, "Packed" means pack height and albedo into one single texture)
   │      └── TextureArray (Texture-array-based shaders: support 4/8/12 layers; support albedo, roughness/smoothness, normal and AO textures packed inside two texture arrays)
   ├── Surface (surface shaders using Lambert or Blinn-Phong shading model)
   │      ├── 2/3/4/5Textures (2-5 layer shaders: support per-layer diffuse map, normal map and specular color. The 5th layer shares tilling/offset with 4th layer.)
   │      ├── 6/7/8Textures (6-8 layer shader: don't use as the performance is very bad)
   │      ├── Grass (demo-only grass shaders)
   │      ├── TextureArray (texture-array-based shaders)
   │      ├── Vertex-colored (demo-only shaders using vertex-color)
   │      └── WaterFlow.shader (demo-only water shader using flow-map)
   ├── Specialized (special shaders for certain old GPU)
   ├── Unlit (unlit shaders, support basic realtime shadow and baked light-map)
   └── MTECommon.hlsl (shared code for all builtin shaders)
URP (URP shaders, support PBR shading model - specular workflow)
   ├── 2/3/4/5Textures.shader (2-5 layer shaders: support per-layer diffuse map, normal map and smoothness map/value.)
   ├── 4Textures_height_blend_packed.shader (experimental height-blending shader support 4 layers, "packed" means pack height and albedo into one single texture)
   ├── 5Textures_DisplayNormal.shader (utility shader used to display blended normal output)
   ├── Grass.shader (demo-only grass shader)
   ├── TextureArray.shader (texture-array-based shader)
   ├── TextureArray_DisplayNormal.shader (utility shader used to display blended normal output)
   ├── TextureArray_Triplanar.shader (texture-array-based shaders, use triplanar mapping: don't use as the performance is very bad)
   └── VertexColor.shader (demo-only shaders using vertex-color)
MTECommonPBR.hlsl (shared code for all shaders support PBR features)

Don't use a shader that doesn't apply to the active render pipeline of your project, otherwise the result will be pink.

Texture Array based shader UI - MTETextureArrayShaderGUI

All shaders using texture array use this UI.

Open In ASE	Open the shader in ASE canvas to view and edit the shader.
Albedo	The texture array contains all albedo textures.
RoughnessNormalAO	The texture array contains all Roughness, Normal and AO textures. These textures are packed as described in The meaning of each channel of two texture arrays.
UV Scale Offset	Scale and offset of all layers.
Normal Intensity	Intensity of normal map. Only available for shaders Enabled Normal Intensity.
Layer Number	The number of layers will be used. Use the minimal number that meet your needs.
Weight Maps	The weight maps here are for preview only. Don't modify them manually if you don't understand the theory of weight maps. Click Adjust to adjust the control texture's size and orientation. If the shader uses multiple weight maps, make sure to use the same size for all of them before painting textures.
Enable Normal Intensity	Toggle to enable/disable Normal Intensity feature.

Legacy shader UI - MTEShaderGUI

All shaders using 2/3/4/5 separated textures use this UI.

You can open them in ASE canvas via clicking Open In ASE at the top of shader UI, to customize the shader in ASE.

The refresh button is used to generate an albedo&smoothness texture for each layer used by materials enabled Smoothness Texture. Albedo texture's RGB channel and Smoothness texture's Alpha channel will be merged into one single albedo&smoothness texture, which will be sampled in the shader.

For each layer, you can

• Assign its albedo(color/diffuse), smoothness and normal texture; The Albedo&Smoothness texture is for preview only. Use the refresh button above to generate it.
• Set its tilling and offset.
• Set its constant smoothness, this value will be multiplied with sampled value from smoothness texture in shaders support Smoothness Texture.
• Set its normal intensity, only available for shaders with normal maps and enabled Normal Intensity.

You can add one extra layer by clicking +.

Click Adjust next to the Control texture to open the Texture Adjuster, to adjust the control texture's size and orientation. If the shader uses multiple control textures, make sure to use the same size on all control textures.

(Only available for URP and Standard.) Toggle on/off Enable Smoothness Texture to enable/disable Smoothness Texture feature.

Toggle on/off Enable Normal Intensity to enable/disable Normal Intensity feature.

(Only available in Debug Mode.) You can toggle on default shader UI with (debug)Show Default Shader GUI at the bottom. Note the default shader UI might conflict with MTE's one.

Note For tiled mesh-terrains, please use the Tile Container UI, located at the inspector UI of the root GameObject, to toggle on Smoothness Texture feature and refresh albedo&smoothness textures.

Note For tiled mesh-terrains,

• Use the Tile Container UI, located at the inspector UI of the root GameObject, to toggle on Smoothness Texture feature and refresh albedo&smoothness textures.
• albedo&smoothness textures are determined by first tile, whose name ends with "_00_00", and all mesh-terrain tiles will shared the same layer textures.

If the shader has been modified or is a custom one, extra properties will be displayed at the bottom of UI.

All editing operations on the mesh or textures are undoable. Use PageUp to undo and PageDown to redo. Changes to the parameters on Editor GUI are not undoable.

You can use the history viewer(at menu Window/Mesh Terrain Editor/Tools/History Viewer) to inspect editing history.

Note On Mac, use Fn+↑ to undo, Fn+↓ to redo

Note Undo/redo data will be cleared after you saving the mesh.

Open Settings window via menu Window -> Mesh Terrain Editor -> Settings. Or click the settings button on the top of MTE Editor to open it.

Tools	Toggle those buttons to show or hide main tool buttons.
Use Compact GUI	Check this if you want the GUI elements to be compact like:
Point size	Set the size of (blinking) dots. The actual size can be previewed in the scene.
Show affected vertexes	Check this if you want to display the dots representing the vertexes being modifying.
Flash affected vertexes	Check this if you want to make the dots flash
Use circular brush	Toggle this to switch between circular and rectangular brush.
Show brush range	Check this if you want to see the border of the brush. (from +y to -y direction)
Show point normal	(for debug) Check this if you want to see the normal of editing vertexes.
Brush unit size	Set the size of one unit of the brush. By default, 1 unit = 1 tile size. The actual size can be previewed in the scene.
Use tile size	Check this if you want to use the tile size (calculated, maybe incorrect or inaccurate) as the brush unit size.
Mesh Smooth Angle	the smooth angle when calculating normals of mesh when MTE creating or saving mesh-terrains.
Language	Select the language of UI.
Auto Save Mesh	Check this if you want the changes to mesh be saved automatically. But there are some essential points should be aware of: Modified mesh-terrain(s) will be automatically saved when mouse is released. If the editor becomes noticeably laggy, please disable *Auto Save Mesh*. Note undo/redo is disabled when auto-save is enabled. Once a auto-save happens while you are editing mesh-terrains, you can no longer undo your changes. Undo/redo will be unreliable when auto-save every X minutes is enabled.
Debug Mode	Check this if you want to see MTE logs in the Console window about what is happening. It also enables some debug-only functions. It may harms performance though.

Note A dot will be drawn at the center of the scene, showing the size of the dot.

Note A rectangle will be drawn at the center of the scene (please click the +y cone to see that from +y to -y), showing the size of one brush unit.

The default language is English. But you can adjust the language and text content of the GUI.

• Change the Language:

  Open Settings window and change the language. Changing language will close all MTE windows and recompile your scripts. After that, the language will be changed to the one you just selected.

• Change UI Contents:
  1. Locate string table files in EditorResources\Languages\. There are two string table files: en-US.xml and zh-Hans.xml. Choose one you want to modify.
  2. Modify string file: For example, modify <Warning_Confirm>Are you sure?</Warning_Confirm> to <Warning_Confirm>You need to confirm this operation! Are you sure?</Warning_Confirm>
• Use a new language:
  1. Copy en-US.xml and rename it to, for example, ja-JP.xml or es-ES.xml.
  2. Translate the text in the copied string table, like what has been described in Change UI Contents.
  3. Reimport MTE.dll.
  4. After the import is finished. Open Settings window and change the language to the one you just added.

You can use the API in namespace MTE in your plugin editor scripts.

• Write a plugin for MTE-Editor [MTE Pro only]

  Just implement interface MTE.IEditor in a class. MTE Editor will load your implementation automatically. Please refer to existing IEditor implementations in MeshTerrainEditor\Plugins\Editor.

• Convert a Unity terrain to a legacy mesh-terrain
  

  public static void ConvertTerrainToMesh(GameObject terrainGameObject, string name, string outputDir, bool exportTrees, int vertexCountAlongAnEdge)
  {
      string terrainName = name ?? terrainGameObject.name;
      if (String.IsNullOrEmpty(terrainName))
      {
          terrainName = "terrain" + terrainGameObject.GetInstanceID();
      }
      TerrainConversionSettings settings = new TerrainConversionSettings
      {
          Name = terrainName,
          FileFormat = MeshFileFormat.obj,
          OutPutDir = PathEx.UnifySlash(outputDir),
          ExportTrees = exportTrees,
          VertexCountAlongAnEdge = vertexCountAlongAnEdge
      };
  
      ConvertTerrainToMesh(terrainGameObject, settings);
  }

1. I didn't see the Window/Mesh Terrain Editor in the menu!

   Please open the importer setting of Editor/MTE.dll. Then check if the Platform Settings->CPU is AnyCPU or corresponds to the using Unity3D. If you're not sure, just try changing that.

2. Why pressing Ctrl+Z will not redo?

   Use PageUp to undo and PageDown to redo. These keys are used instead of the famous Ctrl+Z because the undo system provided by Unity3D is just TOO SLOW for big data such as a big array. We will try to make Ctrl+Z/Y work in a future version. If you think this is annoying, please feedback.

   Please click the keyboard button on the top of MTE editor to confirm hotkeys.

3. I cannot edit. Not seeing flashing points or the brush texture/circle/rectangle.

   Try disabling and enabling the MeshCollider component. This problem seems to be caused by some interal bug of Unity physic system. It may happen when you reimport/save the mesh-terrain obj file.

4. Can I change the shader?

   Sure. But if you want to continue editing the mesh-terrain in MTE, you must follow conventions below.

   • To use the height tools(raise/lower, paint height, smooth height), make sure that the object has a valid mesh and MeshCollider attached.
   • To use the paint textures tool, make sure that the shader contains a Texture2D property named _Control and it is all red in the beginning. If you use a second control texture, the property name of it must be _ControlExtra and it is all black in the beginning. But I suggest you use the shaders provided by MTE as templates. The splat textures' property name should be _Splat0/1/2/3/4. If you are using a bumped shader, the property name of the normal textures should be _Normal0/1/2/3/4. We suggest you use the shaders provided by MTE and modify them as you see fit.
   • To use the vertex painter tool, make sure that the gameObject have a VertexColorInitializer component attached. (This script component is automatically attached to the gameObject using the button on the editor window. See the description of this tool.)
   • To use the flow painter tool, make sure that the shader uses a Texture2D property named _FlowMap as the flow-map.
   • To delete vertices with the mesh toolbox, make sure that the gameObject selected does NOT have a VertexColorInitializer component attached: you cannot cut holes on a vertex-colored mesh-terrain.

5. Hotkey not working!

   Does the scene view or the MTE editor has the focus? If not, the hotkey will not work.

   Have you closed the IME? It's the IME that is disturbing the hotkey handling routine and makes it not work. Close it.

6. I cannot unselect the mesh-terrain. / I cannot select other gameObjects.

   Please select other gameObject in the hierarchy window. MTE locked the selection in the scene view window to forbid mis-operation when editing the mesh-terrain.

7. What is done when adding vertex color component?

   This operation will create a asset file of the vertex colors aside the mesh file. And a VertexColorInitializer component will be attached to the gameObject.

   The component is used to apply vertex colors in the asset file to Mesh.colors when the gameObject is created. The source codes of the component and the asset are provided here: Plugins\Scripts\.

8. Why MTE Editor is closed when in play mode?

   Editing in play mode is not tested yet. So MTE editor is just closed before entering play mode to restrict possible misoperations.

9. Why there is a Material folder in the output dir when conversion finished?

   It's generated by Unity for previewing the mesh file in the inspector. You can safely remove it yourself.

10. The MTE Editor/Converter window disappeared when it loses focus on MacOS.

    This is by design of Unity3D and Apple. See also this post.

11. Can MTE paint more than 5 layer textures?

    Yes. Use the texture-array-based mesh-terrain, which support 2-12 layers.

12. What is done when attaching GrassLoader?

    This operation will create an asset file of painted grass data. A GrassLoader component will be attached to the selected object.

    GrassLoader component is used to create actual grass mesh objects when the object is created (in GrassLoader.Start). The source codes of the component and the asset are provided here: Plugins\Scripts\

13. There are dark borders between different splat-textures; where the different textures meet, it produces very dark areas.

    Please modified the importer settings of the Control texture: Don't check "sRGB (Color Texture)", then apply.

14. How to use custom control map?

    If you have a weight map exported from terrain creators like world creator, world machine and so on, you can replace the weight map used in mesh-terrain's material. Just make sure the replaced one is the same size and format as the old one: you can use the texture adjuster to do that.

    However, many users demands to use a hand-crafted weight map. But it's impossible to create a working control/weight map manually in an image editing software. Because a weight-map requires normalized channels, and almost all existing image editing software doesn't provide such a function. A hand-crafted non-normalized weight-map might look normal at the beginning, but later when you paint textures, black/dark/light/blockish areas will show up immediately. But if you insist, here are the steps for a 4-layer weight-map:

    1. Open SplatAlpha 0.png in your image editor.
    2. Modify，Make sure the sum of RGBA channel value is 255, i.e. normalized channels.
    3. Export a TGA format picture: SplatAlpha 0.tga
    4. Put SplatAlpha 0.tga into the Unity project.
    5. Save the texture as a copy in PNG format with Texture Adjuster at menu Window/Mesh Terrain Editor/Tools/Texture Adjuster.
    6. Assign saved SplatAlpha 0.png back to original mesh-terrain's material's Control property.

15. Where is the Editor Log?

    The folder containing editor log can be opened by click the menu item Window/Mesh Terrain Editor/Debug/Open Editor Log

    Editor.log and Editor-prev.log are editor log files.

2022-05-30 v4.0.0

Submit issues or request new features at MTE issue tracker on GitHub.

(Recommended) Join MTE Discord Server to chat with the author and MTE users.

Contact the author via zwcloud@hotmail.com or post on the forum thread.

• MTE intro video(YouTube)

• Some brushes used in texture painter are from Unity3D's terrain brushes.
• Some brushes used in texture painter are from FlamingSands' Generic Terrain Brushes.
• NormalSolver by Charis Marangos
• Animated Water Shader by Stanislaw Adaszewski.
• CSharpQuadTree
• UnityURPUnlitScreenSpaceDecalShader by ColinLeung-NiloCat: Unity unlit screen space decal shader for URP.
• Unity_Texture2DArrayGenerator by XJINE: provides function or editor to make a Texture2DArray.
• EditModeIntervalCallbacks by Glurth.

MTE专业版用户，请首先在您的机器上激活此副本。

MTE的包导入后无需进一步安装，您可以直接开始使用Mesh Terrain Editor. 但是在第一次使用各项功能前，建议先查看相关的文档。并且请注意以下几点：

• 如果您遇到问题，请首先阅读相关文档和常问问题。如果还是不能解决问题，请随时联系作者获得支持。
• MTE会根据系统语言自动设置界面语言，不过有可能会失效，可以自行到设置界面为简体中文，具体请参考 自定义UI语言。
• MTE会修改你的模型和相关文件。在编辑和保存的过程中，你的文件可能会在某些罕见的情况下被破坏。请一定要使用版本控制系统（如SVN、GIT）来管理你的工程文件。无论如何，备份文件是特别重要的事情！
• 如果某个obj模型需要被MTE编辑，在此模型的导入选项中，不要选中Optimize Mesh。Importer对模型的优化很可能会更改顶点数量和索引顺序。此类优化会导致模型数据和文件中数据的不一致，进而导致在使用MTE编辑时，产生各种严重的问题，无法进行编辑。
• 在点击“保存”按钮保存模型之前，所有编辑操作都是可以撤销的。保存模型后编辑历史将会被清空。注意，如果启用了自动保存，撤销重做功能也会在自动保存发生时失效！
• 请注意笔刷的大小的单位尺寸可以在设置 > 笔刷单位中设置。 (实际笔刷大小) = (笔刷大小) * (笔刷单位). 所以您可以在开始编辑前调整好笔刷的单位大小，建议使用网格的单个格子大小作为单位大小。（对于非MTE创建的模型，MTE所计算的格子大小可能不正确或不合适，请自行调整。）

Mesh Terrain Editor的主菜单位于Window/Mesh Terrain Editor，通过点击菜单的各个条目，可以打开MTE的各项功能窗口进行使用。

• Mesh Terrain Editor
  
  • Creator: 创建工具，用于创建一个或多个平铺的“MTE地表模型”，创建的是平面，或从高度图创建，或者从一条曲线创建。
  • Convertor: 转换器，用于将Unity地形或地形形状的模型转换成“MTE地表模型”
  • Editor: 编辑器，用于编辑“MTE地表模型”
  • Settings: 设置，修改总体设置
  • Tools: 工具，用于MTE地表模型的工具
  • Support: 帮助，关于、文档、论坛、问题反馈；MTE专业版激活；检查更新
  • Debug: 调试功能，一些用于探查MTE出现问题时的原因的功能
  • Check for Updates: 检查更新
  • Activation打开对话框，用于在此机器上激活或反激活MTE专业版
  • Help: 打开此文档
  • About: 查看MTE的致谢名单和版本信息
• Tools 工具
  
  • 历史查看器
  • 模型数据查看器: 用于查看地表模型统计数据的工具
  • 快照工具以MTE模型地形的顶部为视角，拍照保存为贴图。
  • MTE地表模型到地形的转换器
  • 将现有模型手动转换“MTE地表模型”时所需要的工具。详情请参考从一般模型创建MTE地表模型。
    • Mesh saver
    • Mesh Z-Up to Y-UP Converter
    • Mesh Pivot Adjuster
    • Mesh UV Adjuster
    • Control Texture Creator
    • Texture Adjuster
  • 一些提供给特定用户使用的工具，如果不清楚用法就不要使用它们。
    • Mesh Tilling Baker
    • Texture Channel Packer
    • Texture Channel Packer Ex
    • Texture2DArray Generator: 注意MTE不用这个工具创建贴图数组，请按照这里的步骤创建。
• Support
  
  • Documentation: 文档，你现在正在阅读的。
  • Welcome Window: 欢迎窗口，在Unity编辑器启动时会出现。
  • Forum: 论坛。用于和作者以及其他用户交流的论坛；并且当新版本发布时，论坛里会发一篇公告。
  • Instant Messaging: 即时交流（QQ群），如果您希望能和作者实时交流关于MTE的话题，请点击加入MTE官方QQ群 689511734
  • Feature Request & Bug Report: 新功能提议和Bug报告。
• Debug
  
  • Reset Mesh Terrain Editor: 重置MTE编辑器状态，注意此功能会引起一次代码编译。
  • Open Editor Log: 打开Unity的编辑器日志目录。

Editor
	└── MTE.dll (MTE编辑器库)
Editor Resources (MTE编辑器资源文件)
    │   MTE_EDITOR_RESOURCE_LOCATION.txt (编辑器资源文件定位文件，不要删除或者将其移出此文件夹)
    │   mte.ico (MTE图标文件)
    ├── Brushes (笔刷模板图像文件)
    │	├── brush_00.png
    │	├── brush_01.png
    │   │   ...
    │	└── brush_55.png
    ├── Details (草、对象绘制工具的模板列表文件)
    ├── Languages (语言文件)
    │	├── en-US.xml (英语-美国)
    │	└── zh-Hans.xml (汉语-简体)
	└── Shaders (编辑器使用的shader)
Plugins (MTE插件代码和资源文件)
    ├── Editor (编辑器插件代码)
	├── Scripts (运行时代码)
    └── Resources
		└── Grass (草的原型模型，用于生成草的实例)
Shaders
	├── Builtin (旧式standard/surface shader, 不受光shader)
	├── URP (通用渲染管线URP shader)
	└── MTE Common.cginc (MTE通用shader代码)
MTE_ReadMe.htm (此文件)

模型地形编辑器（Mesh Terrain Editor，MTE）有三个主要功能：

• MTE创建工具：用于直接创建MTE模型地表。
• MTE转换器：用于将MTE的地形对象、一般模型转换为MTE模型地表。
• MTE编辑器：用于编辑MTE模型地表，包含高度工具、纹理绘制工具、顶点颜色绘制工具、草绘制工具、对象（预制）绘制工具、流动图绘制工具、模型工具。

MTE地表只是一个使用了特殊地形shader的模型。MTE提供的shader包括支持2/3/4/5层贴图混合的shader和支持2~12层贴图混合的基于贴图数组的shader. 一个MTE地表只用一个drawcall.

有两种MTE地表可以创建：

• Legacy 旧式: 2/3/4/5层贴图混合的MTE模型地表。
• TextureArray 基于贴图数组: 2到12层贴图混合的MTE模型地表。因为使用了贴图数组，需要支持OpenGLES3.0以上的设备。

MTE转换工具从菜单Window -> Mesh Terrain Editor -> Converter打开。或者在Terrain组件头右键菜单中选择Convert to mesh-terrain.

选项

使用步骤

1. 打开MTE转换器，点击Terrain.
2. 设置选项。选中“使用贴图数组”。
3. 点击开始转换 然后等待一会儿。转换过程一般在5-15秒钟内完成。
4. 转换完成后，MTE地表的相关文件将被放到指定的输出目录中。MTE地表对象的预置的实例将被创建在场景中。

使用MTE创建工具来直接创建MTE地表. 通过菜单Window/Mesh Terrain Editor/Creator打开MTE创建工具，然后在顶部点击Legacy按钮。或者直接在层级窗口中通过右键菜单GameObject -> 3D Object -> Mesh Terrain打开。

Name 名称	创建的MTE地表的名称
File Format 文件格式	所创建的mesh的文件格式： *.obj、*.asset或*.fbx. 如果模型的顶点数多于120*120，推荐使用*.asset格式。
Output dir 输出文件夹	MTE地表的所有文件会被输出到{输出文件夹}/{名称}/路径下。此路径必须在工程文件夹下的Assets目录中。
Create prefab 创建预置	如果选中，MTE地表的预置会被创建到输出文件夹中，并且在场景中实例化。否则，MTE地表会直接创建在场景中。 推荐选中此项。
Shader Type Shader类型	为MTE地表选择一种shader类型。注意不要错误地选择当前工程不支持的类型，否则创建出来的MTE地表会是粉色或不可见的。比如，不要在使用内建管线的工程中使用URP Shader类型。
Layer Count 层贴图数量	指定层贴图的数量。在MTE免费版中，只可以使用4张贴图。
Splat textures 层贴图	指定在创建的MTE地表上使用的贴图。
Normal Maps 法线贴图	指定对应的法线贴图。
Splat textures 权重图大小	指定权重图的大小。此值决定了绘制贴图的质量：更大的权重图会有更好的质量，但是会占用更多的存储空间。
贴图平铺数(Tilling)	指定贴图沿着一个方向平铺的数量。此值可以在创建完成后，在MTE地表的材质编辑器中逐个进行调整。
顶点数	指定沿一个轴(x/z)方向上的顶点的数量。
模型大小	指定MTE地表的大小。此大小和生成的模型的包围盒的x/z的大小完全相同
创建	指定如何创建MTE地表 作为平面：MTE地表上的所有顶点有相同的高度。 基础高度 所有顶点的高度(y值)。 从高度图：从高度图（Alpha8或R8格式）创建 高度图 高度图纹理。 高度图必须以Alpha8或R8格式导入。对单个像素，值0对应着基础高度，而值1.0对应着 基础高度+总高度。 Note 如果选择了“创建多个副本”并且水平方向和垂直方向的副本数相同，高度图会应用到所有平铺模型组成的整体上。 基础高度 MTE地表的顶点的最低高度 总高度 MTE地表的总高度。该值用于计算实际高度，因为高度图总是被标准化的（值在[0,1]的范围内）。 从曲线创建：从曲线采样高度 曲线 待采样的曲线 基础高度 MTE地表的顶点的最低高度 总高度 MTE地表的总高度。该值用于计算实际高度，因为曲线总是被标准化的（值在[0,1]的范围内）。 水平 曲线是沿着水平方向(x轴)还是竖直方向(z轴)？ 重复次数 曲线在创建的MTE地表上的重复次数。注意，当曲线设置为clamped(截断的)时，此选项无效。
统计数据	顶点数量 显示创建的MTE地表实际包含的顶点数 三角形/面数 显示创建的MTE地表的三角形/面数 索引数 显示创建的MTE地表的索引数。一定是三角形/面数的3倍。 格子/瓦片大小 显示创建的MTE地表的格子/瓦片大小。受模型大小和顶点数量的影响，影响着模型形状的精细程度。越小越精细。 纹理像素密度 显示创建的MTE地表的纹理像素密度。 纹理像素密度表示，在模型空间的一个单位上所显示的纹理像素(texel)的数量， 受到权重图大小, 层次贴图平铺数和模型大小的影响。 计算公式为(纹理像素密度) = (权重图大小) / (模型大小) * (层次贴图平铺数)
创建多个副本	如果选中，指定数量的MTE地表会被创建，并且会自动进行平铺。否则只有一个MTE地表被创建。

使用步骤

1. 指定设置
2. 点击创建. 如果创建多个副本并且数量超过3*3个，创建过程可能需要1分钟以上。
3. 完成后，MTE地表的相关文件会放到指定的输出目录中。MTE地表对象会创建在场景中。

如果您想将现有的Unity地形转换为MTE地表，可以使用MTE转换工具。MTE转换工具可以从菜单Window -> Mesh Terrain Editor -> Converter打开。或者在Terrain组件头右键菜单中选择Convert to MTE地表.

名称	创建的MTE地表的名称
文件格式	创建的mesh的文件格式： *.obj、*.asset或*.fbx. 如果模型的顶点数多于120*120，推荐使用*.asset格式。
只生成模型	将Unity地形转换为具有默认材质的模型对象。不会应用MTE的shader.
输出树	输出原Unity3D地形上的树。
选择输出文件夹	MTE地表的所有文件会被输出到{输出文件夹}/{名称}/路径下。此路径必须在工程文件夹下的Assets目录中。
切分	选中此项来将Unity地形切分为2x2到8x8份模型
总顶点数	转换后创建的所有平铺的模型的总顶点数量
统计数据	参见MTE地表 统计数据。

使用步骤

1. 打开MTE转换器，点击Terrain.
2. 设置选项。
3. 点击开始转换 然后等待一会儿。转换过程一般在5-15秒钟内完成。
4. 转换完成后，MTE地表的相关文件将被放到指定的输出目录中。MTE地表对象的预置的实例将被创建在场景中。

MTE免费版用户只能转换使用4张不同贴图的Unity地形。

您可以使用MTE转换器，将已有模型（如从3ds Max中导出的fbx模型）转换为MTE地表. MTE转换工具可以从菜单Window -> Mesh Terrain Editor -> Converter打开。

名称	创建的MTE地表的名称
文件格式	所创建的mesh的文件格式： *.obj、*.asset或*.fbx. 如果模型的顶点数多于120*120，推荐使用*.asset格式。
使用现有模型	如果选中，转换时将不会通过扫描新建模型，而是按照下一节“从一般模型创建MTE地表模型”所述自动对现有模型进行转化。如果结果不正确，请手动使用此节提到的工具进行转换。
选择输出文件夹	MTE地表的所有文件会被输出到{输出文件夹}/{名称}/路径下。此路径必须在工程文件夹下的Assets目录中。
创建预置	如果选中，MTE地表的预置会被创建到输出文件夹中，并且在场景中实例化。否则，MTE地表会直接创建在场景中。推荐选中此项。
Shader类型	指定转换得到的MTE地表的材质的shader的类型。
层贴图数量	指定层贴图的数量。MTE免费版用户只可以使用4张不同的贴图。
权重图大小	指定权重图的大小。
顶点数	指定沿一个坐标轴方向的顶点的数量。
统计数据	参见MTE模型地表统计数据。

使用步骤

1. 导入您的模型文件到工程中，将模型拖动到场景（hierarchy）中。
2. 打开MTE转换器，然后点击Mesh
3. 选中模型对象（带有MeshRenderer组件的那个对象）
4. 设置选项。
5. 点击开始转换 然后等待一会儿。转换过程一般在10-30秒钟内完成。
6. 转换完成后，MTE地表的相关文件将被放到指定的输出目录中。MTE地表对象将被创建在场景中。如果之前选中了创建预置，那么MTE地表预置的实例将被创建在场景中。
7. 在MTE地表的材质编辑器中，赋予层贴图并设置合适的tilling值.

注意 权重图的实际数量由贴图数量决定。对于2/3/4张贴图，转换后权重图的数量为1；对于5张贴图，转换后的权重图的数量为2.

首先，请尝试使用将现有模型转换为MTE模型地表，启用"使用现有模型"选项：在大部分情况下会得到期望的结果。如果结果不正常，请参考以下内容：

可被Mesh Terrain Editor编辑的模型的一些要求：

使用高度工具:

• 模型文件为obj或asset格式。
• 模型使用 +Y 作为地形高度增长方向，也就是Y-up
• 场景中的模型对象上附有有效的MeshFilter和MeshCollider组件。

使用贴图绘制工具和顶点颜色绘制工具:

• 模型文件应该包含一层均匀分布的纹理坐标。
• 模型的AABB的最大（小）点，在x和z轴上，应该拥有最大（小）纹理坐标。 最小纹理坐标: (0,0), 最大纹理坐标: (1,1).
• 场景中的模型对象使用类似MTE提供的shader. 建议使用MTE的shader作为模板进行修改。 参见常问问题： 我可以更改shader吗？

使用模型工具:

• 模型文件为obj、asset或fbx格式。

您可以使用MTE提供的一些工具逐渐将模型转换为可被MTE编辑器编辑的MTE地表.

MTE提供了很多用于调整现有模型的格式、朝向、UV和原点的工具。也有工具可以创建或调整现有的权重图。

• 问: 如果我的模型是.max, .blend或其他不被MTE支持的格式，怎么办？
  答: 使用模型保存工具（Mesh Saver）。

  模型保存工具 可以将单个模型保存为obj、asset或fbx格式。位于菜单Window -> Mesh Terrain Editor -> Tools -> Mesh Saver.
  

  1. 将模型对象从场景中拖拽到Mesh
  2. 选择要使用模型文件格式： *.obj、*.asset或*.fbx. 如果模型的顶点数多于120*120，推荐使用asset或fbx格式。
  3. 点击 另存为 将模型对象保存到指定文件中。

• 问: 如果我的模型以z正方向为上，怎么办？
  答： 使用Z-up模型转Y-up模型工具（Mesh Z-up to Y-up Converter）。

  Z-up模型转Y-up模型工具 可以进模型从以z+为上转换为以y+为上方向。位于菜单项Window -> Mesh Terrain Editor -> Tools -> Mesh Z-up to Y-up Converter
  

  1. 从Project窗口中，拖拽模型文件（其中的模型）到转换器窗口中。
  2. 点击开始转换转换模型
  3. 点击apply将转换结果保存到文件中，或者点击 revert 取消修改。 再次提醒，请记得使用版本控制系统来备份您的文件！

  此工具只是将模型绕z轴旋转90度。该操作不会适用于所有z+为上的模型。您可以首先尝试在场景中设置模型对象的旋转为(-90, 0, 0)，查看模型的上方向是否是+y方向。如果是的，那么此工具对该模型有效。

• 问： 如果我的模型的纹理坐标不是从(0,0)到(1,1)均匀分布的？
  答： 使用模型UV调整工具（Mesh UV Adjuster）。

  模型UV调整工具 可以均匀化模型的纹理坐标，并且可以倒置u或者v纹理坐标。 (uv 指纹理坐标的两个轴。) 位于菜单项 Window -> Mesh Terrain Editor -> Tools -> Mesh UV Adjuster
  

  1. 从Project窗口中，拖拽模型文件（其中的模型）到转换器窗口中。
  2. 点击Normalize均匀化纹理坐标：将纹理坐标均匀地在模型上铺开，从(0,0) 到 (1,1)。
  3. 将您的模型拖动到场景中。使用MTE创建工具创建一个临时的MTE地表对象，给你的模型对象使用其材质。然后尝试使用MTE的贴图绘制工具绘制贴图。如果绘制的位置和鼠标的位置不同，请尝试倒置模型的u或者v纹理坐标：
     • 点击Invert U倒置模型的u纹理坐标: u 变成了 1 - u.
     • 点击Invert V>倒置模型的v纹理坐标: v 变成了 1 - v.
  4. 点击 apply 将修改存储到文件中。 或者点击revert取消修改。

• 问： 如果我想调整转换后的模型的基准点（枢轴点），怎么办？
  答： 使用模型基准点(Pivot)调整工具（Mesh Pivot Adjuster）。

  模型基准点调整工具 可以平移模型的基准点，也就是模型空间中的(0,0,0)点。 位于菜单项 Window -> Mesh Terrain Editor -> Tools -> Mesh Pivot Adjuster
  

  1. 从Project窗口中，拖拽模型文件（其中的模型）到工具窗口中。
  2. 点击下方的按钮按照指定方向移动模型，模型会按照相应轴上AABB包围盒的尺寸进行移动。
  3. 点击 apply 将修改存储到文件中。 或者点击revert取消修改。

• 问： shader中的Control (RGBA) 和 Control Extra (R) 在哪？
  答： 使用权重图创建工具（Control Texture Creator）。

  权重图创建工具 可以创建MTE地形shader使用的权重图(SplatAlpha 0/1.png)。位于菜单项Window -> Mesh Terrain Editor -> Tools -> Control Texture Creator
  

  1. 选择权重图的大小；选择贴图数量。
  2. 点击 创建。创建的权重图会被保存在Assets/目录下。

• 问： 如何调整权重图的大小，或者翻转它？
  答：使用贴图调整工具（Texture Adjuster）。

  贴图调整工具 可以调整权重图的大小，或者翻转它。 位于菜单项Window -> Mesh Terrain Editor -> Tools -> Texture Adjuster 点击权重图属性旁的“调整”按钮也能打开它。
  

  1. 选择权重图的大小。 如果不要调整大小就选择原来的大小；
  2. 选择调整大小时的过滤模式（不需要调整时可以忽略）；
  3. 将权重图拖放到“Texture”；
  4. 要调整的是一张（控制图）权重图，所以要选中“权重图”；
  5. 选择翻转模式。如果不需要翻转贴图，就选择"None"；
  6. 点击开始转换按钮。调整后的权重图会被保存到Assets/。然后就可以用这个新的权重图替换原来的了。

• 问：如何创建或修改颜色和粗糙度/法线/AO贴图数组？
  答：创建PBRTextureArraySettings文件，然后借助它创建两种贴图数组。

  PBRTextureArraySettings 是一种保存了层贴图列表的资产文件，包含创建贴图数组必需的信息。以下简称settings文件，或者“贴图数组配置文件”。它可以通过菜单Asset > Create > Mesh Terrain Editor > PBRTextureArraySettings创建。
  

  Name 名字	指定贴图数组的名字
  Texture Size 贴图大小	指定贴图数组中贴图的大小。每张赋予的贴图都要和这里指定的大小相同。
  Layer Number 层数	贴图数组中贴图的层数。可以创建2~12层的贴图数组，但MTE免费版用户只能使用4层的贴图数组。
  贴图列表	颜色、粗糙度、法线和AO贴图的列表。每一行代表一层。

  使用步骤

  1. 指定好设置，赋予所有贴图。所有贴图格子都要赋予，不能有空的。
  2. 点击 创建.
  3. 完成后，两个贴图数组就会保存到settings文件的旁边。
  4. 已经创建的贴图数组可以通过更新贴图再点创建按钮来更新。
     举例来说，如果需要更换贴图数组中的一张贴图，选中settings文件，在界面中替换贴图然后点创建，就能更新贴图数组了。

  两个贴图数组的RGBA通道含义

  • Albedo 颜色贴图数组： RGB 颜色
  • RoughnessNormalAO 粗糙度、法线、AO贴图数组：
    R: 粗糙度
    GB: 法线（切线空间法线的XY值，并且从[-0.5, 0.5]缩放到了[0,1]范围内以便存储）
    AO: 环境光遮蔽
    

  注意 你可以选中asset文件后，按Ctrl + D 创建一份已有贴图设置asset的复制来复用之前的配置。

  注意 请将贴图配置文件放到贴图数组的旁边，它会被MTE编辑器用于查找其包含的层贴图。并且，在创建完贴图数组后，不要更改配置文件的“名字 Name”参数，否则MTE编辑器会找不到对应的贴图文件。如果找不到，在编辑器中就无法正常看到MTE模型地表使用的贴图数组对应的贴图，也就不能去刷贴图了。

筛选器的作用是确定哪些模型对象会被当作可被MTE编辑器编辑的模型。只有tag和layer符合筛选器的对象才会被编辑。如果没有任何对象符合MTE编辑器的tag和layer，编辑器界面上就会出现警告信息。

使用方法

1. 设置筛选器的layer和tag与你的MTE地表相同，然后点击刷新筛选按钮即可。当你往场景里新增了模型或者打开了新的场景时，需要手动点击刷新按钮来重新筛选场景中的对象。
2. 点击下三角按钮，打开通过了筛选的GameObject列表。您可以检查通过筛选的GameObject是否包含了要编辑的MTE模型地表。

注意 建议单独创建一个tag或layer专门用于存放MTE地表，以免和其他模型混淆而产生问题。如果一个普通模型和MTE地表使用了相同的tag和layer并且都符合筛选器，MTE编辑器就会同时编辑这两个模型，这种情况下，会导致很多意外情况出现，比如普通模型保存出错，免费版本用户无法编辑任何MTE地表，因为已经有两个模型通过了筛选成为了编辑目标。

注意 通过筛选的MTE地表上的贴图会被收集到贴图绘制工具中，在其界面上显示。

MTE Free用户只能同时编辑两个模型，但是是哪两个是不确定的，请确保您的MTE地表通过了筛选。请使用确切的tag和layer来确保您的对象通过了筛选。

模式

• 筛选多个: 在所有符合筛选器tag和layer的MTE地表上绘制贴图，不支持自定义UV.
• 单个选中: 在选中的MTE地表上绘制贴图，支持自定义UV的模型，忽略筛选器。

注意 当你已经开始在某模型上绘制之后，不要切换模式。这类行为没有进行过完备的测试，可能会引起错误。

笔刷

选择要使用的笔刷，这里列出了所有可用的笔刷。绘制贴图时，选中的笔刷将会作为模板应用到贴图上。
您可以添加或删除笔刷：添加或删除EditorResources\Brushes中的图片，所有笔刷图片的导入选项：

然后点击 刷新笔刷。

快捷键：使用小键盘数字键0到8来快速切换贴图。

贴图

选择要绘制的贴图，这里列出了所有可用的贴图。当筛选器刷新时，所有被MTE地表使用的溅斑(Splat)贴图会被收集到这个列表中。只有当某个MTE地表使用了选择的贴图，此贴图才能绘制到那个MTE地表上。

权重图（SplatAlpha 0/1.png）的导入设置应该如下设置（MTE在生成权重图时已经正确设置，但一些其他的插件或者编辑器脚本可能会修改此设置）：

否则当你绘制贴图时，会产生一些问题：

• 当sRGB(Color Texture)被错误地选中时:
  绘制的贴图的交界处会有黑边。请参考常问问题13.
• 当Read/Write Enabled 没有选中时:
  发生错误UnityException: Texture 'SplatAlpha 0/1' is not readable, the texture memory can not be accessed from scripts.
• 当Format没有设置为RGBA时:
  渲染的地表的结果不正常：模型变得非常黑或者明亮，或者一些层不起作用。

设置

使用步骤

1. 指定设置；
2. 选中一个笔刷和要绘制的贴图；
3. 在场景中的MTE地表上点击、拖动鼠标来绘制贴图。
4. 修改会立刻保存。

相关工具

• 快照工具
  

  Window -> Mesh Terrain Editor -> Tools -> Snapshooter

  以MTE模型地形的顶部为视角，拍照保存为贴图。

  常见用法是用于生成BaseMap. BaseMap是将层贴图按权重图进行混合后得到的组合图像。详情请参考此贴（英文）。

• 模型转地形工具
  

  Window -> Mesh Terrain Editor -> Tools -> Mesh to Terrain Converter

  将指定的MTE地表转换为Unity地形。Unity地形文件会被保存到Assets目录下。只支持转换单个MTE模型地表（不支持贴图数组）。

Note 如果你想用自己画的权重图（SplatAlpha0/1.png）而不是MTE生成，很遗憾这个想法是不切实际的，请参考常问问题 14.

笔刷

第一个是绘制，第二个是橡皮擦。使用橡皮擦会将顶点颜色擦至纯白色(R:1.0 G:1.0 B:1.0 A:1.0)，这个颜色是固定白色的。

选项

工具

• 填充 使用此工具来填充所有MTE地表为当前颜色。
• 随机化 使用此工具以随机生成的颜色填充所有MTE地表。
• 附加顶点颜色 选中单个MTE地表后，可使用此工具添加顶点颜色相关组件到MTE地表的GameObject上。此工具也可用于重建MTE地表的顶点颜色组件。（请注意重建时会删除原来的颜色）

使用步骤

1. 在一开始，您需要向MTE地表添加VertexColorInitializer组件：请使用附加顶点颜色工具来添加;
2. 设置选项;
3. 在MTE地表上点击、拖动鼠标来绘制顶点颜色。
4. 对顶点颜色的修改会马上被保存。

警告 如果asset文件中的颜色的数量和模型的顶点数不同，MTE编辑器将不会绘制顶点颜色。请参考此贴（英文）。

注意 如果要将添加的vertex color组件保存到预置体上， 请记得点击预置体inspector中的Apply并Ctrl+S 使用Attach VertexColor只会将此修改应用到场景中的预置体实例。

重要提醒 在模型的导入选项中，不要选中“Optimize Mesh”。 否则Importer对模型的很可能会更改顶点数量和索引顺序。此类优化会导致模型数据和文件中数据的不一致，进而导致在使用MTE编辑顶点颜色时，顶点颜色的数量和顶点数量不一致。这也会导致在运行时无法正确加载顶点颜色。并且，因为类似的原因，已经使用了顶点颜色的MTE地表无法被挖洞。

草绘制工具在免费版中不可用。

草

Grass detail list	选中绘制时要使用的草的原型
Edit Details	点击添加/编辑/删除草detail. 材质 草的材质 最小宽度 单个草的最小宽度 最大宽度 单个草的最大宽度 最小高度 单个草的最小高度 最大高度 单个草的最大高度 类型 草的类型 OneQuad(单片)： 每棵草由一片草片构成，一般用于billboard草。 ThreeQuad(三片星型)： 每棵草由三片草片构成。请参考GPU Gems Chapter 7. Rendering Countless Blades of Waving Grass

设置

工具

• 创建GrassLoader 创建一个附带GrassLoader组件的对象。此工具会创建文件Assets/Grass.asset，用于保存所绘制的草的实例信息。创建出的文件可以自由移动。 请参考常问问题12: 添加GrassLoader时，发生了什么？ 此工具只在场景中不存在GrassLoader时可用。
• 附加GrassLoader 附加GrassLoader组件到选中的对象上，或尝试修复它上面的GrassLoader. 无法将GrassLoader附加到含有MeshFilter的GameObject上。此工具只在场景中不存在GrassLoader时可用。
• 点云转模型 将绘制的点云转换为实际的草模型，转换后无法继续编辑点云。

使用步骤

1. 创建一个空GameObject作为所有草的根结点，然后点击附加GrassLoader， 为Grasses.asset文件选择合适的位置（比如地形模型文件旁），GrassLoader组件就会被添加到此对象上。
2. 点击⚙️编辑草选择添加 添加一个草.
3. 选择用于绘制的草.
4. 点击、拖动来绘制草。按住Shift来删除草。
5. 按PageUp撤销，按PageDown重做。
6. 非常重要 不要使用Ctrl + S保存包含草的场景。 应该先选中附加了GrassLoader的GameObject，然后点击Inspector窗口中的4. Clear Preview Grassses & Save Scene。 否则预览用的草会被保存到场景当中。
7. 使用GrassLoader的Inspector中的4个按钮来烘培有草的场景:
   
   按顺序点击1. 2. 3. 4. 即可。

   1. Reload From File	从grasses.asset加载GrassLoader的所有草实例，并重新生成预览用的草。
   2. Bake Lightmap	功能与Light窗口的Generate Lighting功能相同。
   3. Save lightmap data	保存lightmap数据到grasses.asset.
   4. Clear Preview Grassses & Save Scene	删除预览用的草并保存场景。

注意 每个场景只允许有一个GrassLoader对象存在。

注意 使用高度工具调整过地形高度后，草所在位置会随之调整。

预制体

预制体	选择和配置要绘制的预制体。MTE免费版用户只能使用两种预制体。
⚙️Edit Prefab	点击添加、修改或编辑预制体配置。 预制体 要使用的预制体 缩放 X、Y、Z三个轴向的随机缩放范围

设置

使用步骤

1. 创建一个空GameObject作为对象的容器，然后将其拖到编辑器窗口的“容器”中
2. 点击⚙️编辑预制体选择添加来添加一个预制体配置.
3. 在列表中选中预制体
4. 在场景中点击、拖拽来绘制对象。按住Shift来删除对象。对象会作为子节点，被添加到容器对象上。
5. 按PageUp撤销，按PageDown重做。

注意 无法绘制没有碰撞体的Prefab，请临时加上后再绘制，绘制完成再移除碰撞即可。

注意 目前对象的高度在更改地表高度时不会随之更改。将会在下个版本实现此功能。

流编辑器在免费版中不可用。

MTE使用的流动图遵循了和Valve Flowmap相同的规则。

模式

• 固定方向: 流动方向和强度是固定的。
• 移动: 归一化的流动速度和方向由鼠标的移动速度和方向决定。
• 收缩/扩散: 收缩或扩散流动。
• 漩涡：漩涡状流动。

方向

	点击、拖动来同时调整强度和方向。
强度	归一化的强度
方向	方向的值，以角度为单位
	快速方向调整按钮

设置

工具

• 创建流动图 创建一张当前方向创建流动图。所创建的图像的文件位于Assets/FlowMap.png。 现在所创建的流动图的大小固定为512x512. 在未来的版本中会提供更多选项。

使用步骤

1. 确保场景中水面的材质包含一个名为_FlowMap的贴图属性。并且此贴图的导入设置中的Read/Write Enabled被选中。这样MTE才能编辑此flowmap.
2. 规定的方向需要遵从： +z 是正北方方向（90°）。 +x是正东方向（0°）。如果发现Z方向相反，可在shader中进行调整。请参考提供的MTE/Legacy/WaterFlow这个shader.
3. • 固定方向: 选择或输入强度和方向；也可以在场景中按住Ctrl滚动滚轮来调整方向。
   • 移动: 选择或输入强度。
   • 收缩/扩散: 选择或输入强度。按Space切换聚集和扩散。
   • 漩涡: 选择或输入强度。按Space切换旋转方向。
4. 点击、拖动鼠标来绘制流动。

注意 请记得将创建流动图所创建的FlowMap.png移动到合适的位置，否则在下次按下创建流动图后，该文件就会被覆盖。

注意 所有模式使用相同的强度参数。

设置

工具

绘制地形纹理(数组)工具在免费版中暂时不可用，后续正式版会开放4层贴图版本。

使用方法和绘制贴图的“单个选中”模式相同，只是要求使用基于纹理数组的shader: MTE/Standard/TextureArray 或 MTE/URP/TextureArray

工具

（待填入）

根据支持的渲染管线，MTE的shader分为两类：

Builtin (内置管线的shader)	
   ├── Standard (Standard shader )
   │      ├── 2/3/4/5Textures (2-5层shader: 支持PBR着色模型的部分特性。支持逐层的颜色、法线、粗糙度贴图（或粗糙度数值）； 第5层和第4层共享UV缩放、偏移)
   │      ├── 6/7/8Textures (6-8层shader: 性能极差，不要使用)
   │      ├── Packed (实验性的高度混合shader，支持4或8层混合。名字的“Packed”的意思是，将高度和颜色打包到同一张贴图中，用于shader实际采样)
   │      └── TextureArray (基于贴图数组的shader：支持2到12层。支持逐层的颜色、法线、粗糙度和AO贴图，这些贴图被打包在2个贴图数组中。)
   ├── Surface (传统的Surface shader，使用 Lambert 或 Blinn-Phong 着色模型)
   │      ├── 2/3/4/5Textures (2-5层shader: 支持逐层的颜色、法线和高光颜色。第5层和第4层共享UV缩放、偏移)
   │      ├── 6/7/8Textures (6-8层shader: 性能极差，不要使用)
   │      ├── Grass (演示用的草shader)
   │      ├── TextureArray (基于贴图数组的shader：支持2到12层。)
   │      ├── Vertex-colored (演示用的顶点颜色shader)
   │      └── WaterFlow.shader (演示用的使用流动图的水面shader)
   ├── Specialized (仅适用于特定旧GPU的特殊shader)
   ├── Unlit (不受光的CG shader，支持实时阴影和光照图。)
   └── MTECommon.hlsl (包含内置渲染管线的shader的通用代码)
URP (URP shader, 支持PBR着色模型 - 高光工作流)
   ├── 2/3/4/5Textures.shader (2-5层shader: 支持逐层的颜色、法线、粗糙度贴图（或粗糙度数值）)
   ├── 4Textures_height_blend_packed.shader (实验性的高度混合shader，支持4或8层混合。名字的“Packed”的意思是，将高度和颜色打包到同一张贴图中，用于shader实际采样)
   ├── 5Textures_DisplayNormal.shader (辅助性shader，用于显示混合后的法线)
   ├── Grass.shader (演示用的草shader)
   ├── TextureArray.shader (基于贴图数组的shader：支持2到12层。)
   ├── TextureArray_DisplayNormal.shader (辅助性shader，用于显示混合后的法线)
   ├── TextureArray_Triplanar.shader (基于贴图数组的shader，使用三线性插值：不要使用，性能比较差)
   └── VertexColor.shader (演示用的顶点颜色shader)
MTECommonPBR.hlsl (包含支持PBR的shader的通用代码)

不要使用不符合项目当前渲染管线的shader，否则结果会是粉色的。

TextureArray shader界面 MTETextureArrayShaderGUI

基于TextureArray的shader都使用这个界面。

用ASE打开	在ASE中打开当前shader，以便查看和编辑。
Albedo 反照率	包含所有反照率贴图的贴图数组。
粗糙度法线AO	包含所有粗糙度、法线、AO贴图的贴图数组。这些贴图是打包过的，详情请看两个贴图数组的RGBA通道含义.
UV缩放和偏移	采样层贴图时，对地形UV的缩放和偏移
层数	会被shader使用的层数。使用满足需求的最小值即可。
权重图	这里的权重图仅供预览。如果不明白权重图的原理，请不要手动编辑他们。 点击调整，修改权重图的大小和朝向。注意，如果有多张权重图，先确保调整为相同的大小，再继续画贴图。
启用法线强度	点击切换是否启用法线强度。

旧式shader界面 MTEShaderGUI

除URP的基于TextureArray的shader和一些特殊shader外，其他使用独立的2/3/4/5张贴图的shader都使用这个界面。

使用ASE编写的shader可以继续被ASE编辑。通过点击shader界面顶部的用ASE打开在ASE中打开。

刷新按钮用于为所有层生成“颜色&光滑度”贴图，如果此材质启用了光滑度贴图功能。颜色贴图的RGB通道和光滑度贴图的Alpha/Red通道会被合成为一张“颜色&光滑度”贴图，并实际用于shader中采样。

对于每一层，可以

• 指定颜色、光滑度、法线贴图；颜色&光滑度贴图仅供预览，用上方的刷新按钮 生成。
• 设置贴图坐标的平铺和偏移值。
• 设置常数光滑度，此值在支持光滑度贴图的shader中，将会和光滑度贴图上采样的值相乘作为最终的光滑度。
• 设置法线强度，只在含法线贴图和启用了法线强度的shader上可用。

点击+可以增加1层。

点击调整可以打开贴图调整工具修改权重图的大小和朝向。注意，如果有多张权重图，先确保调整为相同的大小，再继续画贴图。

开启/关闭启用光滑度贴图来开启或关闭光滑度贴图功能。

开启/关闭启用法线强度来开启或关闭法线强度功能。

（只在调试模式下可用）可以点击shader界面底部的(debug)显示默认shader界面打开默认shader界面。注意默认shader界面可能会和MTE的界面冲突。

注意 对于多块平铺的MTE地形，

• 使用根对象上的界面来启用“颜色&光滑度贴图”功能，或刷新“颜色&光滑度”贴图。
• “颜色&光滑度”贴图由第一块地形（名字以“_00_00”结尾）决定，并且所有地块都使用相同的层贴图

如果修改过shader或者使用了自定义shader，额外的属性会显示在界面最下方。

所有编辑操作，都是可以撤销重做的。使用 PageUp 进行撤销， PageDown 进行重做。在Mac上，使用Fn+↑撤销，使用Fn+↓重做。编辑器上参数的修改无法撤销。撤销重做的数据会在你保存模型时被清空。

可以使用“历史查看器”（菜单 Window -> Mesh Terrain Editor -> Tools -> History Viewer）来浏览历史编辑信息。

通过菜单Window -> Mesh Terrain Editor -> Settings打开设置窗口。或点击MTE编辑器上方的设置按钮来打开它。

工具	一组切换按钮，用于隐藏不需要的主工具按钮。
使用紧凑界面	选中此项后界面会变得紧凑：
标识点大小	调整标识点、碰撞点等等的大小。实际的大小可以在场景中预览。
闪烁	选中此项后会闪烁标识点。开启此项可能会影响性能。
显示笔刷矩形	选中此项后会显示当前笔刷的矩形区域（从+y方向向-y方向看）。
显示顶点法线	选中此项后会显示当前选择的顶点的法线。
笔刷单位长度	设置笔刷大小的单位，默认为 1 笔刷大小 = 1 格子大小。
使用格子(瓦片)大小	选中此项会设置笔刷大小的单位为格子（瓦片）的大小。（计算的值，可能不正确或不准确）。
模型平滑角度	创建或保存模型时，计算模型顶点法线时，使用的平滑角度。
语言	设置界面语言。
自动保存模型	如果你需要自动保存模型，选中此项。但是有几个关键点要注意： 鼠标释放时，修改过的MTE地表模型将会被自动保存。如果编辑器有明显卡顿，请到设置中关闭“自动保存模型”。 当你在修改MTE地形时，一旦发生了自动保存，将再也不能撤销之前的修改。 注意启用定时自动保存后，撤销重做功能会不稳定。
Debug Mode	选中此项后，Console窗口中会实时打印MTE的操作信息，并且启用一些调试性功能。开启此项可能会影响性能。

注意 在场景的正中心会显示一个点，用于预览与表示点相关的选项的作用。

注意 在场景的正中心会显示一个矩形框（请点击+y轴来从+y方向向-y方向查看场景视图），用于预览笔刷单位长度。

默认语言是英文。但是您可以自行调整界面的语言和文字内容。

• 修改语言:

  在设置窗口的“Language”（语言）处设置。修改后将重新编译你的脚本文件。在此之后，界面会切换到您刚刚选择的语言。

• 修改界面文字内容:
  1. 在EditorResources\Languages\路径下找到语言文件。MTE已经提供了两个：en-US.xml和zh-Hans.xml。从中选择你所要修改的语言的文件。
  2. 修改文件内容: 比如，修改 <Warning_Confirm>确定执行此操作吗?</Warning_Confirm> 为 <Warning_Confirm>您确定吗?</Warning_Confirm>
• 使用新语言:
  1. 将en-US.xml复制一份，然后将其重命名为，比如ja-JP.xml或es-ES.xml。
  2. 翻译所复制的语言文件，按照上面“修改界面文字内容”所描述的去做即可。
  3. Reimport MTE.dll.
  4. 当Reimport完成后，在设置窗口中，就可以使用刚刚添加的语言了。

你可以在编辑器代码中引用MTE名字空间中的类型。

• 为MTE编辑器写插件 需要MTE专业版

  实现MTE.IEditor接口即可，MTE编辑器会自动加载你的实现类。参考现有的IEditor实现，位于MeshTerrainEditor\Plugins\Editor目录里。

• 将Unity地形转换为MTE模型

  public static void ConvertTerrainToMesh(GameObject terrainGameObject, string name, string outputDir, bool exportTrees, int vertexCountAlongAnEdge)
  {
      string terrainName = name ?? terrainGameObject.name;
      if (String.IsNullOrEmpty(terrainName))
      {
          terrainName = "terrain" + terrainGameObject.GetInstanceID();
      }
      TerrainConversionSettings settings = new TerrainConversionSettings
      {
          Name = terrainName,
          FileFormat = MeshFileFormat.obj,
          OutPutDir = PathEx.UnifySlash(outputDir),
          ExportTrees = exportTrees,
          VertexCountAlongAnEdge = vertexCountAlongAnEdge
      };
  
      ConvertTerrainToMesh(terrainGameObject, settings);
  }

1. 我找不到Window/Mesh Terrain Editor菜单！

   请确认 Editor/MTE.dll 的导入选项 Platform Settings->CPU 中，是否是Any CPU或者和您的Unity3D版本相同。x86版本的Unity3D只能使用x86导入选项的MTE.dll，x64版本的Unity3D只能使用x64导入选项的MTE.dll. 如果你不确定，修改几次试试。

2. 为何按 Ctrl+Z 不会撤销？

   使用 PageUp 来撤销，使用 PageDown 来重做。 因为Unity3D的撤销机制对于地形模型这种大对象而言，太慢了！所以为了提升用户体验，MTE采用了自行编写的一套撤销系统，同时为了不和Unity3D的快捷键发生冲突，就使用了PageUp和PageDown. 未来版本也许会尝试让Ctrl+Z/Y起作用，如果您有迫切的需求，请提出feature request.

   请点击MTE编辑器顶部的键盘按钮确认可用的快捷键。

3. 我无法编辑。没有看到任何闪烁的点、笔刷贴图、圆圈或矩形框。

   请尝试关闭MeshCollider组件后再打开它。这个问题疑似是Unity的物理系统的bug，通常在保存或重新导入模型文件后发生。

4. 我可以更改shader吗？

   可以，但为了继续在MTE中编辑MTE地表，shader需要遵循以下的规则：

   • 为了可以使用 高度工具（提升/降低高度、绘制高度、平滑高度）以及模型工具，请确保对象上有有效的MeshCollider组件。
   • 为了可以使用 绘制贴图 工具，确保使用的shader中的权重图的属性名为_Control；如果使用了第二张权重图，其对应的属性名应为_ControlExtra. 第1/2/3/4/5层贴图的属性名应为 _Splat0/1/2/3/4. 如果使用的是bumped shader，法线贴图的属性名应为_Normal0/1/2/3/4. 建议参考MTE提供的shader进行修改。
   • 为了可以使用 顶点颜色绘制 工具，确保对象上有VertexColorInitializer组件（此组件会在编辑器中确认添加顶点颜色时，自动添加，更多相关内容参见 常问问题：添加顶点颜色组件时，发生了什么？）
   • 为了可以使用 流编辑器 工具，确保使用的shader中的流动图的属性名为_FlowMap.
   • 为了可以使用 模型工具/挖洞 tool, 请确保对象上没有颜色绘制组件，您不能在绘制了顶点颜色的模型上挖洞。

5. 快捷键无效！

   请检查场景窗口（Scene）或MTE编辑器窗口有焦点吗？如果没有，快捷键不会有作用。

   输入法关闭（切换到英文）了吗？输入法会扰乱快捷键的处理从而让它不起作用。请关掉输入法。

6. 我不能取消选择MTE地表. 或我不能选中其他对象了。

   请在hierarchy窗口中选择其他对象。编辑时，MTE在场景窗口中锁定了选择的对象来防止误操作。

7. 添加顶点颜色组件时，发生了什么？

   此操作会在模型obj文件旁生成一个asset文件用于保存顶点颜色。一个VertexColorInitializer组件会被附加到模型对象上。

   此组件用于在模型的GameObject创建时将asset文件中的顶点颜色赋值给Mesh.colors. 相关类的源码在这里：Plugins\Scripts

8. 为什么MTE编辑器在运行时被关闭了？

   在运行时编辑还没有被测试过。所以MTE编辑器在开始运行时关闭了以防止可能的误操作。

9. 为什么在转换完成后，输出目录中有一个Material文件夹？

   此文件夹是由Unity3D生成的，用于在inspector中预览模型文件。您可以自行删掉它。

10. 在Mac上，MTE的窗口在失去焦点时消失。

    这是设计好的行为。Unity3D和Apple都认为这样合适。更多信息请查看此处（英文）.

11. MTE可以使用多于5张贴图吗？

    可以。请使用贴图数组方案，支持2-12张贴图。

12. 添加GrassLoader时，发生了什么？

    此操作会在指定的位置生成一个asset文件用于保存草的信息。一个GrassLoader组件会被附加到选择的对象上。

    此组件用于在模型的GameObject创建时，根据asset文件中的草的信息，创建实际的草模型对象 (在GrassLoader.Start中). 相关类的源码在这里：Plugins\Scripts\

13. 绘制的贴图的交界处有黑边，怎么解决？

    请修改Control贴图的导入设置为 不选中“sRGB (Color Texture)”，然后apply.

14. 如何使用自定义的权重图？

    如果是从其他地形创建工具如World Creator, World Machine等导出的权重图，您可以直接用它们替换MTE模型地表材质所使用的权重图。只需要确保替换的权重图的大小和之前是相同的，可以使用贴图调整工具来做。

    很多用户提出需要用手工制作的权重图，但是，在一般的图像编辑器中制作符合要求的权重图，是几乎不可能的。因为权重图要求所有通道是“均一化”的，而几乎所有的图像编辑器都不会提供这个功能。使用手工制作的非均一化的权重图，可能在一开始看起来很正常，但一旦开始刷贴图，黑色、暗色、过亮、方块状的异常区域就会出现。但如果您非要坚持，这里有制作4层权重图的过程：

    1. 在图像编辑器里打开SplatAlpha 0.png
    2. 修改，保证 RGBA 4个通道的和为255，也就是“均一化”
    3. 导出为TGA SplatAlpha 0.tga
    4. 将SplatAlpha 0.tga放到Unity工程中
    5. 用MTE提供的Texture Adjuster将这个TGA贴图保存为PNG格式，此工具位于菜单项 Window -> Mesh Terrain Editor -> Tools -> Texture Adjuster
    6. 将保存下来的SplatAlpha 0.png赋予回MTE地表材质的Control属性

2022-05-30 v4.0.0

提交问题或新功能需求：MTE issue tracker上。

（建议的方式）Mesh Terrain Editor交流群: 689511734，欢迎加群交流。

通过电子邮件和作者联系 zwcloud@hotmail.com

• MTE intro video(YouTube)
• MTE介绍视频(bilibili)