First Setup

Overview

After installing VMSC, there are three things to do before your first stream:

1. Connect at least one streaming platform (TikTok, YouTube, Twitch, Kick, Streamlabs, or StreamElements)
2. Create a rule that listens for a stream event (like a gift or chat message)
3. Create an action that does something when the rule triggers (like a VRChat animation or PiShock vibrate)

This page walks through each step with a concrete example. VMSC supports six platforms — you can connect one or all of them and mix events across platforms in your rules.

Connecting Your Streaming Platforms

VMSC supports six streaming platforms. You can connect one or several depending on where you stream. Open the Settings page from the sidebar to configure each platform.

TikTok

Locate the TikTok section in Settings:

1. Enter your TikTok username in the Username field (without the @ symbol)
2. Select Standalone as the connection mode (this is the default)
3. Click Save

For detailed instructions, see Connecting TikTok.

YouTube

Connect your YouTube account via OAuth to receive live chat, Super Chat, membership, and subscriber events. See Connecting YouTube for the full walkthrough.

Twitch

Connect your Twitch account to receive chat, follows, subscriptions, bits, raids, channel point redemptions, polls, predictions, and hype trains. See Connecting Twitch for setup details.

Kick

Connect your Kick channel to receive chat messages, follows, subscriptions, and gifted subs. See Connecting Kick for setup details.

Streamlabs

Connect Streamlabs to receive donation, follow, subscription, host, bits, raid, and merch events via your Streamlabs socket token. See Connecting Streamlabs for setup details.

StreamElements

Connect StreamElements to receive tips, follows, subscriptions, cheers, raids, merch, redemptions, and more. See Connecting StreamElements for setup details.

Creating Your First Rule

Rules are the heart of VMSC. A rule says: "When this event happens, do these actions." Let's create a rule that triggers a VRChat animation when someone sends a Rose gift.

Step 1 — Navigate to Rules

Click Rules in the sidebar to open the Rules page.

Step 2 — Add a New Rule

Click the + New Rule button in the top-right corner. A new rule card appears with default settings.

Step 3 — Configure the Trigger

Set the following fields in the rule editor:

Step 4 — Add an Action

In the Actions section of the rule, click + Add Action and select VRChat OSC. Configure it like this:

{
  "type": "vrchat-osc",
  "parameter": "/avatar/parameters/Dance",
  "valueType": "bool",
  "value": true,
  "duration": 5000
}

This sends an OSC message to VRChat that sets the Dance parameter to true for 5 seconds, then resets it. Your avatar needs to have a Dance parameter mapped to an animation in the Animator.

Step 5 — Save the Rule

Click Save. The rule is now active and will trigger whenever someone sends a Rose gift during your LIVE stream.

Creating a PiShock Action

PiShock lets viewers trigger physical feedback through a wearable device. Here is how to set up a simple vibrate action.

Prerequisites

• A PiShock account and paired device
• Your PiShock Username, API Key, and Share Code

Configure PiShock in Settings

Go to Settings > Outputs > PiShock and enter your credentials:

{
  "username": "your-pishock-username",
  "apiKey": "your-api-key",
  "shareCode": "your-share-code"
}

Add the Action to a Rule

Edit any rule (or the Rose Dance rule from above) and add a second action:

Now when the Rose gift triggers, both the VRChat dance animation and the PiShock vibration fire simultaneously.

Testing with the Test Event Button

You do not need to be live on TikTok to test your rules. VMSC includes a Dev Test Panel that simulates stream events.

1. Open the Rules page
2. Click the Test Panel button (beaker icon) in the toolbar
3. Select an event type (e.g., gift) and fill in the fields
4. Click Send Test Event

VMSC processes the test event exactly like a real one — your rules evaluate, actions fire, and you can verify that VRChat animations play or PiShock devices activate.

// Example test event payload
{
  "type": "gift",
  "username": "TestViewer",
  "giftName": "Rose",
  "giftCount": 1,
  "diamondCount": 1
}

Free Tier Limits

Next Steps

• Connecting TikTok — Deep dive into connection modes and troubleshooting
• Connecting YouTube — OAuth setup and live chat integration
• Connecting Twitch — EventSub, chat, and channel point setup
• Connecting Kick — Channel connection and event configuration
• Connecting Streamlabs — Socket token setup and event types
• Connecting StreamElements — JWT token setup and event types
• Rules & Actions — Full reference for all event types, conditions, and action types
• VRChat OSC — Advanced OSC parameter configuration
• PiShock — Shocks, beeps, and intensity scaling