Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- Thanks for checking out the song request bot I made! Read this file very carefully because it has all the information
- you'll need to use the request bot. If you have any issues with it or requests for new features, feel free to message
- me on twitch or twitter! Also, I will be editting this pastebin and the others as I release newer versions.
- SETUP:
- 1. SETTING UP THE BOT WITH MIRC
- Here is a video on how to download and set up mirc with twitch your bot:
- -----> https://www.youtube.com/watch?v=8f1hum8i2uw <-----
- Keep in mind, you do need to have a license to use mIRC. Its a one time payment of $20 on their site, but you can use
- a 30 day free trial to see if using mIRC is something you would like. Also, you can check out that video series if you
- feel motivated to code your own features on top of the song request code I've provided.
- NOTE: You do run the risk of messing up the bot if you start developing your own code.
- 2. FINDING THE SCRIPTS EDITOR
- After you have successfully created a new twitch account for your bot and connected it to your channel via mIRC, we
- can add the code. First, you need to locate the "Scripts Editor" button on mIRC. It is located in the top tool bar
- 5th from the left and looks like this:
- -----> http://thebadgersett.us/images/guide/mirc19.png <-----
- Once you've located the Scripts Editor, click it. Another screen will pop up with 5 tabs "Aliases, Popups, Remote,
- Users, and Variables" We will only need to worry edit 3 of the tabs Remote, Users, and Variables.
- 3. THE REMOTE TAB
- First, we will edit the remote tab. This is where the majority of the code will go when programming in mIRC. The other
- tabs are there to make things easier for coding in remote. I have uploaded all of the "remote" code to a pastebin file
- here:
- -----> http://pastebin.com/sAzR74h2 <-----
- Copy and paste that entire file to the remote tab.
- 4. THE USERS TAB
- The Users tab is very simple all you need to add here is:
- -----> 3:[your twitch name] <-----
- EXAMPLE: In my code I have:
- 3:doopian
- 5. THE VARIABLES TAB
- The Variables tab will be used to customize your bot. For example, if you want viewers to only be able to
- request 1 song, or if you change your mind and want to allow 2 requests per user, you can change the values of the
- variables here. The variables tab is in a pastebin file found here:
- -----> http://pastebin.com/J301HXYh <-----
- Copy and paste that entire file to the variables tab.
- INSTRUCTIONS:
- 1. LEARNING THE VARIABLES
- After you have copy and pasted the variables tab you will see 5 variables on the top "%SongLengthLimit, %TotalSongLimit,
- %SongRequestLimit, %UserRequestLimit, and %SongsLink" .. You can edit the values of these however you like, but
- first let me explain what each does:
- %SongLengthLimit: This variable is the limit to how long a song title can be to be requested. This prevents spam
- basically. So any song someone requests has to be less than 55 characters by default. You can
- edit that value if you want shorter or longer song titles allowed in your list. I have this value
- set to 55 because that is a little over the length of "It must really suck to be Four Years Strong
- Right now" in GH:Live.
- %TotalSongLimit: This variable is used to set a maximum size of your list. By default it is set to 10 songs before
- the list is full and viewers need to wait until a song is removed to request another.
- %SongRequestLimit: This variable is how many duplicate requests you want to allow in your request list. This prevents
- your song list from being mostly one song. For example, if you want to allow the same song on your
- list 2 times, but not 3 set the value to 2. By default, it is set to 1 so there are no duplicate songs
- allowed. NOTE: Any misspellings or a change of spacing will add duplicates to the list over your limit.
- I will cover how to fix this later in the file.
- %UserRequestLimit: This variable is how many songs each user can request. By default I have it set to 1 so each user can
- request no more than 1 song until their song has been played or removed from the list. Smaller channels
- may want to change this to a higher number.
- %SongsLink: This variable will link to a page where users can view the songs you have. By default there is no value. You don't
- need to have a link there for the bot to work. If you do decide to add a link to your requests just add a space
- and then copy and paste the link to a pastebin or something. For example my %SongsLink is set up like this:
- %SongsLink http://pastebin.com/SHzEzip2
- NOTE: If you plan to strictly request ghtv on stream, toymachinesh has a site that he keeps updated with all
- of the ghtv songs available here:
- -----> http://theherofeed.com/guitar-hero-tv-song-list/ <-----
- NOTE: DO NOT edit the 5 other variables "%listtimer, %currenttimer, %nexttimer, %songstimer, and %totalsongs"
- 2. LEARNING THE COMMANDS
- Now that you've set and undertand your variables, we can start learning and using the commands! There are 9 commands in
- total. 2 of those commands only you can use, 2 only moderators and you can use, and the rest anyone can use.
- YOUR COMMANDS:
- !resetsongs: When you want to begin taking song requests, use this command to clear the entire request list.
- !pop: This will remove the first song on the list and then output the next song to be played. If there are no songs
- left to be played, the bot will let you know.
- YOU/MOD COMMANDS:
- !remove: There will be songs or phrases requested that you don't want on your list. This command lets you and your mods
- remove a song. In order to use the command correctly you need to add either a number or a song title to the
- command in order for the bot to know which song you want to remove.
- EXAMPLE: If the list is ttfaf, slow ride, mauvis garcon, and my curse. We can remove slow ride by typing:
- !remove slow ride OR !remove 2
- NOTE: Since slow ride is the 2nd song on the list "!remove 2" will delete it. Also, if you type out the
- song title to remove the song, you will need to spell it correctly with proper spacing.
- !change: If a viewer accidentally requests a song you don't have or wants to change requests for whatever reason,
- this command will do the trick. In order to properly format the command you need to add a number AND THEN
- a song title. The number is the song you want to change on the list and the song title is the NEW song title.
- EXAMPLE: If the list is ttfaf, slow ride, mauvis garcon, and my curse. We can change slow ride to cliffs of
- dover by typing:
- !change 2 cliffs of dover
- NOTE: This is the only way to change a song. You have to format the command in this order NUMBER FIRST then
- the new song title.
- PLEB COMMANDS:
- !request: This is how anyone can request a song for you to play on your channel. In order to request a song you just
- need to add a song title after the command.
- EXAMPLE: If I want to request slow ride I would type:
- !request slow ride
- NOTE: Every song request gets added to the end of the list, so you will be playing songs in the order they
- are requested in. AKA First In First Out.
- !songs: This will display the link to your song requests if you have a link. If not, the bot will say you don't have a
- link to your songs.
- !currentsong: Displays the current song being played if there is one. AKA the first song on the list.
- !nextsong: Displays the next song being played if there is one. AKA the second song on the list.
- !list: Displays the entire request list if there are songs to display.
- NOTE: You may want to make a panel on your twitch page for these commands so users have a place to see how to use your
- bot. This will help you not get spammed with questions on how to use the bot.
- POSSIBLE UPDATES:
- At this point your bot is set up and you understand everything there is to know about it (I hope). I will be updating
- the bot when I can. I will also add some new commands, debug any issues, and maybe scrap some ideas. Currently what I
- want to add are:
- 1) A ban command for song requests: To remove a user that ALWAYS requests something you need to remove.
- 2) A random song picker: To pick songs randomly from your request list rather than First In First Out.
- Again, if you have any ideas/questions regarding the bot just message me on twitter or twitch. Thanks again for checking
- this out and hopefully it works out well for your channel!
Advertisement
Add Comment
Please, Sign In to add comment