vrr/Mate-Engine
2
0
Fork 0
mirror of https://github.com/shinyflvre/Mate-Engine.git synced 2026-08-16 12:03:31 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Mate-Engine/Assets/UMotionEditor/Manual/Tools.html
shinyflvre 091ae7be88 Public Release X3.0b 
# MateEngine X3.0

## Windows and Taskbar Sitting Rewrite

* Avatars sit more naturally on windows and the taskbar. Legs render in front while hair renders behind for a seamless look.
* Transitions between dragging and sitting are smoother.
* Alignment with windows and the taskbar improved. If a model looks off adjust **Y Offset** in settings. Some models may need minor manual tweaks due to different bone rigs.
* You can give headpats while the avatar sits. The avatar closes its eyes and shows sparkling particles. More headpat animations will be added later.
* The avatar no longer jumps off the taskbar when the Windows Start Menu or Search opens.
* You must hold the avatar for at least one second before it will sit to prevent accidental sits during fast moves.

## Feed System (Alpha)

* Avatars can drink. Press the middle mouse button to open the Food Radial menu. Spawn smoothies and bring them to the avatar to feed. This is an early access feature.
* When Spawning a Smoothie it will always spawn a Random smoothie! Keep in mind this feature is new and not perfect but i think it is a nice to have!

## Drag Smoothing

* Dragging the avatar feels smoother and more stable.
* A light smoothing effect was added to make dragging natural without noticeable delay.

## Taskbar Sitting Changes

* The circle menu is disabled while the avatar sits on the taskbar, showing only **Jump Off**.
* This prevents visual overlap from other UI while sitting.
* Moving the menu up while sitting increases cost, so it remains off for taskbar sitting but works normally on window sitting.

## Animation Changes

* Minor rotation adjustments to dragging animations.
* Improved transition timing for intimate animation for smoother flow.

## Minecraft Integration

MateEngine reacts to Minecraft events in real time. The avatar comments on gameplay, warns about danger, and celebrates victories.

### How it works

* Install the **MateSignal Forge mod** in Minecraft and run **MateEngine** on the same device or local network.
* MateSignal forwards in-game events to MateEngine so the avatar can display messages or play animations.
* Intended for singleplayer and private multiplayer use. Avoid competitive or official servers where live alerts could be an unfair advantage.

### Examples of reactions

* Day start: cheerful wake-up
* Night start: reminder to stay safe
* Nearby mobs: instant warnings for creepers, zombies, etc.
* Low health or hunger: worried or encouraging lines
* Crafting: excited comments
* Weather: reactions when rain starts
* Death: sad or comforting messages
* Biome discovery: happy or curious reactions
* Eating: cheering during meals
* Killing mobs: victory reactions

### Requirements

* Minecraft 1.21.10
* Forge Mod Loader
* MateSignal installed and integration enabled in MateEngine

## Dance Player Update

* Added **Lock Mode (Experimental)**. Enables camera tracking for dances that move the avatar far left or right so the window follows their motion.

## Hand Tracking Changes

* Hand tracking is more accurate to the mouse position.
* Reduced activation zone to prevent unwanted tracking on smaller avatars.

## Buy Option

* Added a buy button to the Minecraft Integration and Steam DLC categories. These buttons appear when running the free GitHub build.

## Bug Fixes

* Avatars no longer attach to windows or the taskbar while custom dances are active.
* Fixed avatar disappearing after sitting on minimized windows.
* Fixed incorrect positioning when a window closes.
* Fixed teleport when a window is maximized.

## Internal Changes

* Removed unused code to reduce missing script warnings.
* General cleanup and small performance adjustments.
2025-11-01 10:12:19 +01:00

