Xive for Streamer.bot

1. 1

   Unzip the download

   It holds three files: Xive.Streamerbot.dll, XiveImport.bot and INSTALL.txt.

2. 2

   Copy the DLL into Streamer.bot

   Close Streamer.bot, then put Xive.Streamerbot.dll in the dlls folder inside your Streamer.bot folder (make it if it is not there).

3. 3

   Import the actions

   Open XiveImport.bot in Notepad and copy all of it. Start Streamer.bot, click Import, paste it into the Import String box and click Import. You get four actions in a Xive group: Start, Open window, Send chat, and Reference (a read-only list of everything below).

4. 4

   Sign in

   Restart Streamer.bot (or run Xive • Open window) and click Connect Xive account. Your browser opens Xive sign-in once; after that it stays signed in.

• Triggers. Right-click an action → Triggers → Add → Custom → Xive: follows, gifts, Sparks, subs, gifted subs, supporter tiers, raids, Surge, channel point redemptions (and one trigger per reward), TTS, chat, and going live or offline.

• Your commands, in Xive chat. Streamer.bot commands answer Xive chat with their aliases, cooldowns and permissions. Add Custom → Xive → Commands → (the command) to its action, next to the Twitch trigger.

• Actions. Core → C# → Execute C# Method → Xive loader: chat, timeouts and bans, roles, chat settings, title and category, polls, raids, viewer lookups (including follow age) and redemptions.

• Works offline too. When you are not live, chat and commands run on your channel’s offline chat, and test alerts from the studio still fire your triggers.

1. 1

   Actions tab → right-click → Add, name it “Thank Xive follower”.

2. 2

   Triggers → Add → Custom → Xive → Channel → Xive Follow.

3. 3

   Sub-actions → Add → Core → Arguments → Set Argument: xiveMessage = Thanks for the follow, %user%!

4. 4

   Sub-actions → Add → Core → Actions → Run Action → “Xive • Send chat”, tick Run Immediately.

5. 5

   Test it from the Xive studio with Send test alert → Follow.

Swap the trigger and the message for anything else: %user% sent %giftName%!, Thanks for the %sparks% Sparks, %user%!, %user% is raiding with %viewers%!

Version 1.0.9 adds clips: CreateClip, GetChannelClip and the Xive Clip Created trigger (Custom → Xive → Channel). Who may clip is set in Creator Studio → VODs & Clips → Stream clips.

1. !clip: make a !clip command with the Xive command trigger. Set Argument xiveClipCreditUser = %userName% (the handle, not %user%), then Execute C# Method → Xive loader → CreateClip, then Send chat with xiveMessage = Clipped! %xiveClipUrl%.
2. Shoutout with a clip: in !so, set xiveClipChannel = %input0% and run GetChannelClip. If xiveShoutoutClipFound is True, point an OBS Media Source at %xiveShoutoutClipUrl%, show it, wait %xiveShoutoutClipDuration% seconds, then hide it.

Every trigger carries platform (xive), xiveAccount, xiveLive, xiveViewers and xiveStreamId. Event triggers also carry user, userId, avatarUrl, amount, amountLabel (e.g. “500 Sparks”), eventType, createdAt and isTest.

Set the arguments with Set Argument first, then add Execute C# Method → Xive loader → (method). Results come back as arguments for the sub-actions after it. The target user is never taken from the trigger: set xiveUserId (e.g. %userId%) or xiveUser (a username, e.g. %input0%).