If an old version of MTE exists in the project, please remove it before importing new version. Overwriting the old version will possibly cause errors because of old files.

After copy and import MTE's file into your project, click menu item Window/Mesh Terrain Editor/Install to install Mesh Terrain Editor into your project properly:

• Incompatible URP shader folders will be removed.
  
  For example, if your project uses URP14, only the "URP14" folder will be kept. If this doesn't happen, please do it yourself and report this issue.

MTE Pro user, please login to your account first.

It's recommended for first-time users to read docs about specific function before using. 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!
• 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
  • 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
  • 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
• 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 Unity forum post to communicate with the author and other users
  • Instant Messaging Group: 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 will trigger 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)
	├── 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 (Builtin-RP shaders)
	└── URP (URP 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: mesh-terrain with 2 to 12 blended layer textures. OpenGLES 3.0+ required since it uses texture array.

Doesn't support create mutiple tiled mesh-terrains or create from a height map.

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.
Texture Array Mode	See TextureArray mode
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	According to selected Texture Array Mode, 1st and 2nd Texture arrays can be: Albedo at 1st: Specify Albedo(RGB) texture array AlbedoMetallic at 1st: Specify Albedo(RGB) Metallic(A) texture array RoughnessNormalAO at 2nd: Specify Roughness(R) Normal(GB) AO(A) texture array. Normal at 2nd: Specify Normal(RGB) 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 TextureArraySettings : 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
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.
Use Texture Array	Check this to create texture array based mesh-terrain(s).
Vertex Count	Specify the number of vertices along an axis direction.
Split	(Not supported to be used together with Use TextureArray) Check this to split a Unity terrain into multiple mesh-terrains.
Statistics	See mesh-terrain statistics.
Advanced Options	Mesh Only Convert the Unity terrain to a mesh object with default material. No MTE shader applied. Keep Lightmapping Data Whether keep light-map on the terrain if they have been baked. Export Trees Export trees on original Unity3D terrain. Use Custom Shader Display/Choose a customized shader.

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
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.
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.
Statistics	See mesh-terrain statistics.
Advanced Options	Mesh Only Convert the Unity terrain to a mesh object with default material. No MTE shader applied. Keep Lightmapping Data Whether keep light-map on the terrain if they have been baked. Export Trees Export trees on original Unity3D terrain. Use Custom Shader Display/Choose a customized shader.

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 TextureArraySettings asset and create two kinds of texture arrays with it.

  TextureArraySettings 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 > TextureArraySettings
  

  Texture Array Mode	4 modes: Color, Color and Normal, PBR and PBR(Metallic). One or two texture array(s) will be created per mode. Under Color mode, only one Color texture array will be created. Under Color and Normal mode, one Color texture array and one Normal texture array will be created. Under PBR mode, two texture array will be created: Albedo and RoughnessNormalAO. Under PBR(Metallic) mode, two texture array will be created: AlbedoHeight and RoughnessNormalAO.
  Per-array settings	You can set detailed properties for each texture array: Compress Whether compress the texture array Format The texture format of the texture array.Make sure a format that supports four RGBA channels is chosen for AlbedoMetallic and RoughnessNormalAO texture array. In program, this is TextureFormat, but only types that are supported by current active build target are listed. See Default texture formats by platform for details. Quality The compression quality of the texture array. Only makes sense when Compress is enabled. In program, this is TextureCompressionQuality. Wrap Mode The texture wrap mode of the texture array. In program, this is TextureWrapMode. Filter Mode The texture filter mode of the texture array. In program, this is FilterMode. Aniso Level The anisotropic filtering level of the texture array. In program, this is Texture.anisoLevel.
  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 one layer. Requirements: Color/Albedo textures must be sRGB. Normal, roughness and AO textures must be linear(not sRGB). Normal maps's texture type in its importer setting must be Normal map.

  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:

  They differs according to selected Texture Array Mode:

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

  Note You can select the settings asset and 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-terrain matches, a warning message will be shown.

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 through 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) can pass through 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.

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.

Settings

Size	The brush size determines the range of the brush. hotkeys: -+
Flow	The brush flow determines how quick the texture will be paint to the mesh-terrain. Value 1 means immediately. hotkeys: []. Right click the label "Flow" to toggle slider mode between regular and logarithmic. Under logarithmic mode, you can adjust the flow more accurately when using a very small flow value.
Direction	The brush direction determines the orientation of brush mask. It won't impact the direction of painting texture. Hold Ctrl and scroll to adjust direction.

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.

Customize Brush

You can add or remove the brushes by adding/removing images in EditorResources\Brushes. Importer settings for brushes should be like this:

Then click to refresh the brushes.

Importer settings of a control texture

Importer settings of a control texture (SplatAlpha 0/1.png) should be

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.

After generating control maps when creating a mesh-terrain, MTE has set the import settings correctly. But some 3rd-party plugins or editor scripts may change the settings.

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

Usage Steps

