71 lines
3.3 KiB
Markdown
71 lines
3.3 KiB
Markdown
# Editor
|
||
|
||
Files for using the Unity editor
|
||
|
||
## Installation
|
||
|
||
Place the "Editor" folder anywhere in your project Assets folder.
|
||
|
||
## Usage
|
||
|
||
### MeshPostProcessor
|
||
|
||
Used to perform various operations to models on import to unity
|
||
|
||
#### Add Colliders
|
||
|
||
To convert objects to colliders on import, add the following strings to the object's name:
|
||
|
||
* `_COLLIDER`: Converts to a mesh collider
|
||
|
||
* `_SPHERECOLLIDER`: Converts to a sphere collider
|
||
|
||
* `_CAPSULECOLLIDER`: Converts to a capsule collider, with the axis along the object's longest axis
|
||
|
||
* `_BOXCOLLIDER`: Converts to a box collider. The box will be aligned to the object's local coordinates
|
||
|
||
#### Merge Meshes
|
||
|
||
Add `_MERGE` to an object's name, and all its child objects meshes will be automatically merged into one. Does not work for skinned meshes
|
||
|
||
#### Delete Objects
|
||
|
||
Add `_DEL` to an object's name to delete it on import
|
||
|
||
#### Trim animations
|
||
|
||
Automatically removes any animations with only 2 keyframes to make them easier to edit manually
|
||
|
||
#### Additional Notes (when used in conjunction with Taniwha’s Blender Mu Importer)
|
||
|
||
For those who use Taniwha’s Blender importer, to import existing .mu’s, the following steps & notes
|
||
need to be addressed before importing your model into Unity with the MeshPostProcessor installed.
|
||
|
||
1) You need to make sure you only suffix the name of the *object*, and *not* of the mesh, with the above operators.
|
||
2) In Blender, you need to convert any imported collider instances to “real”.
|
||
a) To do this, in Object Mode, select the collider instance object, then select:
|
||
Object→Apply→Make Instances Real (Shift-Ctrl-A)
|
||
b) Then move the new object back into it’s original place in your hierarchy.
|
||
Holding Shift+Alt while dragging/dropping will keep its transforms/properties.
|
||
c) Rename the *object* name, adding the appropriate operator suffix.
|
||
(I suggest removing the “collider:” prefix from the *mesh* name, but thats just personal preference)
|
||
3) Now you have to go into Edit Mode, and fill in all the faces in the mesh. Check that all of
|
||
the created face normals are facing outside.
|
||
(When you make real the collider instances, only vertices & edges seem to get created, and not faces.)
|
||
This will be apparent, if upon Unity import, you get this error, or similar in the Console window:
|
||
‘Can't calculate tangents, because mesh '<your_object_name>_BOXCOLLIDER|mesh:<your_mesh_name>|Dupli|' doesn't contain normals.’
|
||
|
||
### TexturePostProcessor
|
||
|
||
Used to perform various operations on textures on import to Unity. Configured with constants in the top of the file.
|
||
|
||
Only works on files with the extension `EXTENSION` (default ".png").
|
||
|
||
#### Specular maps
|
||
|
||
If `SPEC_ENABLE` is enabled (default true), textures with the suffix `SPEC_TAG` (default "-spec") will be copied into the alpha channel of the texture without that suffix. For example, the file `foo-spec.png` will be copied into the alpha channel of the imported texture `foo.png`.
|
||
|
||
#### Normal maps
|
||
|
||
If `NORMAL_ENABLE` is enabled (default true), textures with the suffix `NORMAL_TAG` (default "-spec") will be marked as normal maps on import and when KSP PartTools exports the texture. if `NORMAL_GENERATE` is enabled (default true), then the texture will automatically be converted from a hightmap using Unity's normal map generation tool.
|