Velora.Bot Tutorial Examples

Version 1.0.0

Ready-to-use examples for Streamer.bot commands and trigger workflows on Velora.tv.

Hello World on Stream Start

Sends a simple status message when your stream goes live.

  1. Open Actions & Queues -> Actions. Bot Active tutorial step 1
  2. Right-click inside the Actions field, click Add Action, and name it e.g. [Velora] Bot Active Message. Bot Active tutorial step 2 image 1 Bot Active tutorial step 2 image 2
  3. Right-click inside the Triggers field (upper-right area), then in the context menu choose:
    Add -> Custom -> Velora -> Stream -> [Velora.Bot] Stream Started Bot Active tutorial step 3
  4. Right-click inside the Sub-Actions field and choose:
    Add -> Core -> Arguments -> Set Argument
    Variable Name: message (important: must be exactly this name)
    Value: Velora.Bot is here! VeloraFlameMindBlown Bot Active tutorial step 4 image 1 Bot Active tutorial step 4 image 2
  5. Add Execute C# Method via:
    Add -> Core -> C# -> Execute C# Method
    Code: [Velora.Bot] Actions
    Method: SendMessage
    Confirm with OK. Bot Active tutorial step 5 image 1 Bot Active tutorial step 5 image 2

Done! For a local test, right-click the trigger and click Test Trigger.

Bot Active tutorial step 6

Useful variables: %game%, %status%, %gameId%, %startedAt%.

Clip Command (!clip)

Creates clips directly from chat. Optional seconds are supported, for example !clip 45.

  1. Open Actions & Queues -> Actions. Clip command tutorial step 1
  2. Right-click inside the Actions field, click Add Action, and name it e.g. [Velora] Clip Command. Clip command tutorial step 2 image 1 Clip command tutorial step 2 image 2
  3. Open Commands, then right-click in the command list and click Add Command. Clip command tutorial step 3 image 1 Clip command tutorial step 3 image 2
  4. Configure the command:
    Name: !clip
    Command(s): !clip
    Set your desired permissions and confirm with OK. (In this example everyone can use it.) Clip command tutorial step 4
  5. Click Save in the top left. (This is required so custom triggers for commands and rewards get added.) Clip command tutorial step 5
  6. Back in Actions & Queues, make sure you are in the action you just created.
  7. Right-click in the Trigger field and add:
    Add -> Custom -> Velora -> Commands -> [Velora.Bot] !clip (!clip) Clip command tutorial step 7
  8. Clip title:
    Right-click in Sub Actions and add Add -> Core -> Arguments -> Set Argument
    Variable Name: clipTitle
    Value: Clip created by %user% Clip command tutorial step 8 image 1 Clip command tutorial step 8 image 2
  9. Right-click in Sub Actions and add Add -> Core -> C# -> Execute C# Method
    Code: [Velora.Bot] Actions
    Method: CreateClip Clip command tutorial step 9
  10. Right-click in Sub Actions and add Add -> Core -> Logic -> If/Else
    Input: %clipSuccess%
    Operation: Equals
    Value: True Clip command tutorial step 10 image 1 Clip command tutorial step 10 image 2
  11. In the True branch, nothing is required. Velora posts link + preview automatically.
  12. In the False branch add:
    Add -> Core -> C# -> Execute C# Method -> SendReply (or SendMessage) Clip command tutorial step 12 image 1 Clip command tutorial step 12 image 2

Done! Test with !clip or !clip 45 in chat. Clip creation can take a few seconds before feedback appears, and very long durations near the maximum can occasionally return a false timeout/abort message. If the streamer is offline, Velora sends an offline message.

Clip command tutorial done image 1 Clip command tutorial done image 2

!clip without a duration always creates a 60-second clip. Clip duration is limited to 15-120 seconds. Recommended variables: %clipSuccess%, %clipUrl%, %clipId%, %clipErrorMessage%.

Title Change Command (!title)

Allows moderators to change your stream title directly from chat.

  1. Open Actions & Queues -> Actions. Title command tutorial step 1
  2. Right-click inside the Actions field, click Add Action, and name it e.g. [Velora] Title Command. Title command tutorial step 2 image 1 Title command tutorial step 2 image 2
  3. Open Commands, then right-click in the command list and click Add Command. Title command tutorial step 3 image 1 Title command tutorial step 3 image 2
  4. Configure the command:
    Name: !title
    Command(s): !title
    Set permissions to moderators (or your preferred role setup) and confirm with OK. Title command tutorial step 4
  5. Click Save in the top-left. (This is required so custom triggers for commands and rewards get added.) Title command tutorial step 5
  6. Back in Actions & Queues, make sure your newly created action is selected.
  7. Right-click in the Trigger field and add:
    Add -> Custom -> Velora -> Commands -> [Velora.Bot] !title (!title) Title command tutorial step 7
  8. Right-click in Sub Actions and add Add -> Core -> C# -> Execute C# Method
    Code: [Velora.Bot] Actions
    Method: ChangeStreamInfo Title command tutorial step 8 Title command tutorial step 8 image 2

Done! Test directly in chat with !title Test title. This can currently only be tested live, and after entering the command you need to reload the page to see the updated title.

Title command tutorial done

Everything after !title is used as the new stream title.

Reward Redemption -> Play Sound

