Vs Twitch

This is a server-side mod! Only the host needs this mod installed!

Tired of having your Twitch audience watch run after run after run without them being able to meaningful interact with you in-game? Look no further, as this mod allows your audience to become the "randomness", the "aggressor", and... Mithrix.

Will your chat help you along your journey, or try to stop your run early? Chat can influence what drops you get from chests, as well as donating Twitch Bits to create random events you must fight through to survive.

First Time Setup

1. Launch the game so that the configuration file is created for the first time. Exit the game.
2. Edit the configuration file to suite your needs. See the Configuration tables below for more info.
3. Launch the game (hint: you might want to watch the intro scene one more time...)

Configurations

Currently, Channel, and ImplicitOAuth need to be filled out at a minimum (if you use nothing but the default values for the mod) from the "Twitch" section.

In game editting (via RiskOfOptions)

This mod has a dependency on RiskOfOptions and so many values can be dynamically updated while you are in the game. Note that some options need a restart for changes to be fully applied; the options menu will mark this accordingly when needed. Below you'll see a column for what configurations can be modified in game via the ✔️ marking; otherwise it'll have a ❌.

Twitch

WARNING: If the mod continues failing to connect to Twitch, check and/or update your ImplicitOAuth token!

Important note for modpack creators: Ensure your configuration files DO NOT INCLUDE ImplicitOAuth!

Tiltify

This mod supports basic integration for Tiltify campaigns. Donations cause a random "Bit Event", following the weightings in the "Event" section of the configuration.

How do I find my Campaign ID? Once your campaign is created, navigate to your Campaign Dashboard --> Detail tab and find your campaign ID. It should be a six to seven digit number.

Vote Strategies

These are the various voting strategies you can use for the VoteStrategy setting.

MaxVote

Item with the most votes wins. Ties are broken by choosing the first item that got the most votes.

MaxVoteRandomTie

Item with the most votes wins. Ties are broken by choosing randomly from the highest votes items.

Percentile

Item is chosen by a weighted random selection. If item 1 has 3 votes, item 2 has 4 votes, and item 3 has 1 vote (making a total of 8 votes), then the probabilites for choosing the item are as follows:

• Item 1: 3 / 8 = 37.50% chance
• Item 2: 4 / 8 = 50.00% chance
• Item 3: 1 / 8 = 12.50% chance

ChannelPoints

WARNING: Not typing the Channel Points title in exactly will cause the specific feature not to work! You should see a warning in the console if this happens.

See the Twitch Channel Points Guide (section "Custom Rewards") for how to create custom rewards. The Reward Name/Channel Points Title needs to be pasted into the configuration exactly as entered (case sensitive).

Event

To disable an event, simply set the weight to 0. Giving a higher weight increases the probability that the event will occur.

UI

Behaviour

Language

Events

When your channel hits the defined bit goal (via the BitsThreshold config setting), a random in-game event will occur. If enough bits are donated to trigger the goal more than once, the event's will continue to trigger until the bits are reduced under the given goal. For example, if the bit goal is 500 and someone donates 1040 bits, there will be two bit events and the current bit count will reset to 40 bits (1040 - 500 - 500 = 40).

Bit Storm

Dodge the meteors while trying to move ahead in the stage!

Bounty

Your Doppleganger has come to try to stop you!

Shrine of Order

What's this? You see a Shrine that looks rare, and seems to emit a purple hue. You can't help yourself, but you offer a Lunar coin to it...

Shrine of the Mountain

You have angered the Twitch Chat gods. Prepare for your final battle at the teleporter.

Aurelionite

Aurelionite comes from the void to try to stop you! (Until this monster is killed, the teleporter will not fully charge)

Lunar Chimera (Wisp)

Lunar Chimera's come from the void to try to stop you! (Until these monsters are killed, the teleporter will not fully charge)

Mithrix (Twitch Chat)

Twitch Chat decides to enter your stage to stop you a little earlier in the run... (Until this monster is killed, the teleporter will not fully charge)

Elder Lemurian

Elder Lumerian's come from the void to try to stop you! (Until these monsters are killed, the teleporter will not fully charge)

Chat Commands

Chat commands can only be executed by Moderators or the Broadcaster of the channel. All other users will be ignored silently.

Bit Events

• !roll - Forces a random bit event to occur.
• !meteor - Force Meteor shower bit event.
• !bounty - Force Doppleganger bit event.
• !order - Force a Shrine of Order bit event.
• !mountain - Force a Shrine of the Mountain bit event.
• !titan - Force Aurelionite bit event.
• !lunar - Force Lunar Chimera (Wisp) bit event.
• !mithrix - Force Mithrix bit event.
• !lemurian - Force Elder Lemurian bit event.
• !grandparent - Force Grandparent bit event (not currently supported).

Ally Events

These will eventually be hooked into Channel Points; but for know you can manually run these for your chat.

• !allychip <name> - Spawn ally Beetle with the given name.
• !allysuperchip <name> - Spawn random elite ally Beetle with the given name.
• !allydino <name> - Spawn ally Lemurian with the given name.
• !allysuperdino <name> - Spawn random elite ally Lemurian with the given name.
• !allybigdino <name> - Spawn ally Elder Lemurian with the given name.
• !allysuperbigdino <name> - Spawn random elite ally Elder Lemurian with the given name.

