This is a submission for Make Visual Novel Assets! Jam

This Ren'Py script (.rpy file) offers an automated lip flap implementation for Live2D models that bears similarities to the original Blink_And_Lip_Flap Ren'py cookbook recipe.

- A character sprite performs animated lip flaps when dialogue text is being printed for them, through only adjusting the 'Mouth Open' parameter. Note that this is not anywhere close to realistic lip sync.

- After that it immediately switches to the default mouth position (defined from expression and/or motion).

The goal was to achieve this through easy-to-use minimal code, and without the need for the dev to overhaul their existing Live2D models (unless it's missing the required rigging) or Ren’Py code.

Confirmed to work with the following versions:

- Live2D Cubism SDK for Native: CubismSdkForNative-5-r.2

- Ren’Py: 8.3.4 (December 8 2024)

Licence:

Actual code asset:

The MIT licence only applies to the code asset, live2d_lipflap.rpy, which you can freely use.

You can modify the code in any way, but the copyright notice text at the top of this file should not be removed.

Credit to my name ("Gaming Variety Potato") is not required for your Ren'Py project, but appreciated. In that case you can list it under (code) asset attribution.

PDF Guide & game demos:

These elements of this project are purely added for educational purposes.

This content uses sample data owned and copyrighted by Live2D Inc. The sample data are utilized in accordance with terms and conditions set by Live2D Inc. This content itself is created at the author’s sole discretion.

I've renamed the Live2D model files and the model3.json contents to match the expected structure for Ren'Py.