Extensions

Setup

1. Installation
2. Open Relay
3. Close Relay
4. Open for Discord Triggers Only
5. Discord Triggers and Pull Values
6. Discord Emojis

Installation

1. Install the extension. You can follow the Extension Install Guide.
2. You should see a new premade deck in your SAMMI Core. We will need to edit all the values in the red SETTINGS button. Right click on the button - Edit commands:
   • Under the first green comment, you can add usernames you do NOT want to relay messages from (both Discord and Twitch). Use Array Insert command (Array Name = ignore) for each username. For example, you might not want to relay messages from any bots.
   • Fill out the Discord Relay Setup command (Bridge must be running for you to see it):
     • Twitch Username - your Twitch username (most likely your bot name) you want to use to post all relayed Discord messages to Twitch chat, must be linked in your LB
     • Twitch Channel to Join - Twitch channel username you wish to join to listen to chat message to relay and to post any relayed Discord messages
     • Discord Webhook - Discord webhook URL that you created for your Discord channel where you want to relay your Twitch chat messages.
       To create a new Discord webhook, right click on the channel in your Discord - Edit channel - Integrations - Create Webhook. Copy its URL and paste it.
     • Discord Bot Token - your Discord bot token you created and invited to your server.
       To create a new bot:
       1. Go to Discord Developer Applications.
       2. Click on ‘New Application’ button.

          

          
       3. Give it a name.
       4. After it is created, click on Bot in the left side menu. Click on Add Bot button and click on Yes, do it! button.
          If you get ‘Too many users have this username, please try another.’ error, try changing your application name to something less generic.

          

          
       5. Once your bot is created, click on Click to reveal token link, copy the token and paste it in the Discord Bot Token in SAMMI. All other settings should be left at default.

          

          
       6. Navigate to the ‘Bot’ menu and make sure MESSAGE CONTENT INTENT is checked. Otherwise all relayed messages will be empty.

          

          
       7. Click on ‘OAuth2’ - URL Generator in the side menu and check bot in the scopes list. This will open up a new menu below where you need to check Read Message History. This is only for reading messages so they can be relayed to your Twitch chat, your bot does not need any other permissions.
       8. Scroll up a bit and click on Copy. Open the link in a new browser window and invite the bot to your Discord server. You can restrict your bot to only see certain channels (by editing the channels and restricting it from seeing them), otherwise it will be relaying messages from all the channels it can see on your server.

          

          
3. Rest of the fields - do not change anything in those, automatically filled.
4. Click Save and Save again.
5. Press the green OPEN RELAY button or reload your Bridge to start relaying all messages. You should get a yellow notification message the Relay has been opened.\

If you wish to manually enable the relay instead of having it automatically enabled every time you open your Bridge, remove the Stream Deck/Bridge Connected trigger from the button (right click-Edit Triggers)

Open Relay

This button opens the Relay to listen to and relay all your Discord messages to your selected Twitch Chat channel and all your Twitch Chat channel’s messages to your selected Discord channel.

• Status - Enable
• Discord Trigger - tick it if you wish to also send Discord triggers for any Discord messages (more information can be found in Discord Triggers section)
• Listen to Discord DMs - tick if you wish to listen to your Discord Bot’s Direct Messages
  • these will only get sent as triggers to your SAMMI and will not be relayed to your Twitch Chat
  • the extension can’t listen to your personal account’s DMs, only your bot
  • more information can be found in Discord Triggers section
• Discord Mode -
  • Pretty - will relay Twitch chat messages in embed format (includes user’s profile picture and chat color)
  • Standard - will relay Twitch chat messages in text format (automatically switches to Standard if your Twitch channel has lots of messages due to Discord webhook limits)

Close Relay

Closes the connection and stops relaying all the messages. Discord triggers will be also disabled.

• Status - Close

Open for Discord Triggers Only

Opens the connection to only listen to Discord triggers. No messages will be relayed.

Discord Triggers

If you press Open Relay (and tick Discord Triggers inside the button) or Open for Discord Triggers Only button, all Discord messages will be also sent to your SAMMI where you can set up triggers for them.

You can retrieve the Discord role’s ID by going to Discord - Server Settings - Roles - right click on the role - Copy ID

Add a trigger for a Regular Discord channel message:

• Right click on the button - Edit Triggers - + - Extension trigger
• Check allow empty Wildcard (important)
• Discord Trigger name has 3 parts
  1. discordRelay = must be placed at the beginning, signifies it’s coming from Discord
  2. <message> = specific message to listen to (can include wild cards)
  3. [<role IDs>] = specific Discord roles to listen to
     • to allow any role, use [*]
     • to allow a specific role, use [*YourRoleID*]
• Example: discordRelay hello world! [*] - triggers for any Discord messages ‘hello world’ (must be an exact match) coming from any Discord role
• Example 2: discordRelay hi * [*] - triggers for any Discord message starting with ‘hi’, followed by any other word(s), coming from any Discord role
• Example 3: hello role! [*123456789789*] - triggers for any Discord message ‘hello role!’ (exact match), but it will only trigger for a specific Discord role ID 123456789789
• Example 4: discordRelay hey * [123456789789] - triggers for any Discord message starting with ‘hey’, followed by any other word(s), but it will only trigger for a specific Discord role ID 123456789789

Trigger Pull Data Values for regular Discord Messages
After your button gets triggered, you can use Trigger Pull Data command to pull the following information.

Add a trigger for a Discord Direct Message:

• Right click on the button - Edit Triggers - + - Extension trigger
• Discord DM Trigger name has 2 parts:
  1. discordRelayDM = must be placed at the beginning, signifies it’s coming from Discord DM
  2. <message> = specific message to listen to (can include wild cards)
• Example: discordRelayDM cool * - triggers for any Discord DM message starting with the word cool and having at least another character or word after (because of the *)

Trigger Pull Data Values for Discord Direct messages
After your button gets triggered, you can use Trigger Pull Data command to pull the following information.

Discord Emojis

This button should retrieve all your custom Discord emojis and save them in discordRelayEmojis.ini file in your SAMMI folder. If your Twitch viewers use any of the same emojis in the Twitch chat, they will be auto converted and properly displayed in your relayed messages to Discord.
Do not edit anything in this button. Simply press it and it should do all the work for you. If you decide to make any changes in your .ini file, do not press the button again as it will override any changes you made.

If your Twitch emojis do not match the Discord ones (= they have a different name), you can open the discordRelayEmojis.ini file and manually edit the Twitch emojis part.
For example, you have a subscriber emoji on Twitch called RamsreLord, but your Discord custom emoji’s name is RamsreFish. After pressing the button and opening the DiscordEmojis.ini file, the emojis (in our case 2 emojis) will be stored in an object like this:

  default="{ %22RamsreFish%22: %22<:RamsreFish:1000155966555295785>%22, %22butterfly%22: %22<:butterfly:1000155926126415874>%22 }"

You want to change the object key RamsreFish to RamsreLord as this is the Twitch emoji name which the extension will look for to replace it with the Discord emoji ID. Notice that %22 and %22 denote double quotes and must not get accidentally deleted. In our case the modified entry would look like this:

  default="{ %22RamsreLord%22: %22<:RamsreFish:1000155966555295785>%22, %22butterfly%22: %22<:butterfly:1000155926126415874>%22 }"

IMPORTANT: The API cannot see Discord emojis you did not upload yourself manually. If your Discord server emojis come from linking your Discord to your Twitch channel, they will not show up in the list. You can fix this by manually reuploading all the externally linked emojis in your Discord server and pressing the Discord Emojis button.