TwineStreamerBot

V1.2.10.0 Features and Updates!

Some notes are specific to existing users with previously generated settings/content. If this is your first version, some will not apply.

Existing users: found how to include the WebView2Loader.dll library within the 'TwineStreamerBot.exe' file (bundled). It is safe to (and should) delete the 'WebView2Loader.dll' file.

• New Features:

  • BlackJack 21 - text-based chat game!
    • Requires a currency (Data/User Data/Currency tab) to play. Be sure to setup: "Table="Currency", key_field="UserName", data_field="Value", and currency_field="{your currency name}"", and specify currency accrual parameters. Also, setup a custom currency retrieval (user-defined) command to show the user their currency.
    • Notifies players if they can enter the game with enough currency or don't have enough. Shows players if House has 21 and automatically wins.
    • Players type words "hit" (another card) or "stand" (no more cards) to advance their game. Since normal viewers usually can't repeat-type the same word within a certain timeframe, the user just needs to include the word in their chat - can be part of another word, e.g. 'standing'-> stand
    • The game starts with "!blackjack {wager}", only one game at a time
  • Game 'death' counters!
    • Let's viewers interact with stream, "!death", to record game deaths the streamer gets during stream
    • It's based on current 'Category' as set within Twitch. Ensure the category is correct for accurate death counters
    • Once a death count is added, there's a 30-second cooldown window to prevent several users from adding extra deaths
    • Use "!resetdeath" (default 0) or "!resetdeath {value}" (other value); streamer or mods (can change permission level) can reset the death counter to 0 or to a specific value. Depends on the current streamed category. (In the bot, can directly edit the death counter table.)
    • Use "!viewdeath" to only view the death counter without any updates.
    • Find the death counters in "Stream Data/Categories" tab.
  • Quotes!
    • Viewers can save quotes for quick retrieval.
    • Use "!quote" for the current saved number, "!quote {#}" to retrieve a specific number.
    • Use "!addquote {message}" to save a new quote; "!removequote {#}" to remove.
  • Follower - Game Category
    • Adding a new follower will save the current category to see under which category users followed.
    • Isn't retroactive - first startup with a category will set all current followers to the current category. If starting the bot doesn't have the category, click the "Current Category" status bar item to update it, then start (or restart) the follower service or click "Current Followers" status bar button to refresh the follower list.
    • Added logic where a follower updating their viewer name should carry forward their initial follower category (based on either the default category or as a new follower now saving the category).

• Followers:

  • Changed how the 'StatusChange' dates are applied when a user changes their name, to better reflect update changes.
  • Now shows "Category", to record under which category the user followed!

• GUI & Themes:

  • Updated theme data for Check Boxes and Radio Buttons
  • Updated theme data for 'Rectangle' boxes and 'Expander' (click to show content or hide content)
  • Updated theme data for lists in the large paragraph areas
  • Fixed visibility for some elements when starting, e.g. should be invisible but are visible
  • Updated theme data for List Boxes so they have a more uniform look.
  • Updated "Edit Window" data popup window to show the message length (in characters) for text box input data.
  • Also, "Edit Window" field for 'Platform' now shows only the current available platforms programmed into the bot.
  • The status bar version label will now show if a new release version is available for download, when first started. GitHub currently only shows version number-based URLs for stable 'release version' releases and not for unstable pre-releases. The unstable versions could have some issues most regular users don't want to face, so not every version is released as 'stable'. Hence, this label only shows new stable releases, but not intermediate releases.
  • A future release will update this 'new version' label feature to routinely check over time if there is a new version while the bot continues to run.
  • The 'Bots/Start Bots" tab now has an expander to hide the information data shown at the top
  • "Data/Overlays/Events" tab now shows available channel point redemption list with a refresh button to retrieve (without restarting the bot) newly added channel point redemptions. When adding a new Overlay event, the bot sometimes needs an updated channel point list so it's available for adding the new Overlay event.
  • Multilive tab - Corrected issue with right-click menu
  • Options tab - Added option to completely hide 'Data Management' section
  • Stream Data tab:
    • Adjusted the 'Categories' counter. Discovered when a streamer keeps the bot running between streams and uses the same game category, the category counter didn't update for each successive stream.
    • In 'Categories' tab, added "Death Counter" data.
  • Twitch Bots & Log tabs:
    • Updated the 'PubSub' portion of the log to remove extra lines for a cleaner look.
    • Found and corrected an issue preventing the "PubSub" bot from restarting after an unexpected disconnect.
    • Updated the bot to split messages into 500 character segments, including '\me' specification, for sending extra long messages. The bot will send all of the split messages to complete the entire message. Twitch will reject extra-long messages.
    • Added new "Start All Bots" and "Stop All Bots" buttons to the "Bots/Twitch" tab. Will either start all bots not already started, or stop all bots not already stopped, respectively.
    • Updated language for the token refresh date expires at 53-days, not 60; based on observed behavior where some interactions with Twitch seem to expire 7 days earlier than expected.

• Commands:

  • Existing users, please update "!approve" usage to reflect "approve" - incorrectly added in previous versions.
  • Updated command process to look up currency items. *Necessary for 'BlackJack 21' game.
  • Updated, now all commands from text chat are forced to lowercase for checking and performing code procedures
  • All commands the user adds should be all lowercase letters due to this update
  • The "!commands" listing is now sorted, includes both built-in and user-defined
  • "!blackjack {wager}" for the BlackJack 21 game
  • "!death", "!resetdeath", "!viewdeath" - relevant to death counters per game category
  • "!quote", "!quote {#}", "!addquote {msg}", "!removequote {#}" - relevant to quotes

Know Issues:

• Update When bot is started and recorded a live stream in the stream data table, the bot generates an exception (captured in exception log file) when trying to recapture the started stream details due to a new extra property not found in the stream data details. To resolve issue until next update, disable Discord updates (to prevent another notice) and delete the stream data detail for the specific date to start a new record or just don't restart the bot until after stream concludes. The bot doesn't work well after restarting during a live stream.

• Update Found an unknown issue with the PubSub bot stopping and not easily restarting to restore service. Researching the specific issue-this is how the first issue presented itself. When PubSub stopped working in one stream, it was fine in the next stream. This one might be hard to discover how it is caused without specific information.

• The "new version" label currently only shows if there is a new version when the bot starts. It doesn't currently check over time to provide new updates.

• Please provide any feedback for issues you find; including create GitHub issues.