1. Set a shape collider;
2. Move, scale and roate the shape object;
3. Click Wrap button, the mesh-terrain will be deformed accroding to the shape object.

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.

Grasses

Grass detail list	select a prototype of a grass that will be painted Grass prototypes defined in GrassLoader's Grass Detail List will be shown in this list.

Settings

Size	Specify the size of the brush. hotkey: -+
Density	Specify the density of the brush. (When it is small enough, a single grass will be paint.) hotkey: []
Number	Display the number of grasses that will be painted.
Reduction	Specify how many grasses will be removed when erasing grasses by clicking: 100 means all of the grasses inside the brush, 50 means 50% of the grasses.
Direction	Specify the direction of grasses being painting. (default: Random) When "Random" is not checked, hold Ctrl and roll the scroll wheel to specify the rotation of subsequent grasses that will be painted. When "Random" is not checked, hold Ctrl and roll the scroll wheel to change the rotation of existing grasses inside the brush.
Allow Overlap	When checked, allow a grass to overlap another.

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. (preparation for each scene)
   1. Create an empty GameObject as the root of your grasses。
   2. ClickAttach GrassLoader, choose a proper place (recommended aside the mesh-terrain file) for Grasses.assetGrassLoader, an GrassLoader will be attached to the GameObject.
   3. Create GrassDetailList asset via menu Assets\Create\Mesh Terrain Editor\Grass Detail List
   4. Select GrassDetailList asset and add grass prototypes in inspector.
      
      
      • Click the Add button to add new grass prototype.
      • Set the name, material, random min/max width/height and type(one, three quads or custom mesh) of grass prototypes.
      • Right click the blank space of a grass prototype to open context menu to delete it.
   5. Assign GrassDetailList asset to GrassLoader's Detail List.
   6. Click the refresh button on editor, added prototypes will be displayed in the list.
2. Select a grass prototype.
3. Click and drag to paint grasses. Hold Shift to erase grasses.
4. Press PageUp to undo and PageDown to redo.
5. 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.
6. To baking lightmap for grasses, use the buttons on the inspector of GrassLoader:
   
   Just press 1. 2. 3. 4. and all done.

   Grass Detail List	list of grass prototypes, storing editor settings of each grass prototype
   Grass Instance List	list of grass instance, storing point cloud data used to generate actual grass meshes at runtime
   Is Grass Static	Only static grass will contribute to lightmap after baking. ref: Unity Docs: Static GameObjects
   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.

Note If you find generated grass floating above ground, check if any transparent mesh collider is above the ground. If such colliders passed through the filter, they will block the brush.

Prefab

Prototype List	Select a prefab to paint. Prototypes defined in ObjectLoader's Detail List will be shown here.

Settings

Size	Specify the size of the brush. hotkey: -+
Number	Specify the number of object that will be painted when mouse is clicked. hotkey: []
Reduction	Specify how many object will be removed when erasing objects by clicking: 100 means all of the objects inside the brush, 50 means 50% of the objects.
Direction	Specify the orientation of object inside the brush. (default: Random) When "Random" is not checked, hold Ctrl and roll the scroll wheel to specify the rotation of subsequent objects that will be painted. When "Random" is not checked, hold Ctrl and roll the scroll wheel to change the rotation of existing objects inside the brush.
Allow Overlap	When checked, allow an object to overlap another.

Usage Steps

1. (preparation for each scene)
   1. Create an empty GameObject as the container of objects and drag it into the Container field in the editor.
   2. Create ObjectDetailList asset via menu Assets\Create\Mesh Terrain Editor\ObjectDetailList
   3. Select ObjectDetailList asset and add object prototypes in inspector.
      
      • Click the Add button to add new object prototype.
      • Set the name, prefab, random min/max scale of object prototypes.
      • Right click the blank space of a prototype to open context menu to delete it.
   4. Assign ObjectDetailList asset to ObjectLoader's Detail List.
      
   5. Click the refresh button on editor, added prototypes will be displayed in the list.
2. Select a object prototype from the list.
3. In the scene, Click and drag to paint objects. Hold Shift to erase. Objects will be added as children of the container.
4. 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.

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

Size	Specify the size of the brush. hotkey: -+
Speed	Specify how fast will brush change old direction on the flow-map to current one. (This is not the flow speed.) hotkey: []

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/Surface/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)
   ├── 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)
   │      ├── 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)
   ├── TextureArray (Texture-array-based shaders: support 2~12 layers)
   ├── MTECommon.hlsl (shared code for builtin-RP shaders)
   └── MTECommonBuiltinRP.hlsl (shared code for builtin-RP shaders)