310 lines
14 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<link rel="shortcut icon" type="image/png" href="styles/UMotionFavicon.png" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>UMotion Manual - Tools</title>
<link rel="stylesheet" type="text/css" href="styles/theme_styles.css" media="screen">
<link rel="stylesheet" type="text/css" href="styles/treeview_styles.css" media="screen">
<link rel="stylesheet" type="text/css" href="styles/element_styles.css" media="screen">
</head>
<body>
<div class="header">
<div class="headerLogo">
<img src="styles/UMotionLogoHeader.png"></img>
</div>
<div class="headerBlueRight">
<a href="https://www.soxware.com" class="headerLink">soxware.com</a>
</div>
</div>
<div class="versionHeader">
<p class="versionText">Version: <b>1.29p04</b> </p>
</div>
<div class="leftContent">
<div class="leftContentInner">
<div class="leftContentHeadline">
UMotion Manual
</div>
<!-- Tree View -->
<ol class="tree">
<li class="file"><a href="UMotionManual.html">UMotion Manual</a></li>
<li class="file"><a href="Introduction.html">Introduction & Tips</a></li>
<li class="file"><a href="GettingStarted.html">Getting Started</a></li>
<li>
<label for="VideoTutorials"><a href="VideoTutorials.html" class="treeFolderLink">Video Tutorials</a></label> <input type="checkbox" id="VideoTutorials" />
<ol>
<li>
<label for="GeneralTutorials"><a href="GeneralTutorials.html" class="treeFolderLink">General</a></label> <input type="checkbox" id="GeneralTutorials" />
<ol>
<li class="file"><a href="QuickStart.html">Quick Start Tutorial</a></li>
<li class="file"><a href="Lesson1.html">1) Installation & First Steps</a></li>
<li class="file"><a href="Lesson2.html">2) Pose Editing</a></li>
<li class="file"><a href="Lesson3.html">3) Clip Editor</a></li>
<li class="file"><a href="Lesson4.html">4) Curves & Rotation Modes</a></li>
<li class="file"><a href="Lesson5.html">5) Config Mode</a></li>
<li class="file"><a href="Lesson6.html">6) Export Animations</a></li>
<li class="file"><a href="Lesson7.html">7) Root Motion</a></li>
<li class="file"><a href="Lesson8.html">8) Animation Events</a></li>
<li class="file"><a href="Lesson9.html">9) Pose Mirroring</a></li>
</ol>
</li>
<li>
<label for="ProfessionalExclusive"><a href="ProfessionalExclusive.html" class="treeFolderLink">UMotion Pro</a></label> <input type="checkbox" id="ProfessionalExclusive" />
<ol>
<li class="file"><a href="ProLesson1.html">1) Importing Animations</a></li>
<li class="file"><a href="ProLesson2.html">2) Inverse Kinematics</a></li>
<li class="file"><a href="ProLesson3.html">3) Child-Of Constraint</a></li>
<li class="file"><a href="ProLesson4.html">4) Custom Properties</a></li>
<li class="file"><a href="ProLesson5.html">5) IK Pinning</a></li>
</ol>
</li>
<li>
<label for="InPractice"><a href="InPractice.html" class="treeFolderLink">In Practice</a></label> <input type="checkbox" id="InPractice" />
<ol>
<li class="file"><a href="InPractice1.html">1) Our First Animation</a></li>
<li class="file"><a href="InPractice2.html">2) Editing Animations</a></li>
<li class="file"><a href="InPractice3.html">3) Customizing an animation for a RPG</a></li>
<li class="file"><a href="InPractice4.html">4) Unity Timeline & Weighted Tangents</a></li>
</ol>
</li>
<li>
<label for="Jayanam"><a href="Jayanam.html" class="treeFolderLink">Jayanam</a></label> <input type="checkbox" id="Jayanam" />
<ol>
<li class="file"><a href="Jayanam1.html">UMotion Tutorial</a></li>
</ol>
</li>
</ol>
</li>
<li class="file"><a href="HowToCreateBetterAnimations.html">How to create better animations</a></li>
<li>
<label for="ClipEditor"><a href="ClipEditor.html" class="treeFolderLink">Clip Editor</a></label> <input type="checkbox" id="ClipEditor" />
<ol>
<li>
<label for="MenuBar"><a href="MenuBar.html" class="treeFolderLink">Menu Bar</a></label> <input type="checkbox" id="MenuBar" />
<ol>
<li class="file"><a href="MenuBarFile.html">File</a></li>
<li class="file"><a href="MenuBarEdit.html">Edit</a></li>
<li class="file"><a href="MenuBarHelp.html">Help</a></li>
</ol>
</li>
<li class="file"><a href="Preferences.html">Preferences</a></li>
<li class="file"><a href="ImportExport.html">Import / Export</a></li>
<li class="file"><a href="FKtoIKConversion.html">FK to IK Conversion</a></li>
<li>
<label for="MainNavigation"><a href="MainNavigation.html" class="treeFolderLink">Main Navigation</a></label> <input type="checkbox" id="MainNavigation" />
<ol>
<li class="file"><a href="ProjectSettings.html">Project Settings</a></li>
<li class="file"><a href="ClipSettings.html">Clip Settings</a></li>
</ol>
</li>
<li class="file"><a href="AnimatedPropertiesList.html">Animated Properties List</a></li>
<li class="file"><a href="RootMotion.html">Root Motion</a></li>
<li class="file"><a href="RotationModes.html">Rotation Modes</a></li>
<li>
<label for="DopesheetCurves"><a href="DopesheetCurves.html" class="treeFolderLink">Dopesheet / Curves View</a></label> <input type="checkbox" id="DopesheetCurves" />
<ol>
<li class="file"><a href="Dopesheet.html">Dopesheet</a></li>
<li class="file"><a href="Curves.html">Curves View</a></li>
</ol>
</li>
<li class="file"><a href="Playback.html">Playback Navigation</a></li>
<li class="file"><a href="Layers.html">Layers</a></li>
</ol>
</li>
<li>
<label for="PoseEditor"><a href="PoseEditor.html" class="treeFolderLink">Pose Editor</a></label> <input type="checkbox" checked id="PoseEditor" />
<ol>
<li>
<label for="ConfigMode"><a href="ConfigMode.html" class="treeFolderLink">Config Mode</a></label> <input type="checkbox" id="ConfigMode" />
<ol>
<li>
<label for="RigHierarchy"><a href="RigHierarchy.html" class="treeFolderLink">Rig Hierarchy</a></label> <input type="checkbox" id="RigHierarchy" />
<ol>
<li class="file"><a href="IKSetupWizard.html">IK Setup Wizard</a></li>
<li class="file"><a href="MirrorMapping.html">Mirror Mapping</a></li>
</ol>
</li>
<li class="file"><a href="Configuration.html">Configuration</a></li>
<li class="file"><a href="ConfigDisplay.html">Display</a></li>
</ol>
</li>
<li>
<label for="PoseMode"><a href="PoseMode.html" class="treeFolderLink">Pose Mode</a></label> <input type="checkbox" checked id="PoseMode" />
<ol>
<li class="file"><a href="Tools.html"><b><u>Tools</u></b></a></li>
<li class="file"><a href="Channels.html">Channels</a></li>
<li class="file"><a href="Selection.html">Selection</a></li>
<li class="file"><a href="PoseDisplay.html">Display</a></li>
<li class="file"><a href="Animation.html">Animation</a></li>
</ol>
</li>
<li>
<label for="Constraints"><a href="Constraints.html" class="treeFolderLink">Constraint System</a></label> <input type="checkbox" id="Constraints" />
<ol>
<li class="file"><a href="InverseKinematics.html">Inverse Kinematics</a></li>
<li class="file"><a href="ChildOf.html">Child-Of</a></li>
<li class="file"><a href="CustomProperty.html">Custom Property</a></li>
</ol>
</li>
<li class="file"><a href="Options.html">Options</a></li>
<li class="file"><a href="ToolAssistant.html">Tool Assistant</a></li>
</ol>
</li>
<li class="file"><a href="EditInPlayMode.html">Edit In Play Mode</a></li>
<li class="file"><a href="UnityTimelineIntegration.html">Unity Timeline Integration</a></li>
<li class="file"><a href="UMotionAPI.html">UMotion API</a></li>
<li class="file"><a href="ExportingAnimationsFAQ.html">Exporting Animations FAQ</a></li>
<li class="file"><a href="Support.html">Support / FAQ</a></li>
<li class="file"><a href="ReleaseNotes.html">Release Notes</a></li>
<li class="file"><a href="KnownIssues.html">Known Issues</a></li>
<li class="file"><a href="Credits.html">Credits</a></li>
</ol>
</div>
</div>
<div class="mainContent">
<div class="mainContentInner">
<h1 class="headline1" id="">Tools</h1><p class="textBlock">The tools are used to modify the bones/transforms of the animated GameObject in the Scene View to create the different poses required for the animation.</p><img src="images/PoseEditorTools.png" class="image"></img>
<p class="imageText">Pose Mode - Tools</p><table class="themeTable">
<tr class="themeTableRow">
<th class="themeTableHeader">UI Element</th>
<th class="themeTableHeader">Description</th>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Pivot</td>
<td class="themeTableCell">The pivot mode changes the orientation of the move, rotate and scale tool. It can either be aligned to the global coordinate system of the scene or the local coordinate system of the current selected joint/transform.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Select Tool</td>
<td class="themeTableCell">The select tool allows selecting joints/transforms. Selecting is also possible with every other tool, but the select tool displays no tool handle. This is useful as the tool handle often occludes the joint/transform that should be selected. To select a joint/transform it needs to be clicked with the <span class="keyboardKey">left mouse button</span>.
</br>
</br>When holding <span class="keyboardKey">CONTROL</span> while clicking, previous selected joints/transform stay selected.
</br>
</br>When holding <span class="keyboardKey">SHIFT</span> while clicking all children of the clicked joint/transform are selected.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Move Tool</td>
<td class="themeTableCell">With the move tool the position of a joint/transform can be changed.
</br>
</br><span class="keyboardKey">SHIFT</span> enables the free move mode where movement can be performed freely in all 3 dimensions.
</br>
</br>Joints (bones) are usually not modified with this tool.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Rotate Tool</td>
<td class="themeTableCell">
With the rotate tool the orientation of a joint/transform can be changed.
</br>
</br>Tip: When child bones are selected, they are also rotated. This is very useful for animating a tail.
</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Scale Tool</td>
<td class="themeTableCell">With the scale tool the local scale of a joint/transform can be changed. The scale tool only supports the local pivot mode.
</br>
</br>Joints (bones) are usually not modified with this tool.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Mirror Editing</td>
<td class="themeTableCell">When enabled, every editing action is automatically copied to the other side. It uses the <a href="MirrorMapping.html" class="link">Mirror Mapping</a> to define which bone/transform maps to which bone/transform on the other side (e.g. "Left Hand" maps to "Right Hand").</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Set FK to IK</td>
<td class="themeTableCell">Bones/transforms selected in the FK rig layer will be oriented the same way as they are in the IK rig layer.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Set IK to FK</td>
<td class="themeTableCell">Sets the current selected IK handle to the position/rotation its IK target has in the FK rig layer.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Copy to Other Side</td>
<td class="themeTableCell">Copies the properties of the selected bones/transforms to their equivalents on the other side. It uses the <a href="MirrorMapping.html" class="link">Mirror Mapping</a> to define which bone maps to which bone on the other side (e.g. "Left Hand" maps to "Right Hand").
</br></br>
<b>Tip:</b> When bones/transforms on both sides are selected, their poses are "swapped" with the appropriate pose on the other side. This affectively mirrors the pose of the selected bones/transforms. Select all bones/transforms to mirror the complete pose.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Apply Reference Pose</td>
<td class="themeTableCell">Applies the configured <a href="Configuration.html#ReferencePose" class="link">Reference Pose</a> to the selected bones/transforms. If the current layer is "additive" the position/rotation/scale values are set to 0 instead.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Reset Modifications</td>
<td class="themeTableCell">Resets the modifications of the selected joint/transform. A context menu to choose which properties of the selected joints/transforms should be reset is shown. Modified bones are displayed in red (unless the color was changed in the <a href="Options.html" class="link">Options</a>).</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Copy Pose</td>
<td class="themeTableCell">Copies the current pose of the entire animated character/object.</td>
</tr>
<tr class="themeTableRow">
<td class="themeTableCell" style="white-space: nowrap;">Paste Pose</td>
<td class="themeTableCell">Pastes a previously copied pose. If no bones/transforms are selected, the entire pose of the entire animated character/object is pasted. If some bones/transforms are selected, the pose of only the selected bones/transforms is updated.</td>
</tr>
</table><p class="textBlock"><b>Important:</b> If bones/transforms don't mirror correctly to the other side using <b>Mirror Editing</b> or <b>Copy to Other Side</b>, you should check the mirror mapping entries for those bones.</p>
<div class="mainContentFooter">
<p class="textBlock" style="float:left">Copyright © 2017 - 2021 Soxware Interactive ALL RIGHTS RESERVED</p>
<p class="textBlock" align="right"><a href="https://forum.unity.com/threads/new-umotion-animation-editor-released.490618/" class="link">Unity Forum Thread</a> | <a href="https://www.facebook.com/Soxware/" class="link">Facebook</a> | <a href="https://twitter.com/SoxwareInteract" class="link">Twitter</a> | <a href="https://www.youtube.com/channel/UCCuE6nI5gHvUQjx0lo6Twtg" class="link">Youtube</a></p>
</div>
</div>
</div>
</body>
</html>
Reference in a new issue View git blame Copy permalink