Kofysh / TiktokToOSCVRChat

🔴 How People Can Interact With My Avatar In Live ? 👥

Hey there, it's Hyroe ! :3

Welcome! I'll guide you through how your audience on TikTok Live can interact with your avatar on VRChat.

1. Link TikTok Chat and Send it to the OSC Server

Step 1 : Download PyCharm Community

➥ Download PyCharm Community from this link : Download

Step 2 : Set Up a New Python Project

➥ Create a new Python project and a Python file within the project folder.

Step 3 : Install Necessary Libraries

➥ Copy and paste the provided code and install the required libraries:

• Install the TiktokLive package :

  

• Import the python-osc package from GitHub :

  

Step 4 : Configure Your TikTok Name Tag

➥ Set your TikTok name tag (e.g., @hyroe) at line 51 in the code and run the Python program when you go live.

2. Link Parameters in Your .Json File

With the OSC server, you can send and receive data. For example, if someone types "boop" in the TikTok chat, the BoopToggle parameter will be set.

Step 1 : Understand OSC Parameters

➥ Read the official VRChat documentation on OSC parameters: OSC Avatar Parameters

Step 2 : Copy Your Avatar's Blueprint ID

➥ Copy the Blueprint ID from the Pipeline Manager component of your avatar in Unity.

Step 3 : Modify the .json File

➥ Navigate to C:\Users\YourName\AppData\LocalLow\VRChat\VRChat\OSC, search for your Blueprint ID, and open the corresponding .json file.

➥ Add the new parameter BoopToggle:

{
  "name": "BoopToggle",
  "input": {
    "address": "/avatar/parameters/BoopToggle",
    "type": "Boolean"
  },
  "output": {
    "address": "/avatar/parameters/BoopToggle",
    "type": "Boolean"
  }
}

Step 4 : Check Parameter Type

➥ Ensure the BoopToggle parameter in your Unity project is set as a Boolean. If not, change the type accordingly.

3. Test On VRChat :3

Step 1 : Enable OSC Server

➥ Enable the OSC server in VRChat.

Step 2 : Run Your Code

➥ Start your TikTok Live and run your Python program. You should see interactions reflected in your OSC Debug Panel.

Note : If it doesn't work for some people during your live, feel free to reach out for assistance!

Have a wonderful day/night !

➥ Follow me on my socials:

• TikTok
• X
• Instagram

Boop from Hyroe :3