URP (URP shaders, support PBR shading model of metallic workflow)
   ├── URP7 URP 7.x shaders, remove if not compatibile with your project
   ├── URP10 URP 10.x shaders, remove if not compatibile with your project
   ├── URP12 URP 12.x shaders, remove if not compatibile with your project
   ├── URP14 URP 14.x shaders, remove if not compatibile with your project
   │      ├── 2/3/4/5Textures.shader (2-5 layer shaders: support per-layer diffuse map, normal map and smoothness map/value.)
   │      ├── 5Textures_DisplayNormal.shader (utility shader used to display blended normal output)
   │      ├── Grass.shader (demo-only grass shader)
   │      ├── VertexColor.shader (demo-only shaders using vertex-color)
   │      └── TextureArray_xxx.shader (texture-array-based shaders: support 2~12 layers)
   └── MTECommonURP.hlsl (shared code for all URP shaders)

If using URP, please delete URP folders of different version，otherwise errors caused by shader name may occur. Shader's name Shader.name）doesn't differ for diffent URP version folder.

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 it.
Albedo (or AlbeoMetallic)	The texture array contains all albedo textures.
RoughnessNormalAO (or Normal)	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	UV Scale of all layers.
Normal Intensity	Intensity of normal map.
Layer Number	The number of layers will be used. Modify this will add weight-maps as needed. Existing weight-maps will not be deleted.
Weight Maps	The weight maps here are for preview only. Don't modify them manually. 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.
Enable Metallic	Toggle to enable/disable Metallic feature. When enabled, shader will enable keyword ENABLE_METALLIC and use metallic, which is stored in 1st texture array's alpha channel, to render metallic luster.
Enable Layer UV Scale	Toggle to enable/disable per-layer UV scales feature. When enabled shader will enable keyword ENABLE_LAYER_UV_SCALE and use a float array set by LayerUVScalesHolder component. You have to add a LayerUVScalesHolder component to use and adjust per-layer UV scales.

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 open Settings/Hotkey 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.

