README.md

StarRailMotionCapture

Motion capture for the character models of Honkai: Star Rail base on Unity and MediaPipe.

Currently face only.

Known limitations

• Face capture only supports character models with facial skeleton, e.g., the models ripped directly from StarRail.

Protocol

Protocols between the server and the client are written in protobuf and compiled using my customized version of protoc.

Server

Developed with Python 3.10.

It captures motion data using your webcam or from a video file and sends them to clients.

Setup

All the requirements are listed in Server/requirements.txt.

Enter the Server folder and create a virtual environment. Then, run the command below.

pip install -r requirements.txt

Edit config

Edit Server/src/config.py.

Start the server

Run Server/src/main.py.

Client

Developed with Unity 2022.3.

Requirements

• My Protobuf-Unity package.

Setup

1. Prepare a character model in the scene.

2. Prepare a blend shape asset to drive the character's facial expression.

   If you are using a datamined model, after setting its Scale Factor to 150 in the Import Settings, you can directly use the blend shape asset in the Client/BlendShapes folder.

   To create a custom blend shape asset, please read the 'Create custom blend shape asset' section.

3. Add a Motion Actor (Game Model) component to your character.

   

4. Add a UDP Session component to the scene and set the server's address and port. Then, drag your actors onto Actors field.

   

Run the client

Simply enter play mode in your Unity editor.

Create custom blend shape asset

1. Create asset using context menu.

   

2. Double click the asset to open the editor. Assign the face renderer of the character to Debug Skinned Mesh Renderer.

   

3. This editor supports Record/Preview mode like Unity's AnimationWindow, so you can use it as if you were using AnimationWindow.

4. Use the tools to increase efficiency.