Model Editor

Model editor is a view in McME that allows you manipulating custom models. You can add limbs, edit their transformations, properties and also remove them (and their child limbs).

With model editor you can also render your models to PNG image and save for usage in YouTube thumbnail, forum avatar or whatever you feel like creating.

Tools

Texture editor provides some basic tools for drawing a texture for model.

• Move M — move the model. Without modifiers, this tool spins the model along X and Y axes. With Shift modifier, it spins the model along X and Z axes. With Alt modifier, it moves (translates) the model along X and Y axes (i.e. horizontally and vertically).
• Select Limb L — selects a limb that you've clicked on for further manipulation (see settings and other tools below).
• Translate T — translates selected limb along X and Y axes. With Shift modifier, it will translate the limb along X and Z axes.
• Rotate R — rotates selected limb along X and Z axes. With Shift modifier, it will rotate the limb along Y and X axes.
• Scale S — scales selected limb.

There's also two buttons near the tool bar which allows you to add a limb or remove selected limb.

Key Bindings

Here are listed all, beside tool key bindings, key bindings which available in the model editor. Those key bindings are working only when the model editor is focused.

• O — Toggle camera (see orthographic camera setting).
• D — Deselect current selected limb.
• S — Show or hide settings.
• H — Hide the model editor.

Settings

There are so much settings in the settings sidebar. Let me cover all of them.

General

General section has really general options related to the model. The value in Model's name will be displayed in Blockbuster's actor GUI when switching between different models. Select a limb will select a limb in the list, this is very helpful for selecting limbs that are covered by overlay layers.

Import and export buttons allows you to import and export JSON models.

Rendering

Rendering section isn't affect the model's propeties, only the visuals. Those options that available in this section are only helpful while editing or for rendering of your model.

When Show AABB is checked, you'll see red box around the model. Keep close attention to bottom and top parts of the model. If your model is out of the hit box vertically, its legs or head may overlap with blocks which may look undesired. So keep your model in the red box (see also Poses section and its Size field).

Orthographic camera check box is responsible for making model look flat. This option can be used for rendering or for better precision when placing limbs inside of AABB.

Shadows, HD shadows and Lighting checkboxes are visual options. They're only might be helpful for rendering. They're also self explanatory.

Reset camera button will reset the position and rotation of the model which you modified with Move tool.

Limb Properties

There's basically three sub sections in Limb Properties section. Limb's name, Gameplay Properties and Visual Properties.

Limb's name is pretty straight forward field, it's id for a limb.

Gameplay Properties are goes after Limb's name field. They're not seen visually in model editor, but will affect visuals in the game very drastically.

Looking check box will make limb face towards direction in which player looks. So it's basically for head (or several heads, if you're doing an Ogre or Cerberus).

Holding items options will display an item on the opposite end of anchor (if anchor is in the middle, then the item will be in the anchor). You can specify this option for several limbs, so characters like Goro or General Grievous would look really cool with two set of diamond swords.

Swinging check box will basically make limb swing when character is running.

Swiping check box will make limb make swipe motion when player will press attack key binding (or mouse button).

Visual Properties are affecting how limb looks. Most of these properties are related to size, rotation point, transformation origin, texture offset, and etc.

Parent option will attach selected limb to another limb and all transformations will be relative to limb's transformations and it's anchor.

Texture offset is responsible for texture mapping, it will specify coordinates to which texture faces will be mapped. See also the Size field, because it's also affecting texture mapping.

Mirror field is responsible for reflecting texture coordinates along X axis. Basically it reflects the texture mapping horizontally (if you're looking from front).

Size field is responsible for two things: the size of the limb (it's volume) and size for faces' texture mapping. Use option Show limb guides to see how texture would be mapped on limb in texture editor.

Anchor field is responsible for how transformations for rotation and scale are being applied. The values of every compoment should range between 0 and 1. 0.5 is the middle of the limb.

Poses

Poses section is responsible for managing the limb transformations for every pose. Examples of poses are standing, sneaking (when you press shift), sleeping in bed or flying an elytra. In future, there will probably be more different poses, or a function to create custom poses.

With Current pose field, you can select which pose to are you going to edit.

Size field is responsible for setting AABB (hitbox) of the entity during this pose. Use Rendering option called Show AABB to see how the Size field affects the AABB.

Translate, Scale and Rotate fields are pretty self explanatory, so there's no need to explain them. The only thing to note that all transformations regarding those fields are being relative to Anchor and limb's Parent.