WELCOME!
Vtuber Kit
Created by Kyuppin
This User Guide is up to date as of version 0.1.97
THIS GUIDE IS STILL A WORK IN PROGRESS. MUCH OF IT IS STILL INCOMPLETE. PLEASE USE THE ITCHIO FORUMS IN THE MEANTIME.
"Download vTuber Kit for free using the Itchio link below! Then scroll down to start learning how to use the app!"
Download
Topics
Quick Start
Welcome to vTuber Kit!
Tracking
Capturing
Controls
Hair
Introduction
Options
Parts
Face
Introduction
Options
Parts
Clothing
Introduction
Options
Parts
Accessories
Introduction
Options
Parts
Custom Items
Introduction
Custom Items
Options
Live Settings
Introduction
Save/Load Position
Save/Load Design
Interactivity Shortcuts
Twitch Settings
Introduction
Connection
Redeems Overview
Headpats
Throw Items
Falling Items
Wildcard
Nose Boops
Model Settings
Introduction
vTuber Variables
Mouth Variables
Eyes Variables
Doodle Effect
App Settings
Introduction
Game Capture
Devices & More
UI Settings
Window Settings
Miscellaneous Settings
Spout Capture
Virtual Camera
Data Stuff
Miscellaneous
Introduction
Color Picker
Texture Options
Capture Methods
Legacy Objects
Credits
Contributors
Plugins
More
QUICK START
Behold!
This is what you will be feasting your eyes upon when you open the program for the first time.
Tracking
vTuber Kit defaults to webcam tracking. It should automatically grab your default webcam and microphone and start tracking your face. Give it a test by moving your face around and opening your mouth or talking.
If the model has its eyes closed or is unresponsive, go to the Gear tab in the top left and under the "Devices & More" section, make sure your desired webcam and microphone are selected.
vTuber Kit also offers mouse tracking! Almost directly below the the camera and microphone options is an option to turn on mouse tracking.
Capturing
Now that vTuber Kit is tracking, we can set up capturing the program in OBS.
By far, the easiest and quickest method of capturing vTuber Kit is to use a Game Capture Source. In OBS, find your sources window and add a new game Capture source. Name it "vTuber Kit" and click OK. A new window will pop up. Change Mode to "capture specific window", select the vTuber Kit window, and check the "allow transparency" box. And that's it! vTuber kit should be in your OBS scene now, with the background automatically removed.
I recommend sizing the vTuber Kit source to be the same size as the scene. So if you have a 1920x1080 scene, use the same size for vTuber Kit, or an equal ratio. Then resize vTuber kit so it fits the entire scene. You can also right-click the vTuber Kit source and go to Transform > Fit to screen. Finally, while you have vtuber Kit window active, you can press Esc to hide the side panels. That's it! You're all set to stream.
Keep in mind that this was the quick and easy way. You can find better methods in the Capture Methods section.
Controls
Here are some simple and important controls for controlling your model.
Esc
Hides the UI panels.
Right Click & Drag
Move the model around the screen.
Mouse Wheel / Up & Down Arrow Keys
Zoom in/out on the model.
Mouse Wheel Click / Spacebar
Resets to the model's base/saved position and zoom.
"That's it for the basics! Now it's time to customize your model!"
HAIR
Introduction
Most tabs in vTuber kit will have overall options at the top, and then more tabs underneath with sub-categories of options. First, we'll be looking at the hair tab and all hair-related things. Let's jump into it!
Options
Base
This is the base color of the hair. Click this, or any other color box and a color picker will appear, allowing you to change the base color of the hair.
Shading
Use this to color the hair's shading. Each hair part has a built-in shading layer.
Shading Transparency
This slider controls the transparency of the hair's shading color. Set this to 0 for no hair shading and 1 for completely opaque.
Bangs Visibility
These checkboxes control whether individual bangs are shown or hidden. Bangs that have 3 pieces will only utilize the 3 middle checkboxes.
Gradient
Click the gradient button and the panel will expand to show options for back hair, side tails, bangs, and tied hair. The height sliders define the how quickly the gradient changes from one color to the next, with lower numbers being more sudden transitions. The position sliders define how high the transition begins, with lower numbers starting at the bottom of the hair.
I recommend playing around with these values to get a feel for it, as some are more finnicky than you'd expect. But generally, you want to adjust the height slider until you can see the gradient. Next, adjust the position slider to line up the gradient color to where you want it. Then finally, adjust the height slider again for precise control on how far the transition goes.
Parts
vTuber Kit has 5 different options for hair. Each can be changed individually so you can mix and match for more customization.
Back Hair
The hair at the back, displayed behind the head.
Bangs
The hair that appears in front of the face. These can be turned on/off individually as explained in the Bangs Visibility section.
Side Hair
The hair that rests at the left and right side of the face, behind the bangs.
Tails
Hair that tied up or sticks out from the sides of the Back Hair.
Hair tails turn on with bows by default. To learn how to change/remove those, check the Legacy Objects section.
Ahoge
This is the little tuft of hair that sticks up from the top of the model's Back Hair.
"You can even turn all of the hair off to become bald, like me!"
FACE
Introduction
Options
Skin
Your model's skin color.
Outline
The outline color of the model. This affects all outlines for all parts, not just the body.
Mouth
The color of the inside of the mouth.
Iris
The color of the iris, the colored part of the eye around the pupil.
Pupil
The color of the pupil, the center of the eye.
Sclera
The color of the eye around the iris.
Eye Sliders
Below the color options, you will find a bunsh of sliders that let you control the look and feel of your model's eyes. You can scale pupils on X/Y axes, you can scale the overall eyes on X/Y axes, and finally, you can control the X/Y position of the eyes so they can be right where you want them.
Heterochromia
Clicking this button will toggle on/off the 2nd set of the eye color options so you can set each eye's iris, pupil, and sclera colors individually.
Brow Options
Clicking this button will replace the Eye Sliders with Brow Sliders. Using these sliders, you can set the rotation of the eyebrows, as well as their X/Y scale and position.
"Try using the pupil X scaling to give your characters skinny eyes. Useful for appearing like a cat! Also, keep in mind that all of these settings save per save slot, so you can make your eyes and brows angry in one slot, happy in a second, sad in a third, etc!"
Parts
Eyes
Eyes come in various shapes, from the original cartoony round style to a couple more anime styled options.
Mouth
vTuber Kit's mouths each have 5 sprites they cycle through depending on how you have your Mouth Variables configured. Each mouth is unique and offers a different feel.
Ears
There are multiple types of ears to choose from, from big round ones, to pointy uppy and downy ones!
Eyebrows
There are no eyebrow parts quite yet, but you can easily use custom objects to attach your own eyebrow designs!
CLOTHING
Introduction
vTuber Kit comes with a (admittedly lacking...) selection of clothing to keep your model safe and family friendly! No nakedness around here. In fact, vTuber Kit even comes with censor bars, in case you are naked! Uh... Anyways! On to the options!
Options
Primary Color
The primary color of the clothing. Each piece of clothing has a primary color.
Secondary Color
A secondary color. Not every piece of clothing will have a secondary color, so you'll have to experiment to see if editing this does anything.
Texture Options
Texture Options gives you the option to add textures to clothing. You can also unfreeze the textures so they move with the clothing for a realistic effect. For more info on this, you can check the Texture Options section.
Parts
Outfits
The first tab in the clothing section is for outfits. Outfits come with a top and a bottom and replace any other clothing currently active. vTuber Kit can either have an outfit active or a top & bottom combo active. Outfits cannot be combined with tops/bottoms.
Tops
The second tab is for tops. Here you'll find various clothing that covers the torso.
Bottoms
The third tab is for bottoms. Here you'll find various clothing that covers the legs.
Socks
The fourth and final tab is for socks. Socks come in many varieties and follow the movement of the legs.
"You can attach custom images to shirts to make custom graphic T's, or even attach a blank custom image to a single sock and toggle the parent object to not display so that it looks like you only have one sock on."
ACCESSORIES
Introduction
Options
Primary Color
Secondary Color
X Pos
Y Pos
Squish
Display Tail behind Hair
Freeze Tail
Freeze Tail
Texture Options
Parts
CUSTOM ITEMS
Introduction
Custom Items
Creation
To create a new custom item, click the plus button. This will spawn in a new custom item with the default onionbug sprite. It will spawn attached to the base of the model at the center of the body.
Controls
When you spawn a new custom item, click on an existing custom item directly, or click the custom item in the panel, some on-screen controls will be displayed.
You are able to click and drag on the square in the middle of the controls to scale the item. You can also click on the circle and drag 360 degrees to rotate the object.
Management
Delete
On/Off
Options
Z-Axis
Rotation
Scale
Flip
Move
Attach
Clone
Hide Pinned Sprite
Jiggly Sprite
Freeze Model
LIVE SETTINGS
Introduction
Save/Load Position
Parts
TWITCH SETTINGS
Introduction
vTuber Kit comes pre-loaded with some fun animations and effects that can be set to trigger when certain things happen on Twitch. First, we'll cover how to connect vTuber Kit to Twitch.
Connection
In order to connect to Twitch, you have to enter information about your account so we can connect to the API and receive information from your channel. Follow along below to get connected.
Twitch Username
This is your Twitch username, nothing tough about this one.
Twitch Channel ID
Click the "Find My Channel ID" button here to open a webpage where you can easily find your Channel ID. At the loaded webpage, enter your Twitch username in the box and press the "Check" button. Your Channel ID will be displayed under the prompt.Copy and paste that into vTuber Kit.
Twitch O-Auth Code
DO NOT SHARE THIS CODE. DO NOT GENERATE THIS CODE ON STREAM. KEEP THIS SECRET.
An O-Auth code is what allows applications to read the data from your Twitch stream. Generating this will allow vTuber Kit to read information regarding your channel.
Click the "Generate OAuth Key" button here to open a webpage where Twitch will ask for your permission to give vTuber Kit access to read certain information about your channel. Take note that vTuber Kit only asks for permissions to read chat, get channel point redeem info, and get bit donation info.
Authorize vTuber Kit and you will be brought to a webpage with a generated key. Copy that key in its entirety and paste it into vTuber Kit. This key will always be censored in vTuber Kit so it can't be easily seen.
"If you ever want to revoke access, you can do so at any time by going to your Twitch account settings, then going to Connections, and finding and revoking access to vTuber Kit."
Connecting
Once you have those three boxes filled, click the "Restart" button at the bottom of the panel. vTuber Kit will restart and attempt to connect to Twitch. If the connection was successful, your redeems will be working! So, let's move on to setting those up so you can test them out!
Redeems Overview
There are five functions (redeems) in vTuber Kit which can be triggered by various Twitch interactions. This section will give general information that applies to all of their options, and then specific information about each redeem can be found below. Keep in mind that you need to be a Twitch Affiliate or Partner for things like subs, channel points, or bits redeems to work.
Each redeem has its own corresponding tab, and a lot of the options are similar since they are all set up the same way. let's go over the similar options now.
Channel Points Name
This is the name of the channel point redeem you've set up for your channel. Any time someone from your channel redeems a channel point with this name, this redeem will trigger. This is case sensitive and must be exactly the same as it's displayed on Twitch otherwise it won't trigger.
Chat Command Name
Chat commands are triggered by viewers just by typing an exclamation point followed by the chosen command. For example, "!headpat". Don't include the exclamation point in the name, it is implied. The good thing about chat commands is anyone can use them, you don't need to be an Affiliate or Partner.
Chat Command Cooldown
Since viewers can spam chat with commands, the chat commands come with a built-in cooldown which you can set however you want. When a command is put in chat, the cooldown will start. If a command is entered in chat while the cooldown is still running, it will be ignored.
Subs
If not set to zero, getting a subscriber will trigger a redeem X number of times. So, if you have the headpat sub redeem set to 5, when you get a sub, you will automatically get headpatted 5 times. Note that this will trigger for regular subs, gifted subs, re-subscribers, prime subs, etc. Any kind of sub basically. If you have multiple redeems set up to trigger with subs, they will all trigger simultaneously, which could lead to quite the spectacle, encouraging more subs.
Bits
If not set to zero, getting a bits donation can trigger a redeem. Bits work a bit different than subs, since they're much cheaper to use. You have more granular control over them. You can set the minimum number of bits to trigger a set amount of redeem. So for example, if you have the headpat redeem set as "for every 5 bits, redeem 2 headpats", and then you're cheered 50 bits, you will get headpatted 20 times. Wow, math! If you have multiple redeems set up to trigger with bits, they will all trigger simultaneously, which could lead to quite the spectacle, encouraging more cheers.
Volume
Most of the redeems have some sort of sound associated with them. The volume slider gives you individual control of those sounds.
Headpats
Throw Items
Falling Items
Wildcard
Nose Boops
MODEL SETTINGS
Introduction
Options
Primary Color
Secondary Color
Texture Options
X Pos
Y Pos
Squish
Freeze Tail
Parts
APP SETTINGS
Introduction
Options
Primary Color
Secondary Color
Texture Options
X Pos
Y Pos
Squish
Freeze Tail
Parts
ACCESSORIES
Introduction
Options
Primary Color
Secondary Color
Texture Options
X Pos
Y Pos
Squish
Freeze Tail
Parts
MISCELLANEOUS
Introduction
This section explains various aspects of vTuber kit. Whether they can be considered supplementary, or just more of a glossary of things that didn't fit anywhere else. I really just wanted a place to link to them throughout the User guide. There's some helpful stuff in here!
Color Picker
The color picker will pop up whenever you click on a color box.
Click and drag inside the rainbow colored part to select a color. Use the shade slider to the right of it to control how light/dark the colors will be.
You can also input a color hex directly at the bottom. press enter to confirm the color.
Finally, you can use the color dropper button in the bottom right to pick a color within vTuber kit. This feature does not work to capture colors on your desktop. Click the color dropper button and then left click over the color you want. The color dropper will show a zoomed-in view so you can be sure about the color you're selecting.
To close the colow picker, click the X at the top, press the Esc button, or click anywhere else in the window.
Texture Options
What Is It?
Texture Options let you use a repeating texture that stays stationary and fills certain areas of the vTuber Kit model. For example: Chowder, Gankutsuou, and Sayonara Zetsubou Sensei make use of this technique. If it helps, think of it as just a textured color you're adding to the model.
How To Use
Click the Texture Options button in Vtuber Kit to open the image panel. Click the plus button and choose the image you'd like to use. Make sure that image is selected and it should appear on the model.
Click the same texture to turn the texture off. You can have multiple textures loaded into vTuber Kit. Use the mouse wheel to scroll through them all. At this time, you cannot remove textures. Removing the textures in the save data will result in unexpected errors so please exercise caution when editing any files in the save data folder.
Capture Methods
Spout Capture
Game Capture
Virtual Camera Capture
Legacy Objects
What Are They?
Legacy Objects are some of the oldest accessories of vTuber Kit, from the good ol days before custom objects and all this newfangled technology-- Er, anyways, they're basically leftovers! They're images that can be swapped by changing PNGs in the vTuber kit reference files instead of doing everything directly in the program. They should really be removed, but some people still use them so I decided to leave them in. There are a few of them, explained more in detail below.
Where to Find Them
Legacy Objects can be found by going to the Settings (Gear) Tab in the top-left of vTuber Kit, and then scrolling down to and pressing the "open save data" button. In the window that opens, you'll find a folder named "Legacy Objects". Double click that to find the three Legacy Objects.
How To Edit Them
Editing the Legacy Objects is easy as they're just regular PNG images that vTuber Kit loads at runtime. You're most likely reading this section to change the hair bows, so let's use that as an example. If you want to get rid of those bows, open that PNG in an image editing program, erase the entire canvas, and then save it as a blank image.
DO NOT DELETE THE IMAGE FILE. Deleting the file entirely will probably cause issues for vTuber Kit, so be careful.
The other two images in there can also be changed, but it's probably much easier to use custom objects in the program to do their job for them. For example, you can attach a custom object to the choker charm or directly to the t-shirt and the same effect will be achieved.
"You can also change the size of the PNG canvases to make these legacy objects extra big or small."