VPZone

Getting Started

Mix It Up connects to your VPZone channel so chat, channel points, Pixels cheers, subscriptions, and channel settings can drive your stream automation. Log in from the Accounts page, the same as any other platform. Changes on that page take effect after a restart.

VPZone has a separate bot account, unlike Velora. The bot signs in as its own VPZone account and holds its own chat connection, so anything Mix It Up sends as the bot arrives under that account’s name.

VPZone messages are capped at 300 characters.

Viewers in the chat list are reconciled against who is actually connected to your channel, so people who leave drop off the list rather than sitting there until you restart.

Your title and category can be changed from the Channel page, alongside the other platforms you have connected. VPZone matches the category text against its own game catalog and keeps whatever you typed when nothing matches, so an unfamiliar category name is still sent rather than the whole update being refused.

NOTE: VPZone has no way to promote or demote a moderator from an app, and the platform has no VIP role at all. Moderator changes have to be made on the VPZone website, and Mix It Up tells you so rather than failing quietly.

Roles

VPZone adds three roles of its own that can be used for command permissions, on top of the usual Follower, Subscriber, Moderator, and Streamer:

VPZ+ Member: A viewer with an active VPZ+ membership
VPZone Founder: A founding member of the platform
VPZone Ambassador: A VPZone ambassador

These are read off each chat message as it arrives, so a viewer’s roles stay current without a lookup.

Chat

VPZone resolves emotes per message rather than publishing a dictionary of them, so each message carries the emotes its sender was entitled to use and those render inline in the chat window.

NOTE: Badge artwork for VPZone is not published yet, so chat messages show no badges even though the roles behind them are read correctly and still apply to command permissions and role checks.

Actions

VPZone actions allow you to perform actions on your VPZone channel, such as setting your title, announcing, pinning a message, and moderating your viewers. Your VPZone account must be connected on the Accounts page for this action to run.

This action supports the following options:

Set Title: Sets the title for the channel.
Set Game: Sets the game/category for the channel.
Set Tags: Sets the stream tags for the channel, entered as a comma-separated list.
Announce: Posts a highlighted announcement in your VPZone chat. Announcements are their own endpoint on VPZone rather than a chat command, and they always post as the channel owner, so there is no send-as-bot option and no accent color to pick.
Clear Chat: Clears every message from your VPZone chat for everyone connected, and drops the gateway’s replay buffer so a viewer joining a moment later does not see what was just cleared. Your local Mix It Up chat window is emptied as well.
Pin Message: Sends a message and pins it as the channel banner.
Unpin Message: Clears whatever is currently pinned, whether Mix It Up pinned it or you did.
Ban User: Bans the specified user from the channel. An optional reason can be provided.
Unban User: Unbans the specified user from the channel.
Timeout User: Times out the specified user for the specified number of seconds. If no amount is specified, a default of 300 seconds is used. An optional reason can be provided.
Untimeout User: Lifts an active timeout from the specified user. VPZone uses one endpoint for bans and timeouts, so this does the same thing as Unban User.

Banning or timing out a viewer also deletes the messages of theirs that are currently visible, matching how the other platforms behave.

For the user-based options, the target username field supports Special Identifiers (EX: $targetusername). If no username is specified, the user who triggered the command is used.

Events

VPZone Channel Stream Start

This event will run when your stream goes from offline to online. It is often used to send out Discord and social media notices to alert users that your stream is starting. This event is only triggered once per-application launch. This event provides no additional special identifiers.

VPZone Channel Stream Stop

This event will run when your stream goes from online to offline. It is often used to send out Discord and social media notices to alert users that your stream has ended. This event is only triggered once per-application launch. This event provides no additional special identifiers.

VPZone Channel Followed

This event will run the first time a user follows during this specific session of Mix It Up. This means that if a user follows, unfollows, and then re-follows quickly, it will only run the first time. This event is only triggered once per-user, per-application launch.

This event provides no additional special identifiers, however, it is often used with the User special identifiers.

VPZone Channel Raided

This event triggers when a channel raids your channel. It is often used to thank the user for the raid using chat and possibly overlay. This event is only triggered once per-user, per-application launch.

The User special identifiers indicate the user that raided. This event provides the following additional Special Identifiers:

$raidviewercount = The number of viewers of the channel that raided (EX: 123)
$hostviewercount = The number of viewers of the channel that raided (EX: 123)

VPZone Channel Subscribed

This event will run when a user subscribes to your channel. This event is only triggered once per-user, per-application launch.

In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:

$usersubmonths = The number of months the user has been subscribed for (EX: 1)
$usersubtier = The tier number of the subscription (EX: 1)
$usersubplan = The tier of the plan (EX: Tier 1)
$usersubplanname = The name of the plan. VPZone subs are numbered tiers with no streamer-set plan names, so this carries the same tier label (EX: Tier 1)
$message = An optional message that the user can supply when subscribing

VPZone Channel Resubscribed

This event will run when a user resubscribes to your channel. This event is only triggered once per-user, per-application launch.

In addition to regular User Special Identifiers, this event provides the following additional Special Identifiers:

$usersubmonths = The cumulative number of months that the user has been subscribed for (EX: 5)
$usersubstreak = The continuous number of months that the user has been subscribed for (EX: 5)
$usersubtier = The tier number of the subscription (EX: 1)
$usersubplan = The tier of the plan (EX: Tier 1)
$usersubplanname = The name of the plan, carrying the same tier label (EX: Tier 1)
$message = An optional message that the user can supply when resubscribing

VPZone Channel Subscription Gifted

This event will run for every user that is gifted a subscription by another user in your channel. The User Special Identifiers reference the user that GIFTED the subscription (Ex: $username), while the Target User Special Identifiers reference the user that RECEIVED the subscription (Ex: $targetusername). This event provides the following additional Special Identifiers:

$usersubtier = The tier number of the gifted subscription (EX: 1)
$usersubplan = The tier of the plan (EX: Tier 1)
$usersubplanname = The name of the plan, carrying the same tier label (EX: Tier 1)
$isanonymous = Whether the sub gifting was done anonymously (EX: true/false)

VPZone Channel Mass Subscription Gifted

This event will run once for each time a user in your channel gifts a set of subscriptions. This is when a user selects a number of subs to gift all at once to users in the channel. For example, if a user gifts 5 subscriptions to your channel, this event will be run once, while the VPZone Channel Subscription Gifted will be run 5 times, once for each user. The User Special Identifiers reference the user that GIFTED the subscriptions.

What determines whether this command or the VPZone Channel Subscription Gifted command will run is based on what is set for the Mass Gifted Subscriptions Filter Amount under Settings -> Commands. This option is designed to help reduce the spam of subscription gifted commands and provide a better experience for your stream. For example, if this option is enabled and the amount is set to 5, then any time 5 OR LESS subscriptions are gifted at once, it will ONLY run the regular Subscription Gifted event for each subscription. If MORE THAN 5 are gifted, then it will ONLY run the Mass Subscriptions Gifted event once.

This event provides the following additional Special Identifiers:

$subsgiftedamount = The number of subscriptions gifted for this specific instance (EX: 5)
$subsgiftedlifetimeamount = The lifetime amount of subs gifted by the gifter (EX: 100)
$usersubtier = The tier number of the gifted subscriptions (EX: 1)
$usersubplan = The tier of the plan (EX: Tier 1)
$usersubplanname = The name of the plan, carrying the same tier label (EX: Tier 1)
$isanonymous = Whether the sub gifting was done anonymously (EX: true/false)

VPZone Channel Points Redeemed

This event is run when a channel point reward is redeemed in your channel. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:

$rewardname = The name of the reward (EX: Hydrate)
$rewardcost = The cost of the reward (EX: 5)
$message = An optional message that the user can supply when the reward is redeemed
$messagenoemotes = The supplied message without emotes
$messageemotecount = The number of emotes in the supplied message

VPZone Channel Cheered

This event is run when a user cheers Pixels in your channel. The User Special Identifiers reference the user who triggered the event. This event provides the following additional Special Identifiers:

$cheeramount = The number of Pixels cheered (EX: 100)
$pixelsamount = The number of Pixels cheered (EX: 100)
$message = An optional message that the user can supply when cheering
$messagenoemotes = The supplied message without emotes

VPZone Channel Clip Created

This event is run when a clip is created from your channel. The User Special Identifiers reference the user who created the clip, where VPZone reports one. This event provides the following additional Special Identifiers:

$cliptitle = The title of the clip (EX: Test Clip)
$clipurl = The link to the clip (EX: https://vpzone.tv/clips/test)
$clipid = The ID of the clip

VPZone Channel Shoutout

This event is run when a shoutout is given in your channel. The User Special Identifiers reference the user who gave the shoutout. This event provides the following additional Special Identifier:

$shoutouttarget = The channel the shoutout was for (EX: TestChannel)

VPZone Channel Updated

This event appears in the Events list for parity with the other platforms, but VPZone does not currently report channel changes to Mix It Up, so nothing runs it. Use the VPZone action if you need something to happen when you change your own title or category.

VPZone Channel Points Commands

The VPZone Channel Points feature allows you to create commands that can be triggered automatically when specific VPZone Channel Point Rewards are redeemed in your VPZone channel.

When creating a command, you select one of the Channel Point Rewards that exist on your VPZone channel and the command will be run whenever that reward is redeemed. Channel Point Rewards themselves are created and managed on VPZone’s website. Mix It Up reads the list of rewards from your channel when you create or edit a command, so your VPZone account must be connected on the Accounts page for the rewards list to load.

A command is matched to its reward by ID first, and by name if the ID does not match anything. Renaming a reward on VPZone therefore keeps working, but recreating it from scratch means picking the new reward in the command.

VPZone Channel Point commands provide the following additional Special Identifiers:

$rewardname = The name of the reward (EX: Hydrate)
$rewardcost = The cost of the reward (EX: 5)
$message = An optional message that the user can supply when the reward is redeemed
$messagenoemotes = The supplied message without emotes
$messageemotecount = The number of emotes in the supplied message

NOTE: Channel points cannot be granted or deducted from Mix It Up. VPZone accepts only a channel-bound API key on that part of its API and rejects the login Mix It Up holds, so the option is left out of the VPZone action rather than offered as something that can never work.