Vfinity Tutorial

Welcome to Vfinity! This application allows you to connect Tikfinity events to VTube Studio, enabling interactive streams where your VTuber model reacts to gifts, likes, shares, and follows in real-time.

Prerequisites

Before using Vfinity, ensure you have the following:

1. VTube Studio installed and running.
2. Tiktok account (you or the target streamer).
3. Tikfinity (WebSocket Server).
   • Vfinity connects to a local WebSocket server that forwards Tikfinity events. Ensure this service is running (default port 21213).

Getting Started

Configuring Events

Vfinity allows you to define what happens when a specific Tikfinity event occurs.

1. Navigate to the Events tab.
2. Click Add New Mapping (or edit an existing one).

Event Types

• Gift : Triggered when a viewer sends a gift.
  • Specific Gift: You can specify a gift name (e.g., "Rose") to only trigger for that gift.
  • Min Amount: Only trigger if the gift combo count reaches this number.
• Like : Triggered when viewers like the stream.
  • Min Likes: Only trigger after a certain number of likes.
• Follow : Triggered when a viewer follows.
• Share : Triggered when a viewer shares the stream.

Actions

• Trigger Hotkey: Activates a VTube Studio hotkey.
• Move Model: Animating the model's position, rotation, or size.

Dashboard & Debugging

The Dashboard gives you a live overview of your connection status.

Testing/Simulation

You can test your mappings without being live!

1. On the Dashboard, find the Event Simulator.
2. Click buttons like Simulate Gift, Simulate Like, etc.
3. Observe your VTube Studio model to verify the actions are triggering correctly.

Troubleshooting

• VTube Studio Config: Ensure the API is enabled in VTube Studio and the port matches.
• Tikfinity: Ensure the WebSocket backend is running.
• Debug Mode: Enable "Debug Mode" in Settings for detailed logs.