bizhawk-crowd-shuffler

A script for Bizhawk to allow Twitch chat to shuffle the current ROM

Setup

Note this has only been tested with Bizhawk 2.9.1.

1. Install a 2.9.x version of BizHawk.

2. Download the latest release of this project bizhawk-crowd-shuffler.

3. Create a folder called bizhawk-crowd-shuffler where the BizHawk is installed in from step 1 and unzip the release file from step 2 inside of the newly created folder.

4. Open the bizhawk-crowd-shuffler folder and copy any roms that you want shuffled into the sessions/default/CurrentROMs folder

5. Edit the bizhawk-crowd-shuffler-win.bat (for Windows) or bizhawk-crowd-shuffler-win.sh (for Linux) to fill in the CHANNEL with your Twitch channel name.

Note: You may have a popup saying "Windows protected your PC". Click more info and click "Run anyway"

Note: You may have a popup about the "Windows Firewall". You will need to allow access for the applications to work.

Note: On Linux, you need to manually run start-bizhawk-listen-to-crowd-shuffler.sh to start BizHawk.

Advanced Setup

If you would like the shuffler to be able to respond with the next rom in chat and/or users to use reward redemptions to swap you will need to do aquire an OAuth Token.

Acquiring an OAuth Token

1. Navtivate to https://dev.twitch.tv/console/apps/create

2. Enter a name for the application (e.g. MyUserNameRomShuffler)

3. Enter https://twitchapps.com/tokengen/ for the OAuth Redirect URLs field

4. Click create

5. Click manage next to your newly created application

6. Copy the value in the clientID field

7. Navigate to https://twitchapps.com/tokengen/

8. Enter your clientID from step 6

9. Enter the following scopes string in to the scopes field

channel:manage:redemptions channel:read:redemptions user:read:email chat:edit chat:read

Note: Treat the token like a password and do not share that with anyone.

10. Copy the OAuth token into the bizhawk-crowd-shuffler-win.bat (for Windows) or bizhawk-crowd-shuffler-win.sh (for Linux) file in the TWITCH_TOKEN field

11. Create redemption named "swap"

Configuration

The shuffler can be configured by adding a config.json file (an example is provided)

chatCommand

Configures the swap chat command (e.g !swap) to respond to. Set to null to disable (default: ^swap$)

chatSuppressMessages

Suppresses the chat messages in twitch chat (default: false)

chatListCommand

Configures the list chat command (e.g !list) to respond to (default: ^list$)

ignoreRomsPattern

Filter out certain files in the current roms folder from being listed and used

redemptionName

Configures the redpemption name to respond to (default: ^swap$)

randomOnly

Ignore any user filter and just uses a random rom

randomIfNoMatch

Choose a random rom if there is no match rather than ignore the command

chatCooldownGlobal

Global chat cooldown (default: 60000)

chatCooldownUser

User chat cooldown (default: 60000)

redepmtionRandomText

Text that is used for a random game via redemption (default: ^rng$)

timer

timer options

Note: Set this null to disable the timer

min

timer minimum

max

timer maximum

Miscellaneous

Donation

Contributing