Plays a sound when a reward is redeemed.

  1. Create your rewards on Velora first at https://velora.tv/dashboard/community in the Channel Points tab. Reward redemption tutorial step 1
  2. In Streamer.bot, click Save in the top-left. This ensures new custom triggers are added. Reward redemption tutorial step 2
  3. Open Actions & Queues -> Actions.
  4. Right-click inside the Actions field, click Add Action, and name it e.g. [Velora] Reward Sound. Reward redemption tutorial step 4
  5. Right-click inside the Triggers field and choose:
    Add -> Custom -> Velora -> Rewards -> [Velora.Bot] Reward Redeemed
    or choose a reward-specific trigger like [Velora.Bot] Reward Redeemed - <Reward Name>. Reward redemption tutorial step 5
  6. Right-click in Sub-Actions and add:
    Add -> Core -> Sounds -> Play Sound
    Audio Output Device: Leave on Application Default or select an output device of your choice.
    Name: Leave empty, we use a local file path.
    Sound file to play: Click the icon next to the text field and select your file.
    Then confirm with OK. Reward redemption tutorial step 6 image 1 Reward redemption tutorial step 6 image 2 Reward redemption tutorial step 6 image 3
  7. Open Queues, right-click inside the queue field, choose Add, name it e.g. RewardSounds, and enable Blocking. Reward redemption tutorial step 7 image 1 Reward redemption tutorial step 7 image 2 Reward redemption tutorial step 7 image 3
  8. In Actions, right-click your reward action, click Edit, and set Queue to the queue you just created. Reward redemption tutorial step 8 image 1 Reward redemption tutorial step 8 image 2

Done! Test by redeeming the reward on Velora.

Useful variables: %rewardId%, %rewardTitle%, %rewardUserInput%, %user%.

Follow Alert (Sound + OBS Text + GIF Fade)

Builds a full follow alert workflow with sound, text, and GIF fade for OBS.

  1. First add your streaming software under Stream Apps (in this example OBS). Right-click inside the Stream Apps field and add a new entry, e.g. OBS. Make sure WebSocket is enabled in OBS. If your WebSocket uses a password, set it here. Enable Auto Connect on Startup, Reconnect, and Disconnect. Then right-click the created WebSocket connection in Streamer.bot and click Connect. The connection is successful once you see an active OBS state on the right under OBS Information and Status: Connected in the center. Follow alert tutorial step 1 image 1 Follow alert tutorial step 1 image 2 Follow alert tutorial step 1 image 3 Follow alert tutorial step 1 image 4 Follow alert tutorial step 1 image 5 Follow alert tutorial step 1 image 6
  2. Open Actions & Queues -> Actions.
  3. Right-click inside the Actions field, click Add Action, and name it e.g. [Velora] Follow Alert. As with Channel Point sound alerts (see Reward Sound from step 7), it is recommended to use a dedicated queue with Blocking enabled, or use exactly the same queue, so reward sounds and follow alerts do not overlap. Follow alert tutorial step 3 image 1 Follow alert tutorial step 3 image 2
  4. Right-click inside the Triggers field and choose:
    Add -> Custom -> Velora -> Channel -> [Velora.Bot] Follow Follow alert tutorial step 4
  5. Right-click in Sub-Actions and add:
    Add -> Core -> Sounds -> Play Sound
    Audio Output Device: Leave on Application Default or select an output device of your choice.
    Name: Leave empty, we use a local file path.
    Sound file to play: Click the icon next to the text field and select your file.
    Then confirm with OK. Follow alert tutorial step 5 image 1 Follow alert tutorial step 5 image 2
  6. Go back to OBS and add a new source named TextGDI. Follow alert tutorial step 6 image 1 Follow alert tutorial step 6 image 2
  7. In TextGDI, enter Thanks for the follow, %user%! so you can align it properly. Follow alert tutorial step 7
  8. Go to Transform -> Edit Transform and set Bounding Box Type to Maximum Size Only. Set the size via Bounding Box Size (important: adjust the bounding box size, not the general scale). Follow alert tutorial step 8 image 1 Follow alert tutorial step 8 image 2
  9. Right-click the TextGDI source and set your preferred Show Transition and Hide Transition (for example Fade with your desired duration in ms). Follow alert tutorial step 9
  10. Add another source with your desired GIF. Follow alert tutorial step 10 image 1 Follow alert tutorial step 10 image 2 Follow alert tutorial step 10 image 3
  11. Right-click your GIF source and apply the same show/hide transitions. Optionally, put both elements into one folder/group and configure show/hide transitions on that folder instead of each source.
  12. Hide both sources in OBS (or hide the folder/group that contains both elements). This way you can immediately verify if the show animation timing fits. Follow alert tutorial step 12
  13. Right-click in Sub-Actions and add:
    Add -> OBS Studio -> Sources -> Set GDI Text
    Select your TextGDI source and set the text to Thanks for the follow, %user%!. Follow alert tutorial step 13 image 1 Follow alert tutorial step 13 image 2
  14. Right-click in Sub-Actions and add:
    Add -> OBS Studio -> Sources -> Set Source Visibility State
    Select your TextGDI source and set it to Visible. Repeat this for your GIF source, or select the folder/group once if both elements are inside it. Follow alert tutorial step 14 image 1 Follow alert tutorial step 14 image 2
  15. Right-click in Sub-Actions and add:
    Add -> Core -> Delay
    Set the delay to e.g. 3000 ms. Follow alert tutorial step 15 image 1 Follow alert tutorial step 15 image 2
  16. Add the same subaction from Step 14 again:
    Add -> OBS Studio -> Sources -> Set Source Visibility State
    Select your TextGDI source and set it to Hidden. Repeat this for your GIF source, or select the folder/group once if both elements are inside it.

Done! For local testing, right-click the trigger and click Test Trigger. Note: %user% is only replaced with a real username when an actual follow event is received.

Follow alert tutorial done

Useful variables: %user%, %userName%, %userId%, %avatarUrl%, %groupsDelimited%.