LectorLipsPlus

Converts Character Animator mouth data files to Minecraft Blockbuster Mod NBT data files with several benefits

Changes compared to the original LectorLips

• option to convert entire folders at once
  
• template project for Adobe Character Animator and therefore no necessaty to subscribe to Adobe CC
  
• premade assets
• step-by-step guide for easy use
  
• config file for one repetitive argument
• clean folder structure
  

Requirements

...that are necessary:

• Adobe Character Animator (instant download)
• Python

...that have working alternatives:

• Adobe Audition
• 7-Zip

Setup

1. Download the source code by clicking on <> Code & Download ZIP and extract its content.
   
2. Copy the (renamable) mouth folder from /assets/ somewhere into the blockbuster models folder with the basic path being %appdata%\.minecraft\config\blockbuster\models.
3. Open settings.ini inside /run/ and write down the custom path from step 2 after b.a:.

Guide

1. Open Audition with the audio file you want animations from (in this case one long raw recording that has multiple lines it it).
2. Remove unnecessary white space and bloopers.
3. Select every area to create animations from and press M to create markers.
4. Head to File > Export > Audio within markers (or similar).
5. Change export settings as needed, one of which being the path and click on export.
6. Open Adobe Character Animator, click on Open project... and choose the (copyable) template.chproj inside /assets/adobe/template/.
7. Inside the project: Click on each file inside the folder illustrator, go to properties, click on the orange file path, navigate to /assets/adobe/illustrator/ and select the file with the same name as the one clicked on before.
8. Import the newly exported audio files.
9. (required if you prefer detailed mouth animations as seen in step 14) Click on each audio file and head to properties into the blank white box where you need to transcribe the spoken words into text using the play button above the blue file path as orientation.
10. Open the scenes fitting to the required emotion by double clicking them inside the project panel folder scenes and import the proper audio files into the timeline next to each other.
11. Select one timeline object each and you may click on Timeline > Compute Lip Sync Take from Audio and Transcript in the navigator above for detailed mouth animation. If you dislike the details and prefer a more basic comic style look or the generation fails as seen on their timeline markers you need to use Timeline > Compute Lip Sync Take from Scene Audio.
12. (optional tweaking) Adjust the recognized letters with purple background as needed by changing their length and letters using right click.
13. Right click each light purple lip sync layer and click on Copy Visemes for After Effects.
14. Create in a directory of your choice text files for each viseme copy according to its emotion, optimally with a recognizable name, paste the clipboard into each one and save the files.
15. Run convert-folder.bat or convert-single.bat inside /run/, enter the folder or file path of the text files created before and press enter.
16. Write down an emotion for the needed facial expression that matches with the name of the proper sub folder from step 2 (by default either positive, neutral or negative).
17. Navigate to /export/, move the files inside to a desired location if needed and open each file you need mouth animation from.
18. Copy the entire content and head to Minecraft.
19. Pick a morph (mostly inside the aperture timeline where someone needs to speak), click on Edit and select Body part (the limb on the bottom right).
20. Click on Add a new body part... (the plus sign on the bottom left), choose Head on the right and click on Pick.
21. Right click into an empty area and press Paste NBT.
22. Choose the newly created animated mouth inside Recent Morphs.

Credits to Chryfi

This project is a fork from Chryfi's LectorLips. Feel free to leave some love. His work is awesome. ❤️