TootTally TwitchIntegration Module

Version: 1.2.1

TwitchIntegration Module for the TootTally mod.

First head to the TootTally setting Twitch page and follow the instructions. Press F8 to toggle the request panel in game.

NOTICE: Some people asked to display the song name when requesting but this is very dangerous. If someone maliciously upload a chart with unwanted words in it, using the names in chat could result in a permanent twitch ban. For this reason only the songIDs and leaderboard links will be displayed.

COMMAND LIST: !ttr [id] !ttrhelp !profile !song !queue !last !history

INSTRUCTIONS:

1. Instructions for first time usage/setup:
2. Install the mod and open the game normally
3. Open TootTally Settings (the button to the left of the Play/Collect buttons)
4. Click Twitch
5. Under Twitch Integration, place your Twitch username on the first line and press Enter.
6. Click Authorize TootTally on Twitch. This will open your browser to https://toottally.com/twitch/
7. Follow the steps on the website, and authorize TootTally on Twitch.
8. Copy the Access Token given to you, and place it under your Twitch username on TootTally Twitch settings. (Alternatively, hop back onto Trombone Champ and press Refresh Access Token)
9. Click Connect/Disconnect Bot to start integration (or alternatively, hop straight into the song select screen). Your game may freeze for a bit when starting up the bot.
10. And you're done! Test the bot by typing any of the three commands above!

Instructions for usage after:

1. Open the game
2. Open TootTally Twitch Settings (Steps 2 to 3 above)
3. Click Refresh Access Token
4. Proceed to play the game as normal. (Or start up the bot then and there)

NOTE: To access the Requests panel, press F8 in the song list screen. If you have the chart requested, pressing play will close the panel and lead you directly to the chart. If you do not have the chart requested, it will open the TootTally page for the chart.

Still in active development.

Customer Service

For more help, join the Trombone Champ Modding Discord or the TootTally Discord

TootTally Installation Instructions

1. Install the mod through Thunderstore/r2modman
2. Go to TootTally and sign up for an account.
3. After signup, you will be given an API Key. Copy-paste this API Key to TootTally's config.
4. Open the game, and enjoy! You will now be able to submit scores, and view other people's scores!

Charts being tracked can be searched in https://toottally.com/search/ or accessed programmatically in https://toottally.com/api/songs/ Charts can be manually uploaded in https://toottally.com/upload/

A guide for creating custom themes can be found here

Changelog:

v1.2.3 -> v1.3.0

+ Improved scrolling
+ Implemented automatic downloads and song reload from TootTally 0.5.0
+ Added BlockedRequest.cfg 
+ Added MaxRequestCount
+ Automatically connecting twitch bot on game launch

v1.2.1 -> v1.2.3

+ Small Bug Fix
+ Fixed crashing issue when trying to play the first selected song
+ Added compatibility with TootTally in-game SongDownloader

v1.2.0 -> v1.2.1

+ Added instructions in README.md

v1.1.0 -> v1.2.0

+ Requests are now saved between game restarts
+ Added !ttrhelp: Display a message to teach users how to use the plugin
+ Added !song: Links the leaderboard of the currently played song
+ Added !queue: Enumerate currently requested song IDs
+ Added !last: Links to the latest fulfilled request
+ Added !history: Enumerate all fulfilled song request IDs
+ Prevent pop up notification during gameplay (To prevent lag spikes)

v0.1.0 -> v1.0.0

+ Connect your twitch to have access to our twitch command
+ Use F8 to toggle the twitch request pannel
+ Songs that aren't loaded in the game must be downloaded beforehand
- Restarting the game wipes the requests for now. We will store them between game restart soon in an upcoming update.