chryfi / lectorlips

A cool script that converts Adobe Character Animator mouth animation into Blockbuster mod Sequencer Morph NBT data.

A cool script that allows to convert Adobe Characte Animator mouth animation data into a sequencer morph for the Minecraft Blockbuster Mod.

Setup

First you need to install Python, for example, via Microsoft Store. You probably need to restart your computer after installing it. Test ouf if the command python works in the CMD. It should look something like this:

Now you need to tell the script how your mouth textures are named like and which Character Animator mouth they belong to. The image visemeMapping.jpg shows the mouth shapes used by Adobe Character Animator. The numbers indicate the order in which you have to define your image file names.

Type cmd into the file explorer in the LectorLips folder like this to open the CMD in that folder:

Now you need to enter the command to setup the names of your mouth textures.

python __init__.py -create_viseme_mapping 0.png 1.png 2.png 3.png 4.png 5.png 6.png 7.png 8.png 9.png 10.png 11.png 12.png 13.png 14.png

You can name those image files however you want.

Adobe Character Animator

First import your audio file. If you have the transcript of the audio, you can use it to increase the accuracy of the mouth animation. Therefore paste your transcript into the transcript text box in the properties context.

Now you need to generate the mouth animation. For this go to Timeline -> Compute Lip Sync Take from Audio and Transcript as seen in the image. If you didn't enter a transcript, choose the option without the transcript.

Convert Character Animator mouth animation into sequencer morph

To convert your mouth animation, you first need to convert it into After Effects Visemes. To do this, right click on your audio and click Copy Visemes for After Effects.

Now you need to paste the copied data into a .txt file. It's simplest if you just create the .txt file in the LectorLips folder.

Then you can execute the command to convert the pasted keyframes into a sequencer morph:

python __init__.py -create_sequencer full/path/to/AfterEffects_keyframes.txt "b.a:path/to/blockbuster/mouth/textures/"

With the argument full/path/to/AfterEffects_keyframes.txt you define the path to the file where you copied the keyframe data to. If you created the .txt file in the LectorLips folder, you can just enter the name of your file.

With "b.a:path/to/blockbuster/mouth/textures/" you define the texture path that should be used in the Blockbuster mod (this does not include the full system path, only the path inside the models folder). The texture files in that folder need to have the same names as the ones you defined in your setup. Your mouth textures need to be in a folder under ../config/blockbuster/models/. Example: Your textures are in the folder ../config/blockbuster/models/mouth_steve/ then your blockbuster path needs to be "b.a:mouth_steve".

The command will create a .txt file with the current date as name, where it writes the generated sequencer morph NBT data into.

You need to copy all of the NBT data and paste it into a user category of the morph menu like this:

That's it!

List of commands

-help

-create_sequencer
arguments: <path to After Effects keyframe.txt> <Blockbuster path to the mouth textures folder>
optional: <duration of the last mouth in ticks> <different viseme_mapping_filename>

-create_viseme_mapping
arguments: <15 image file names according to visemeMapping.jpg>
optional: <new viseme_mapping filename>