Other

• !rustedkey <name> - Give all players a rusted key.

Console Commands

These console commands are generally for testing purposes. You should never need to use them during a run.

• vs_connect_twitch <channel> <access_token> [username] - Connect to Twitch. Note that this automatically happens when starting a new run.
• vs_add_bits <bits> - Force add bits to the game. Going over the bit goal will trigger an in-game event.
• vs_set_bit_goal <bits> - Sets the bit goal and saves it to the config file.

Changelog

1.0.14

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/12?closed=1

• Added new dependency: RiskOfOptions
• Refactored configurations to hook into RiskOfOptions
• Allowed ChannelPoints to be dynamically updated in game (previously they were coded that you needed a restart)
• Unified the logging system. You should now be able to filter all of Vs Twitch logs easily via the mod launcher.

1.0.13

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/11?closed=1

• Overall, minor bug fixes
• Fixed items not being given to everyone in multiplayer when item voting turned on
• Added maintainer chat command (to help me verify myself in a channel)
• Updated the chat to show DisplayName instead of Username

1.0.12

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/10?closed=1

• Added new option to disable language changes: EnableLanguageEdits
• Added support for Tiltify campaigns
• Fixed Void cradles always rolling Lunar items when opened. This was due to the Risk of Rain 2 DLC: Survivors of the Void migrating to a new drop table mechanism. Rolling for items now use this new mechanism.

1.0.11

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/9?closed=1

• Removed R2API dependency
• Update code to work with the new Risk of Rain 2 DLC: Survivors of the Void
• Added a new Twitch configuration: PublishToChat

1.0.10

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/8?closed=1

• Minor language updates
• The Shrine of the Mountain events (bits or channel points) no longer scale according to Mountain Shrines = # of players. Each trigger will cause only one Mountain Shrine event to happen, regardless of how many players there are.

1.0.9

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/7?closed=1

• Percentile voting strategy actually works now.
• When chat is voting on Equipment and Artifact of Command is turned on, all players will immediatly recieve the equipment. It will no longer drop an orb (as if that happend, the orb would turn into a Command Essence).
• MaxVoteRandomTie will correctly pick a random item if there are no votes.
• Updated the ImplicitOAuth description to direct them to the README.md so they can easily click the link. People were trying to type the URL form the mod manager...
• Fixed Rusted Key Channel Points integration.

1.0.6

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/6?closed=1

• Updated library for new RoR2 release

1.0.5

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/5?closed=1

• When someone spends Channel Points, their username will appear in the chat.
• Event Director update: It now is created on startup and lives for the life of the game. This should help with events during the character select screen (as before they didn't work even when it seemed like they did).
• Some text formatting around numbers.
• Voting queue will be reset when a run ends. No more stacking the queue in the current run, ending the game, and getting them in the next run.
• When events happen, the teleporter will now have a visual update (purple crystals). This should help for more visual queues that something is blocking the teleporter from charging.
• The voting strategy is now configurable. (Config: VoteStrategy)

1.0.4

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/4?closed=1

• Spawned monsters from Bit/Channel Point events will not be destroyed after Void Field waves or Mithrix waves.
• Spawned monsters no longer die immediatly when hitting out of bounds/zone triggers. No more cheesing Mithrix.
• Spawned monsters do not take fall damage (mainly to counter teleporting them back into the stage).
• Twisted Scavenger should correctly drop Lunar Coins at the end instead of causing a roll
• Shrine of the Mountain, on the last stage, is worthless; now it gives all alive enemies Dio's Best Friend and random items equivalent to the number of players in the run. If the monster already has a Dio's (consumed or not) they do not recieve this buff.

1.0.3

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/3?closed=1

• All Bit Events can now be triggered via Channel Points (if configured).
• Updated title menu text.
• Update language to use they/them pronouns.
• Added more debug logging around TwitchLib (this library...can be finicky for some people). (Config: DebugLogs)
• Move the location of the vote notification to no longer be in the way of any allies. It's not positioning using the best calculation... but it's better than it was.'
• Protect against mods that cause rolls to happen mutliple times, causing the same rolls one after the other. If this happens a warning will be printed to the console.
• Allies get reduced items to hopefully be less "tanky"

1.0.2

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/2?closed=1

• Added Channel Points integration (See ChannelPoints Configuration)
• Updated how bit event bosses Health and HP scale over time. This should make them more difficult as the run progresses.

1.0.1

See more info: https://github.com/JustDerb/RoR2-VsTwitch/milestone/1?closed=1

• VsTwitch should now only activate when hosting a game. This mod will not enable and connect to Twitch if you are joining a game as a client.
• Lunar Pods have been added to the choices Twitch Chat can choose from (Config: EnableChoosingLunarItems)
• Now rolls can be forced to always be unique (Config: ForceUniqueRolls)
• Added new Bit Event: Shrine of Order (Config: ShrineOfOrderWeight)
• Added new Bit Event: Shrine of the Mountain (Config: ShrineOfTheMountainWeight)

1.0.0

• Initial release