Skip to content

Touch Portal plugin to react to Streamloots card claims

License

Notifications You must be signed in to change notification settings

alfadormx/touchportal.plugin.streamloots

Repository files navigation

TouchPortal Streamloots Plugin

React to Card claims from within Touch Portal and trigger flows accordingly.

Features

  • Settings:

    • Streamloots ID - Your Streamloots ID
  • States

    • Streamloots Chest: Purchased By -
    • Streamloots Chest: Gifted By -
    • Streamloots Chest: Quantity -
    • Streamloots Card: Name -
    • Streamloots Card: Image -
    • Streamloots Card: Description -
    • Streamloots Card: Redeemed By -
    • Streamloots Card: Alert Message -
    • Streamloots Card: Field (Message) -

Installation

As with all plugins, this requires the Touch Portal Pro version to function. Follow this Import a Touch Portal plug-in (.tpp) tutorial.

To configure the plugin you need your Streamloots ID.

Plugin Settings

How to get a Streamloots ID?

  1. Log in into your Streamloots account then navigate to the Configuration > Alerts & Widgets page at the bottom part of the navigation menu.
    Alerts and Widgets
  2. Click on the Go to Alerts button.
    Alerts
  3. Click on the Click to show URL button.
    Show Url
  4. The link should look like this:
    https://widgets.streamloots.com/alerts/your-very-long-id
    
    Copy the your-very-ong-id part and paste it as your Streamloots ID in the Settings plugin page.

How to react to a card event?

The optimal way to use this plugin is by integrating it with Touch Portal's Events and Flows. Here is an example:

  1. Set up a Flow: In this example, I am creating a flow called [AlfaCoin] Dramatic Zoom. Flows can be triggered by a Button press or, in our case, by a Plugin event. Flow Settings
  2. Configure your event as follows:
    1. Name: Any name you choose for this Event.
    2. Event: Values & States - When Plug-in State changes.
    3. Cooldown time: As desired.
    4. Queue lane: As desired.
    5. When the plug-in state: Set it to Streamloots Card: Name with the condition does not change to and leave the value empty (as shown in the image below).
    6. Finally, configure each card with an IF-Else statement. Note: The Streamloots Card: Name value will be the name of the card as configured in Streamloots.

Event Settings

Want to contribute?

First off, thanks for taking the time to contribute! ❤️. Read the guideliness and setup environment instructions in our CONTRIBUTING document.

Acknowledgements

License

The content of this project itself is licensed under the GPL-3.0 license.