NOTE: The previous library of functions is still here. It's just moved to the \MobuCore\MobuCoreLibrary\ folder.
MobuCore is a collection of python scripts and functions for common tasks in Autodesk Motionbuilder.
MobuCore was written by Dan Lowe, who you can reach on Twitter at https://twitter.com/danlowlows (at time of writing, direct messages are open).
MobuCore is made available under the following license terms:
Copyright (c) 2019 Dan Lowe
This software is provided 'as-is', without any express or implied warranty. In no event will the author be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
-
The origin of this software must not be misrepresented; you must not claim that you wrote the original software.
-
If you use this software, in source or binary form, an acknowledgment in the product documentation or credits would be appreciated but is not required. Example: "This product uses MobuCore (c) 2019 Dan Lowe."
-
Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
-
This notice may not be removed or altered from any source distribution.
Installation instructions...
- Download the entire MobuCore repository.
- Drop the files in the Motionbuilder /PythonStartup/ folder located under \Documents\MB\ e.g. C:\Users\Dan\Documents\MB\2018-x64\config\PythonStartup.
- Start Motionbuilder.
- You should see a new Menu in the top menu bar called MobuCore, which contains the correct menu items.
If you don't see the MobuCore menu, something went wrong. Be sure that the files are in the PythonStartup folder correctly. MobuCoreStartUp.py and the \MobuCore\ folder that contains MobuCoreLibrary, MobuCoreMenu and MobuCoreTools, should be directly in the PythonStartup folder, like so: C:\Users\Dan\Documents\MB\2018-x64\config\PythonStartup\MobuCoreStartup.py and C:\Users\Dan\Documents\MB\2018-x64\config\PythonStartup\MobuCore.
Menu Options...
- Adjustment Blending: This a method for adjusting additive layer interpolation between keyframes, so that movement on the layer is shifted to areas where there is already movement on the base layer. This helps to maintain the existing energy of the base layer motion, and helps to maintain contact points. For more information, see this talk from GDC 2016: https://youtu.be/eeWBlMJHR14?t=518
To use Adjustment Blending, add two or more keyframes on an additive layer. Make whatever changes you want to those keyframes, then run adjustment blending. You should notice that the script filled in the interpolation between your two keyframes, and in the right circumstances, should have fixed any unwanted velocity shifts in the layer change. Again, I highly recommend checking out the GDC talk for more info on the best use cases for this: It's extremely useful, but there are caveats to how it should be used to get the most out of it.
Unfortunately this version of Adjustment Blending doesn't include hyper-extension correction, so in some cases you may get hyper-extension if you try to stretch out the character's movement or posing. I would have added hyper-extension correction, but it's quite complex and time consuming to write and at time of writing I'm currently moving countries. Hopefully I'll have time to get back to it in future, if my employer allows me to continue to work on public scripts.
-
Center Selected Story Clips: Takes any selected clips in the Story Editor and centers them in the scene. Orientation is based on the start position and end position for the clip, so may be more suitible for some clips than others.
-
Copy Selected Story Clips to Tracks: Takes any selected clips in the Story Editor and copies them to individual tracks. Helpful when you want to extract coverage from one long mocap shot.
-
Copy Selected Story Clips to Takes: Takes any selected clips in the Story Editor, creates a new take for them, with the correct frame timings, and copies the clips to those takes (naming is based on the clip name, so there will likely be what seems like strange numbering at the end of the takes).
-
Copy Selected Story Clips to Takes - Centered: Basically does all 3 of the above scripts in order (copies to tracks, centers, then copies to takes). Again, very useful for quickly extracting mocap coverage into individual takes.