Help! Something is Broken

Sometimes things do not work the way they should. Do not worry! Most problems have simple fixes. Let us go through the most common issues.

VTube Studio will not connect

Problem: You click Connect but VTube Studio does not connect.

Try these fixes:

1. Make sure VTube Studio is open and running
2. Make sure the API is turned on in VTube Studio settings
3. Try clicking Connect again
4. Restart VTube Studio
5. Restart Vfinity
6. Try again after both are restarted

TikTok LIVE will not connect

Problem: You put in your username but it will not connect.

Try these fixes:

1. Make sure your TikTok LIVE is actually running on your phone
2. Check that you typed your username correctly (no @ symbol)
3. Make sure your account is public, not private
4. Try disconnecting and connecting again
5. Restart Vfinity and try again

Events are not working

Problem: You set up events but nothing happens when viewers send gifts or follow.

Try these fixes:

1. Make sure both VTube Studio and TikTok LIVE are connected (green lights)
2. Check that your events are set up correctly in the Events tab
3. Make sure the trigger matches what you want (gift, follow, like, etc.)
4. Check that the action is set up right (hotkey, move, VFX, throw)
5. Try creating a simple test event to see if it works

Windows SmartScreen warning

Problem: When you open Vfinity on Windows, you see a warning that says the app is not recognized.

This is normal! Vfinity is safe, it just does not have a special certificate yet.

How to fix:

1. When the warning appears, click "More info"
2. Then click "Run anyway"
3. Vfinity will open normally

You only need to do this once. After the first time, Windows will remember.

Mac Gatekeeper warning

Problem: When you try to open Vfinity on Mac, it says the app cannot be opened.

How to fix:

1. Do not double click to open Vfinity the first time
2. Instead, right click on the Vfinity app
3. Choose "Open" from the menu
4. A popup will appear. Click "Open" again
5. Vfinity will open normally

After the first time, you can open it normally by double clicking.

The app will not open at all

Problem: You double click Vfinity but nothing happens.

Try these fixes:

1. Make sure your computer meets the requirements
2. Try running Vfinity as administrator (Windows)
3. Restart your computer
4. Try reinstalling Vfinity
5. Download the latest version from itch.io

OBS overlay is not showing

Problem: You added the overlay to OBS but you do not see anything.

Try these fixes:

1. Make sure you copied the correct overlay URL from Vfinity
2. Check that the Browser Source is set up correctly in OBS
3. Make sure the overlay layer is above your other layers in OBS
4. Try refreshing the Browser Source
5. Make sure Vfinity is running and connected

Gifts are not throwing

Problem: You set up physics throwing but gifts do not fly at your avatar.

Try these fixes:

1. Make sure you set up hitboxes on your avatar
2. Check that the event is set to "Physics Throw" action
3. Make sure VTube Studio is connected
4. Test with a simple throw to see if it works
5. Check the hitbox positions match your avatar

Debug mode

If you are still having problems, you can turn on debug mode to see detailed logs.

1. Go to Settings in Vfinity
2. Look for "Debug Mode" and turn it on
3. Press F12 to open the console
4. Look at the logs to see what is happening

The logs can help you figure out what is going wrong.

Still stuck?

If none of these fixes work, you might need to ask for help. Check the FAQ page for information on where to get support.