16. I cannot paint textures.

    troubleshooting steps:

    • See if the Console window has errors. If the errors happen when trying to paint textures, please report the issue: send us reproduce steps, error screenshot and error text content.
    • If the Textures list lis empty, open the filter object list to ensure your MTE mesh object passed through the filter. If it doesn't, make sure following conditions are met and refresh the filter.
      1. Mesh-terrain GameObject is active.
      2. Mesh-terrain GameObject's tag and layer is the same as MTE Editor.
      3. Mesh-terrain GameObject has a MeshFilter component.
      4. Mesh-terrain GameObject's MeshFilter component has a Mesh.
      5. Mesh-terrain GameObject has a MeshCollider component.
      6. Mesh-terrain GameObject's MeshCollider component has a Mesh.
      If you are using MTE Free, then only first two GameObjects that passed through the filter will be preserved. Please read the docs of The Filter.
    • If you are painting on a texture-array-based mesh-terrain:
      1. Ensure the TextureArraySettings.asset file is put aside the Texture2DArrays. If not, MTE editors cannot find the source textures and add them to the texture list. Put them together and refresh the filter. Then try again.
      2. Ensure the Name parameter is not modified after creating the Texture2DArrays. If not, reset the texture settings' Name parameter to the name (except the postfix _Albeo _RoughnessNormalAO) of texture arrays. Refresh the filter and try again.
    • If no brush is displayed when put the mouse on a mesh-terrain:
      1. Make sure the mesh-terrain is not scaled. (Scaled mesh-terrains haven't been tested with MTE editors and the functions of texture painter is not guranteed to work normally.) If it's scaled, modify to 1,1,1 scale and try again.
      2. Disable and enable mesh-terrain's MeshCollider, then refresh the filter and try again.
      3. Make sure mesh-terrain's MeshCollider *Convex* is not checked, if it is, uncheck and try again.
      4. If there is still no brush displayed, please report the issue.
    • If brush is displayed, but it doesn't paint textures when clicking and dragging:
      1. Make sure the importer settings of the weight-maps (namely control-map or SplatAlpha0/1.png), Read/Write Enabled is checked. If not, check it, apply and try again.
      2. Make sure no other (transparent) GameObject passed through the filter and covered the painting zone. MTE editor's brush will be blocked by such GameObjects, which makes MTE unable to modify the weight-map(s). Please remove them or make them not pass through the filter. Then refresh the filter and try again.
      3. If you are using "Filtered" mode, make sure your mesh meet following requirements (mesh-terrains created by MTE always follows)
         1. The mesh is shaped exactly as a complete square. No corner is missing.
         2. The texture coordinate (uv) is continuous. UV must cover all first quadrant, namely (u=0,v=0) to (v=1,u=1). Now see the following image.
            The blue point at left-bottom corner must be an existing smallest vertex on the mesh and smallest uv(u=0, v=0);
            The red point at right-top corner must be an existing largest vertex on the mesh and largest uv(u=1, v=1).
            
      4. If you are using "Selected" mode,
         1. Make sure the mesh uv is continuous on where your are painting.
         2. Check if the weight-maps (namely control-map or SplatAlpha0/1.png) are being modified when painting： Select a weight-map, show its preview in the inspector of it. Then paint textures with MTE texture painter. Observe if the weight-map is changed. If it is, but no effect on mesh-terrain surface, then the uv is not continuous on where your are painting.
         3. Make sure no other (transparent) GameObject uses the same tag and layer of the mesh-terrain and covered the painting zone. MTE editor's brush will be blocked by such GameObjects, which make MTE unable to modify the weight-map(s). Please remove them or make them not use the same tag and layer, or just disable it, then try again.

17. How to reset MTE?

    Click menu item at Window -> Mesh Terrain Editor -> Debug -> Reset Mesh Terrain Editor, note this will trigger code compilation

18. System.ExecutionEngineError: String conversion error: illegal byte sequence encountered in the input.

    Make sure your project path doesn't contain non-ASCII character, like Chinese, Japanese and Korean character, and re-open the project.

2024-05-22 v4.4.0

2023-12-14 v4.3.0

2023-11-16 v4.2.7

2023-09-21 v4.2.5

2023-09-12 v4.2.4

2023-09-11 v4.2.3

2023-09-04 v4.2.2

2023-07-25 v4.2.1

2023-05-22 v4.2.0

2023-03-28 v4.1.2

2023-03-06 v4.1.1

2023-02-25 v4.1.0

2023-01-28 v4.0.7

2022-12-26 v4.0.5

2022-10-20 v4.0.2

2022-09-06 v4.0.1

(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.

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

• 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.
• EditModeIntervalCallbacks by Glurth.

如果工程内有旧版本MTE，请首先删除它，再导入新版本MTE。如果直接导入覆盖，很可能会因为旧的文件被遗留而导致MTE出现各种功能问题！

MTE的包导入（解压并复制到工程Assets目录中）后，点击菜单项Window/Mesh Terrain Editor/Install对MTE进行安装：

• 如果工程使用了URP，会自动删除不兼容的URP shader目录
  
  如果你们的工程使用URP14，就只保留"URP14"目录，删除其他的。如果此操作没有自动触发，请手动删除。

MTE专业版用户，请首先登录您的账户。

在第一次使用各项功能前，建议先查看相关的文档。并且请注意以下几点：

• 如果您遇到问题，请首先阅读相关文档和常问问题。如果还是不能解决问题，请随时联系作者获得支持。
• MTE会根据系统语言自动设置界面语言，不过有可能会失效，可以自行到设置界面为简体中文，具体请参考 自定义UI语言。
• MTE会修改你的模型和相关文件。在编辑和保存的过程中，你的文件可能会在某些罕见的情况下被破坏。请一定要使用版本控制系统（如SVN、GIT）来管理你的工程文件。无论如何，备份文件是特别重要的事情！
• 在点击“保存”按钮保存模型之前，所有编辑操作都是可以撤销的。保存模型后编辑历史将会被清空。注意，如果启用了自动保存，撤销重做功能也会在自动保存发生时失效！
• 请注意笔刷的大小的单位尺寸可以在设置 > 笔刷单位中设置。 (实际笔刷大小) = (笔刷大小) * (笔刷单位). 所以您可以在开始编辑前调整好笔刷的单位大小，建议使用网格的单个格子大小作为单位大小。（对于非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: 检查更新
  • Help: 打开此文档
  • About: 查看MTE的致谢名单和版本信息
• Tools 工具
  
  • 历史查看器
  • 模型数据查看器: 用于查看地表模型统计数据的工具
  • 快照工具以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
• Support
  
  • Documentation: 文档，你现在正在阅读的。
  • Welcome Window: 欢迎窗口，在Unity编辑器启动时会出现。
  • Forum: Unity论坛
  • Instant Messaging Group: 即时交流群组，和作者以及其他用户实时交流关于MTE的话题。
  • 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 (笔刷模板图像文件)
    ├── Languages (语言文件)
    │	├── en-US.xml (英语-美国)
    │	└── zh-Hans.xml (汉语-简体)
	└── Shaders (编辑器使用的shader)
Plugins (MTE插件代码和资源文件)
    ├── Editor (编辑器插件代码)
    ├── Scripts (运行时代码)
    └── Resources
		  └── Grass (草的原型模型，用于生成草的实例)
Shaders
	├── Builtin (内置管线shader)
	└── URP (通用渲染管线URP 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或fbx格式。 MTE只使用fbx格式。
只生成模型	将Unity地形转换为具有默认材质的模型对象。不会应用MTE的shader.
输出树	输出原Unity3D地形上的树。
选择输出文件夹	MTE地表的所有文件会被输出到{输出文件夹}/{名称}/路径下。此路径必须在工程文件夹下的Assets目录中。
切分	选中此项来将Unity地形切分多份模型
统计数据	见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或fbx格式。
• 模型使用 +Y 作为地形高度增长方向，也就是Y-up
• 场景中的模型对象上附有有效的MeshFilter和MeshCollider组件。

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

• 模型文件应该包含一层均匀分布的纹理坐标。
• 模型的AABB的最大（小）点，在x和z轴上，应该拥有最大（小）纹理坐标。 最小纹理坐标: (0,0), 最大纹理坐标: (1,1)，分别位于uv01区间的最小最大位置. 参考常问问题： 刷不了贴图怎么办？
• 场景中的模型对象使用类似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纹理数组？
  答：创建TextureArraySettings 文件，然后借助它创建两种纹理数组。

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

  纹理数组模式	4种模式：纯颜色Color、颜色和法线Color and Normal、基于物理的PBR、基于物理的PBR(含金属度Metallic贴图). 根据选择的模式，会有1个或2个纹理数组被创建。 在纯颜色Color模式下，会创建1个颜色纹理数组。 在颜色和法线Color and Normal模式下，会创建1个颜色纹理数组、1个法线纹理数组。 在基于物理的PBR模式下，会创建1个颜色（反照度Albedo）纹理数组、1个 粗糙度 + 法线 + 环境光遮蔽 纹理数组。 在基于物理的PBR(含金属度Metallic贴图)模式下，会创建1个 颜色（反照度Albedo）+金属度(Metallic) 纹理数组、1个 粗糙度 + 法线 + 环境光遮蔽 纹理数组。
  每个纹理数组的设置	你可以为每个纹理单独设置详细属性： 压缩Compress 是否压缩纹理数组。 格式Format 纹理数组的贴图格式。请确保为AlbedoMetallic和RoughnessNormalAO纹理数组设置一个支持RGBA 4通道的纹理格式。 在程序中，此项指TextureFormat, 但只提供当前活动的目标构建平台所支持的格式。 参考Default texture formats by platform 。 质量Quality 纹理数组的压缩质量。只有启用压缩时才有效果。 在程序中，此项指TextureCompressionQuality. 换行模式Wrap Mode 纹理数组的纹理坐标换行模式。 在程序中，此项指TextureWrapMode. 过滤模式Filter Mode 纹理数组的纹理过滤模式。 在程序中，此项指FilterMode. 各向异性过滤级别Aniso Level 各向异性过滤级别。 在程序中，此项指Texture.anisoLevel.
  名字Name	指定纹理数组的名字
  贴图大小Texture Size	指定纹理数组中贴图的大小。每张赋予的贴图都要和这里指定的大小相同。
  层数Layer Number	纹理数组中贴图的层数。可以创建2~12层的纹理数组，但MTE免费版用户只能使用4层的纹理数组。
  贴图列表	颜色、粗糙度、法线和AO贴图的列表。每一行代表一层。 要求： 不能有纹理留空。 颜色Color/Albedo贴图必须是启用sRGB的。 法线Normal、粗糙度roughness和环境光遮蔽AO贴图必须是线性的（不启用sRGB） 法线贴图的导入设置中的贴图类型必须是Normal map.

  使用步骤

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

  两个纹理数组的RGBA通道含义

  根据选择的纹理数组模式的不同而不同：

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

  注意 你可以选中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的模型，忽略筛选器。

笔刷

选择要使用的笔刷，这里列出了所有可用的笔刷。绘制贴图时，选中的笔刷将会作为模板应用到贴图上。

贴图

选择要绘制的贴图，这里列出了所有可用的贴图。当筛选器刷新时，所有被MTE地表使用的溅斑(Splat)贴图会被收集到这个列表中。只有当某个MTE地表使用了选择的贴图，此贴图才能绘制到那个MTE地表上。
快捷键：使用小键盘数字键0到8来快速切换贴图。

设置

大小	笔刷大小决定了会被修改的范围。快捷键：-+
流量	笔刷流量决定了贴图被绘制到MTE地表的速度。值1代表着立刻画上去。快捷键：[]. 右键点击标签“流量”来切换拖动条模式：常规或对数(Log)模式。对数模式下可以更精确地调整比较小的流量值。
方向	笔刷方向决定了笔刷模版的朝向，注意它不影响被绘制的贴图的朝向。按住Ctrl滚动滚轮来调整笔刷朝向。

使用步骤

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

相关工具

• 快照工具
  

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

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

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

自定义笔刷

您可以添加或删除笔刷：添加或删除EditorResources\Brushes中的图片，所有笔刷图片的导入选项：

然后点击 刷新笔刷。

权重图的导入设置

权重图（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时:
  渲染的地表的结果不正常：模型变得非常黑或者明亮，或者一些层不起作用。

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

使用步骤

1. 设置形状碰撞体；
2. 在场景中移动、缩放、旋转碰撞体对象；
3. 点击界面上的“包裹”按钮，根据碰撞体对象当前的形状和位置，MTE模型会发生变形。

笔刷

第一个是绘制，第二个是橡皮擦。使用橡皮擦会将顶点颜色擦至纯白色(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地表无法被挖洞。

草

草的原型列表	选中绘制时要使用的草的原型。 GrassLoader组件的Grass Detail List中的原型会显示在此列表中。

设置

大小	指定笔刷大小。快捷键: -+
密度	指定绘制的草的密度。（调整到足够小时，可以绘制单株草） 快捷键: []
数量	显示将要生成的草数量
减量	指定当通过单击删除草时，会有多少草会被删除：100指删除所有笔刷内的草，50指删除50%的草。
方向	制定绘制的草的方向。默认为随机方向。 在不选中Random的情况下，通过按住Ctrl滚动鼠标滚轮，可以指定之后绘制的草的方向。 在不选中Random的情况下，通过按住Ctrl滚动鼠标滚轮，可以更改笔刷范围内已有的草的方向。
允许重叠	选中后将允许草之间重叠，默认不选中

工具

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

使用步骤

1. （每个场景的准备工作）
   1. 创建一个空GameObject作为所有草实例的父GameObject.
   2. 点击附加GrassLoader，为Grasses.asset文件选择合适的位置（比如地形模型文件旁），GrassLoader组件就会被添加到此对象上。
   3. 通过菜单Assets\Create\Mesh Terrain Editor\Grass Detail List创建GrassDetailList asset文件
   4. 选中GrassDetailList asset文件，在检查器（inspector）中，添加草的原型配置。可以添加任意多的原型，但建议不超过10个。
      
      • 点击下方的 添加 按钮，添加新的草原型
      • 可以设置草原型的名字、材质、随机宽高度的最大最小值、类型（单片、三片星形或自定义模型）
      • 右键点击一项草原型的空白处，打开菜单可以删除此项
   5. 点击编辑器的刷新按钮，添加的原型会显示在草原型列表中。
2. 选择用于绘制的草原型。
3. 在地面点击、拖动来绘制草。按住Shift来删除草。
4. 按PageUp撤销，按PageDown重做。
5. 非常重要 不要使用Ctrl + S保存包含草的场景。 应该先选中附加了GrassLoader的GameObject，然后点击Inspector中的4. Clear Preview Grassses & Save Scene。 否则预览用的草会被保存到场景当中。
6. 使用GrassLoader的检查器（inspector）中的4个按钮来烘培有草的场景，按顺序点击1. 2. 3. 4. 即可。

   Grass Detail List	草原型列表，保存草原型的编辑器配置。
   Grass Instance List	草实例列表，保存点云数据，用于运行时生成草模型。
   Is Grass Static	草是否静态，静态的草才会参与光照图烘培等，参考Unity文档
   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对象存在。

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

注意 如果发现生成的草漂浮在地面之上，请检查地面上方是否有符合筛选器的透明碰撞体对象，它们会遮挡笔刷。

预制体

预制体列表	选择要绘制的预制体。 ObjectLoader组件的Detail List中的原型会显示在此列表中。

设置

容器	指定创建的对象的父GameObject.
大小	指定笔刷大小。快捷键: -+
数量	指定当按下鼠标时被绘制的对象数量。快捷键：[]
减量	指定当通过单击删除对象时，会有多少对象会被删除：100指删除所有笔刷内的对象，50指删除50%的对象。
方向	制定绘制的对象的方向。默认为随机方向。 在不选中Random的情况下，通过按住Ctrl滚动鼠标滚轮，可以指定之后绘制的对象的方向。 在不选中Random的情况下，通过按住Ctrl滚动鼠标滚轮，可以更改笔刷范围内已有对象的方向。
允许重叠	选中后将允许绘制的物体之间重叠，默认不选中

使用步骤

1. （每个场景的准备工作）
   1. 创建一个空GameObject作为对象的容器，然后将其拖到编辑器窗口的“容器”中。
   2. 通过菜单Assets\Create\Mesh Terrain Editor\ObjectDetailList创建ObjectDetailList asset文件。
   3. 选中创建的ObjectDetailList asset文件，在检查器（inspector）中添加物体原型。可以添加任意多的原型，但建议不超过10个。
      
      • 点击下方的 添加 按钮，添加新的物体原型
      • 可以设置原型的名字、预制、随机缩放的最大最小值
      • 右键点击一项的空白处，打开菜单可以删除此原型
   4. 将ObjectDetailList asset文件赋值到ObjectLoader组件的Detail List.
      
   5. 点击编辑器的刷新按钮，添加的原型会显示在物体列表中。
2. 在列表中选中要绘制的预制体
3. 在场景中点击、拖拽来绘制对象。按住Shift来删除对象（无法删除没有碰撞体的Prefab，请临时加上后再绘制，绘制完成再移除碰撞即可）。对象会作为子节点，被添加到“容器”对象上。
4. 按PageUp撤销，按PageDown重做。

模式

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

方向

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

设置

大小	指定笔刷的大小。快捷键: -/+
速度	指定笔刷会以多快的速度将流动图上的原方向更改为当前方向。（这不是流动速度） 快捷键: [/]

工具

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

使用步骤

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

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

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

设置

工具

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

Builtin (内置管线的shader)	
   ├── Standard (Standard shader )
   │      ├── 2/3/4/5Textures (2-5层shader: 支持PBR着色模型的部分特性。支持逐层的颜色、法线、粗糙度贴图（或粗糙度数值）； 第5层和第4层共享UV缩放、偏移)
   │      ├── 6/7/8Textures (6-8层shader: 性能极差，不要使用)
   ├── Surface (传统的Surface shader，使用 Lambert 或 Blinn-Phong 着色模型)
   │      ├── 2/3/4/5Textures (2-5层shader: 支持逐层的颜色、法线和高光颜色。第5层和第4层共享UV缩放、偏移)
   │      ├── 6/7/8Textures (6-8层shader: 性能极差，不要使用)
   │      ├── Grass (演示用的草shader)
   │      ├── Vertex-colored (演示用的顶点颜色shader)
   │      └── WaterFlow.shader (演示用的使用流动图的水面shader)
   ├── Specialized (仅适用于特定旧GPU的特殊shader)
   ├── Unlit (不受光的CG shader，支持实时阴影和光照图。)
   ├── TextureArray (基于纹理数组的shader：支持2到12层。)
   ├── MTECommon.hlsl (部分内置渲染管线的shader的通用代码)
   └── MTECommonBuiltinRP.hlsl (部分内置渲染管线的shader的通用代码)
URP (URP shader, 支持PBR着色模型 - 金属工作流)
   ├── URP7 (URP 7.x shaders)
   ├── URP10 (URP 10.x shaders)
   ├── URP12 (URP 12.x shaders)
   ├── URP14 (URP 14.x shaders)
   │      ├── 2/3/4/5Textures.shader (2-5层shader: 支持逐层的颜色、法线、粗糙度贴图（或粗糙度数值）)
   │      ├── 5Textures_DisplayNormal.shader (辅助性shader，用于显示混合后的法线)
   │      ├── Grass.shader (演示用的草shader)
   │      ├── VertexColor.shader (演示用的顶点颜色shader)
   │      └── TextureArray (基于纹理数组的shader：支持2到12层。)
   └── MTECommonURP.hlsl (URP shader的通用代码)

若使用URP管线，请删除不符合项目URP版本的shader目录，否则可能因shader的名字错误造成错误。不同URP版本的同类型的shader使用了相同的名字，Shader.name）。

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

TextureArray shader界面 MTETextureArrayShaderGUI

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

用ASE打开	在ASE中打开当前shader，以便查看和编辑。
Albedo 反照率	包含所有反照率贴图的纹理数组。
粗糙度法线AO	包含所有粗糙度、法线、AO贴图的纹理数组。这些贴图是打包过的，详情请看两个纹理数组的RGBA通道含义.
UV缩放	采样层贴图时，对地形UV的缩放
法线强度	调整法线的强弱
层数	会被shader使用的层数。修改会自动增加权重图，但不会删除权重图。
权重图	这里的权重图仅供预览，请不要手动编辑他们。 点击调整，修改权重图的大小和朝向。注意，如果有多张权重图，先确保调整为相同的大小，再继续画贴图。
启用法线强度	点击切换是否启用法线强度。
启用金属度	点击切换是否启用金属度。启用后，shader会启用keyword ENABLE_METALLIC，从而使用存储于第1个纹理数组的Alpha通道的金属度信息来表现金属光泽。
启用逐层的UV缩放	点击切换是否启用逐层的UV缩放 启用时，将会打开keyword ENABLE_LAYER_UV_SCALE，从而使用通过LayerUVScalesHolder组件设置的材质float数组作为每层贴图的缩放。LayerUVScalesHolder组件需要添加到模型对象上，来使用和调整每层的贴图纹理缩放。

旧式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）来浏览历史编辑信息。

工具	一组切换按钮，用于隐藏不需要的主工具按钮。
使用紧凑界面	选中此项后界面会变得紧凑：
标识点大小	调整标识点、碰撞点等等的大小。实际的大小可以在场景中预览。
闪烁	选中此项后会闪烁标识点。开启此项可能会影响性能。
显示笔刷矩形	选中此项后会显示当前笔刷的矩形区域（从+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.

   请到 设置窗口/快捷键 确认可用的快捷键。

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属性

15. 编辑器Log在哪里？怎么打开？

    编辑器log所在的目录可以通过菜单项Window/Mesh Terrain Editor/Debug/Open Editor Log打开

    Editor.log 和 Editor-prev.log 就是编辑器Log文件。

16. 刷不了贴图怎么办？

    请按照以下步骤查错：

    • 查看Console窗口有没有红字报错，如果报错是在尝试刷贴图时出现的，请反馈问题：将操作步骤、报错的截图、报错的文本内容发给我们。
    • 如果编辑器中的纹理列表是空的，打开筛选器列表，确保通过筛选的对象包含你要编辑的MTE模型对象；如果没有，请确保满足以下的条件，再刷新筛选。
      1. 编辑对象是active的
      2. 编辑对象的tag和layer和MTE编辑器相同
      3. 编辑对象有MeshFilter组件
      4. 编辑对象的MeshFilter组件有Mesh
      5. 编辑对象有MeshCollider组件
      6. 编辑对象的MeshCollider组件有Mesh
      如果使用的是MTE免费版，只有前2个通过筛选的对象会被保留，请查看筛选器的文档，确保要编辑的对象通过了筛选再进行操作。
    • 如果使用的是纹理数组：
      1. 纹理数组设置文件（TextureArraySettings.asset）没有放到纹理数组的文件旁边。这样会导致MTE编辑器无法找到对应的原始贴图。请将它们放在一起后，刷新筛选器，再试。
      2. 纹理数组设置的Name（名称）参数在创建过纹理数组后，被修改了，同样会导致MTE编辑器无法找到对应的原始贴图。请将名字恢复为纹理数组的名字（不含后缀）后，刷新筛选器，再试。
    • 如果鼠标放在地面上没有笔刷显示：
      1. 确定编辑对象没有缩放（因为被缩放过的模型的编辑功能没有测试过，不能保证功能正常），如果有缩放，修改为1,1,1再试。
      2. 去掉编辑对象的MeshCollider组件的勾再勾选上，刷新筛选，再试。
      3. 确定编辑对象的MeshCollider组件没有勾选“Convex”，如果有，去掉后再试。
      4. 如果还是没有显示笔刷，请向反馈问题。
    • 如果鼠标放在地面上有笔刷显示，但点击、拖动鼠标时没有绘制纹理：
      1. 确定编辑对象的权重图（也称控制图、Control Map、SplatAlpha 0/1.png）的导入选项中，Read/Write Enabled是勾选的，如果不是，请勾选并apply后再试。
      2. 如果使用的是“多个筛选”模式，请确保你的模型符合以下要求
         1. 是完整的正方形的，不缺少任何一个角
         2. 纹理uv是连续的，并且铺满整个第一象限（又称01区间, 1st quadrant），如图，左下角的蓝色顶点（u=0,v=0）和右上角的红色顶点（u=1,v=1）必须存在于模型上，并且他们作为包围盒在2D平面上的最小和最大的两个顶点。如下图所示
            
            图中的两个黄色粗三角形，就是包含了（u=0,v=0）和（u=1,v=1）的两个三角形
         3. 确定没有其他（透明）对象也通过了筛选，也就是和筛选器使用相同的标签（tag）和图层（layer），并且覆盖在了你正在绘制的区域上方，如果有这样的对象，MTE编辑器的笔刷会被它们挡住，导致无法正常编辑，请将它隐藏、移除或让它不通过筛选，再试。
      3. 如果使用的是“单个选中”模式：
         1. 确定编辑对象的权重图（又称SplatAlpha、控制图）有没有被修改： 选中地形权重图，让它的预览窗口显示出来，锁定它的检查器（inspector）窗口，然后尝试绘制纹理，观察预览窗口中权重图是否有变化。如果权重图有变化，但笔刷位置处的地面贴图没有变化，说明您使用的自定义模型的uv在鼠标所处的位置或附近不连续或有断层。
         2. 模型的uv在需要绘制的位置是连续分布的，没有断开。
         3. 确定没有其他（透明）对象在相同的层（layer），并覆盖在了你正在绘制的区域上方，如果有这样的对象，MTE编辑器的笔刷会被它们挡住，导致无法正常编辑，请将它隐藏后再试。

17. 如何重置MTE?

    点击菜单项Window -> Mesh Terrain Editor -> Debug -> Reset Mesh Terrain Editor，注意此操作会引起一次代码编译。

18. 发生错误 System.ExecutionEngineError: String conversion error: illegal byte sequence encountered in the input.

    确保工程的路径不包含非ASCII字符，如中日韩字符，然后重新打开工程。

2024-05-24 v5.0.0-beta1

* MTE5不再使用序列号激活，而是登录zwcloud.co网站账户。现在使用网站账户在MTE5内登录后，如您拥有或获得MTE5专业版席位且席位处于有效状态，您就可以使用MTE5专业版所有功能。
* 增加安装功能，位于菜单项 Window/Mesh Terrain Editor/Install，会自动删除不兼容的URP shader目录

2024-05-22 v4.4.0

2023-12-14 v4.3.0

2023-11-16 v4.2.7

2023-09-21 v4.2.5

2023-09-12 v4.2.4

2023-09-11 v4.2.3

2023-09-04 v4.2.2

2023-07-25 v4.2.1

2023-05-22 v4.2.0

2023-03-28 v4.1.2

2023-03-06 v4.1.1

2023-02-25 v4.1.0

2023-01-28 v4.0.7

2022-12-26 v4.0.5

2022-10-20 v4.0.2

2022-09-06 v4.0.1

（建议的方式）加入以下实时交流群组：

• 飞书群组
• QQ群1群(已满) 689511734, 2群 122466137
• 微信

提交问题或新功能需求：MTE问题追踪（GitHub）

电子邮件 zwcloud@hotmail.com

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