Song Requests

From Vivbot
Jump to: navigation, search

The song requests module can be used to allow viewers to request songs that you can play on your stream. As of now, only youtube links can be requested.

Note: By default the first time the song request module is started, a 10 minute "Blank Video" will start. To actually begin the requested music you will need to either click the next button, or skip to the end of the video in the Music tab.

Music Tab

The music tab on the Vivbot Dashboard is what you use to access and play all the requested music.

Player

The box at the top is the actual YouTube player that will be playing your music. As such, this tab must be open in order to properly play the music. This player can be interacted with to Play, Pause, scan through music, full screen videos, and other typical YouTube commands.

Note: By default the first time the song request module is started, a 10 minute "Blank Video" will start. To actually begin the requested music you will need to either click the next button, or skip to the end of the video in the Music tab.

Controls

Below the player are buttons you can use to control your music. Directly below the player are Previous and Next buttons. You can use these to scan forward and backward through the playlist requested by your viewers. On the far left, above your Vivbot chatbox, are another set of controls. The Left arrow will act as a previous button to scan back through your playlist. The center button will allow you to play and pause the video currently playing. The right button will allow you to scroll forward through your playlist. To the right of the buttons is a scroll bar that will allow you to change the volume of the video playing. Below these buttons is the name of the video that is currently playing.

Playlist

Below the player is your playlist. This is initially blank and will look like it's missing, but will populate itself as people request songs. the playlist can be scrolled through freely using the previous and next buttons. Each song on the playlist has 4 columns

Position in playlist: The first column is the songs position in your playlist, this will be shown when a song is requested by a user.

Name of song: This is the name of the video that will play when the player reaches that song in the queue

Requester ID: This the the name of the person who requested the song in chat

Skip buttons: Using these buttons will allow you to skip a song when it comes up in the playlist. You can later choose to unskip them by clicking the button again. Note: you can still play these songs by scrolling to them using the Previous and Next buttons.

Song Settings

Here you can adjust settings related to how users can request songs.

Songrequest

Having this box checked will enable the song request module. If it is unchecked the song request module will be disabled entirely.

Base Cost

This sets the minimum currency that is required to request a song. Upon requesting a song, a user will have this amount deducted from their total currency.

Cost per minute

This is how much additional currency it will cost to request a song dependent on how long the song is in minutes.

Example: If cost per minute is set to 3 with a base cost of 5, and a user requests a 3 minute song, it will cost them 5+(3x3)=14 currency.

Max Duration

This is the maximum length a requested video can be in seconds. The scroll bar maxes out at 1200 seconds (20 minutes), but you can manually type in any number you want.

Required Chatpoins

This is the minimum number of Chat Points that a user requires to request a song. Useful to avoid people entering the room, making a bad song request and leaving the room.

Songs between

This is the number of songs that are required to be requested by other users before the original user can request again. This is useful to avoid a single person dominating the playlist. Setting this to 0 will allow unlimited requests.

Example: If Songs between is set to 2, and User A requests a song, User B and User C must request a song before User A can request another.

Flat cost

This is the flat cost of currency that is required to used the "!skip pay" command. Using the !skip pay command will deduct this much currency from a user's account.

Note: This will be added to any existing percent cost

Percent cost

This is the percentage cost of currency that is required to used the "!skip pay" command. It will deduct based on a percentage of a users total currency. This helps by continuing to have an influence even on the richest users, so they can't abuse the !skip pay command.

Note: The percentage calculation will be done after deducting the flat cost from a user's account.

Vote percent

This determines how many active users must use the !skip command before a song is skipped.

Active minutes

This determines how long, in minutes, after a user chat, that they will be considered active. The active user count will be used to determine how many votes are required before a song is skipped.