diff --git a/emotecraft/creatingemotes/blender.md b/emotecraft/creatingemotes/blender.md index 9aa09e7..ac20258 100644 --- a/emotecraft/creatingemotes/blender.md +++ b/emotecraft/creatingemotes/blender.md @@ -5,29 +5,32 @@ description: "How to create emotes using Blender rigs." # Creating Emotes With Blender -To make emotes in Blender, you need to use one of the available rigs on Emotecraft's [GitHub](https://github.com/KosmX/emotes/tree/dev/blender). Please read the README.md. -This guide is based on the `emote_creator` one as it has more features. +To make emotes in Blender, you need to use the `emote_creator` rig from Emotecraft's [GitHub](https://github.com/KosmX/emotes/tree/dev/blender). Please read the README.md. It is expected for you to already be familiar with Blender in some way. If you are not, please read the [Blender Documentation](https://docs.blender.org/manual/en/latest/) first. I recommend reading the `User Interface`, `Editors`, `Scenes & Objects` and `Animation` sections. -# How do I make emotes?? -You animate, then go to the `Export` tab, change the contents of the variables to your liking and run the script. Your emote will be placed in the same directory as the rig. -To make the animation loop, check the `Cyclic Animation` box in the action properties. -The range of frames that gets exported is defined by the `start` and `end` fields in the action properties. -`loopTick` is set to the start frame of the scene. Find out more about it in the [looping](./looping.md) section of the wiki. +# How do I make emotes? +Firstly, when you open the project you have to run the script in the bottom of the screen. It adds new fields and buttons to the Action panel of Action Editor so you can setup and export your emote. You can [register](https://docs.blender.org/manual/en/5.2/editors/text_editor.html#text-menu) the script so it runs automatically when you open the project. + +Now you animate. When you are done, open the Action tab of the Action Editor. Here you can configure your emote: set the name, description, author, badges, save directory etc. + +To make the animation loop, check the `Cyclic Animation` box. When you do, the `Hold on last frame` checkbox will appear to set [looping](./looping.md) mode to `hold_on_last_frame`. +By default the range of frames that gets exported is `0 - *scene's end frame*`. If you want a different range, check the `Manual Frame Range' checkbox and set the `start` and `end` fields to the values you want. They must be integers(otherwise they will be rounded down on export). +`loopTick` is set to the scene's start frame. Find out more about it in the [looping](./looping.md) section of the wiki. + The name of the file will be the same as the name of the active action. :::warning For the animation to be exported for an axis, there has to be at least one keyframe placed on it! ::: -If you don't want a bone to be exported, comment it from the export_bones list in the script. If you want to add [custom pivot bones](./custom_pivot_points.md), you have to add them to the list. +If you add new bones to the armature, that you want to export as [custom pivot bones](./custom_pivot_points.md), you need to add them to the Pivot Bones list with the `+` button. Default rotation of the custom pivot bones should be aligned with the world axes. -The icon is created on export automatically. In the `Export` tab you can place the camera and set the frame for an icon. +The icon is created on export automatically. In the `Icon` tab you can place the camera and set the frame for an icon. -There is a switch in bone properties to enable vanlla mode, so the limbs imitate bending without actually being bent. IK sliders are also in bone properties. +There is a switch in `settings` bone properties to enable vanlla mode, so the limbs imitate bending without actually being bent. IK sliders are also in `settings` bone properties. There is a custom property on the head that makes it look at the `head_goal` bone. -There are bone groups so you can show or hide some parts of the rig. +There are bone groups so you can show or hide some parts of the rig (this wont affect the emote in the game). # You can - Add new bones -- they will be exported as [custom pivot bones](./custom_pivot_points.md) @@ -43,4 +46,8 @@ There are bone groups so you can show or hide some parts of the rig. - Drivers don't get exported. - Easings may look incorrect, because they work differently in Blender compared to the game. - +# Blockbench compatibility +This rig exports emotes in the same format as Blockbench does, so if you are following some rules, you can get the animation to be able to be imported to Blockbench: +1. When you place a keyframe place on on all the 3 axes. For example if you change location, put a keyframe on x, y, and z. Same with rotation and scale. +2. Don't use bezier interpolation. +3. You'll have to add custom pivot bones to the Blockbench rig -- body_control and waist -- if you use them. \ No newline at end of file