Giter VIP home page Giter VIP logo

docs's Introduction

Streamer.bot Documentation

Streamer.bot Docs Speaker.bot Docs Discord GitHub contributors GitHub Workflow Status (with event)

Official home of all documentation content for Streamer.bot and Speaker.bot

Contributing

Contributions are welcome and encouraged!

Feel free to open an issue to discuss missing information, or just fork and PR ๐Ÿ’œ

Guidelines: TBA

MDC Components

The following are preconfigured ::callout components:

::note
This is some useful information to callout
::

::tip
This is a cool tip!
::

::warning
Some important info goes here
::

:read-more{to="/path/to/some/other/page"}

::wip
This content is a work in progress
::

Frontmatter

Some docs will be automatically built out from YAML frontmatter

All

All pages should have a title and description.

Optionally, if the release version of a feature is known, the version key should contain the Streamer.bot version it was added in.

title: Page Title
description: Some description of this page
version: 0.2.3

Sub-Actions & Triggers

Variables, Parameters (e.g. Sub-Action dialog options), and C# Method sections can automatically be built from front matter keys:

twitchService: Chat Client
parameters:
  - name: Game Title
    type: Text
    required: true
    description: |
      Enter the description for this parameter with full markdown support.

      ::tip
        It even supports mdc!
      ::
  - name: Some other parameter
    type: Select
    required: false
    description: This is the description for some other parameter
variables:
  - name: viewers
    type: number
    description: The amount of viewers this raid received
    value: 183
commonVariables:
  - TwitchUser
csharpMethods:
  - UnbanUser
  - BanUser

C# Methods

Supplemental information can be added to C# methods by adding a markdown file into the api/csharp/_methods directory with the exact same name as the C# Method:

---
description: The primary short description for SomeCsharpMethod
version: 0.2.3
parameters:
  - name: data
    description: |
      Data to be sent to connected clients

      JSON must be stringified.
    value: '"Hello, world!"'
---

Some extended description information
  • description - Short description rendered above the resulting C# code block and included in SEO
  • version - Optional value representing the version of Streamer.bot that added this feature
  • deprecated - Optional value representing the version of Streamer.bot that deprecated this feature
  • parameters - Optional of parameter documentation
    • name - The exact name of this parameter. Must match the name from Streamer.bot
    • description - Any additional documentation or info to include with this parameter. Markdown supported
    • value - An example C# value for this parameter. Will be used within the CPH Example code block and included in the Copy function
    • import - Optionally import the parameter fields above from a file in the _parameters dir (see below)

C# Parameters

Additionally, parameters information can be shared by referencing the name of any markdown or yaml file in the api/csharp/_parameters directory:

---
parameters:
  - import: SomeSharedParameter
---
---
name: my_parameter
description: |
  Some long description

  With extra info

  That would be annoying to include in every file that uses this parameter ๐Ÿ˜‰
value: 0
---

docs's People

Contributors

barkermn01 avatar bedwardly-down avatar geocym avatar gowman813 avatar haunter56 avatar ik1497 avatar jakopo87 avatar lebluxtv avatar mrcolorr avatar mustached-maniac avatar naixgames avatar nate1280 avatar pwnyy avatar rapidrabbit-11485 avatar richetoku avatar rondhi avatar sinistral2099 avatar tawmae avatar terrierdarts avatar tommy3621 avatar whipstickgostop avatar zephsinx avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

docs's Issues

Documentation needed - Trigger - Crowd Control Effect Failure

Describe the missing documentation
Crowd Control Effect Failure Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Effect Failure doesn't exist

Additional context

Variable Value
%__source% CrowdControlEffectFailure
%requestID% ef0b9898-22d9-4623-91f9-eb9ef8a0a45d
%effect.effectID% removesprite
%effect.type% game
%effect.name% Take Shine Sprite
%effect.duration% 0
%effect.note% <null>
%effect.category% <null>
%effect.description% Steal a shine sprite from the player!
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/removesprite.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704830667420
%triggerId% d6f744f8-a8a5-4c49-8f5f-f447b60e2017
%triggerName% Effect Failure
%triggerCategory% CrowdControl
%actionId% e89e0de3-c746-440f-a9fc-f2b5f5c31975
%actionName% Crowd Control Effect Failure
%user% KermitThePOGGIES
%userName% kermitthepoggies
%userId% 738066902
%userType% twitch
%isSubscribed% False
%isModerator% False
%isVip% True
%userPreviousActive% 2024-01-09 12:07:42
%eventSource% crowdcontrol
%runningActionId% 623b77ea-c13b-46f7-9255-7fcbd245abd3
%actionQueuedAt% 2024-01-09 12:09:39

Documentation needed: Linux Setup

Describe the missing documentation
Linux setup docs need ported over from the Wiki

Where do you think this documentation should be included? An existing page or new page?
Somewhere under /guide

Additional context
Need to heavily test and rewrite / cleanup the existing Linux docs

Documentation needed : Missing Datas for Variables from Chat Message trigger (TwitchChatMessage) ๐Ÿ‘๏ธ ->

Describe the missing documentation
Missing Datas for Variables from Chat Message trigger :

  • bits (int)
  • monthsSubscribed (int)

Missing isReply specifics variables :

  • reply.msgId (string)
  • reply.userId (string)
  • reply.userLogin (string)
  • reply.userName (string)
  • reply.msgBody (string) (! message include \s for each space )
  • reply.threadMsgId (string)
  • reply.threadUserLogin (string)

Where do you think this documentation should be included? An existing page or new page?
existing, Here.

Additional context
image
image

isReply variable after run viewer
image
current display
image

Documentation needed: OBS Events

Describe the missing documentation
link to full references of all OBS WebSocket 5 events

Where do you think this documentation should be included? An existing page or new page?
existing : /api/triggers/obs/event

Additional context
obs-websocket-doc

Documentation needed: Settings

Describe the missing documentation
Most of the old settings docs need brought over.

Where do you think this documentation should be included? An existing page or new page?
See existing WIP page at /guide/settings

Additional context
Things like the C# Compiler settings should probably be documented in their own respective areas, e.g. /guide/csharp, when they already exist.

Documentation needed - Trigger - Crowd Control Timed Effect Started

Describe the missing documentation
Crowd Control Timed Effect Started Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Timed Effect Started doesn't exist

Additional context

Variable Value
%__source% CrowdControlTimedEffectStarted
%requestID% e87d1b96-5275-4240-a7f4-7fba7d1e37d8
%effect.effectID% disablehammer
%effect.type% game
%effect.name% Disable Battle Hammer
%effect.duration% 30
%effect.note% <null>
%effect.category[0]% Party Battle Effects
%effect.description% ``
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/disablehammer.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704831408345
%status% begin
%timeRemaining% 30
%triggerId% dcc149a9-745a-4ee7-ab6e-162dab117590
%triggerName% Timed Effect Started
%triggerCategory% CrowdControl
%actionId% 37d4e7cc-b862-4d0b-a65f-cd18208de62f
%actionName% Crowd Control Timed Effect Started
%eventSource% crowdcontrol
%runningActionId% b4cde424-2ff7-48f7-9fe9-d88872f46e2b
%actionQueuedAt% 2024-01-09 12:16:50

Compatible with Streamlabs' Dual Output Mode

Describe the bug
When the Dual Output feature is enabled in Streamlabs, Streamer.bot's Streamlabs Action can only control the visibility of the Vertical output source, Horizontal output does not take effect.

To Reproduce
Steps to reproduce the behavior:

  1. Enable Dual Output Mode in Streamlabs OBS;
  2. Add Streamlabs connection in Streamer.bot;
  3. Add Streamlabs Source Visibility Action in Streamer.bot;
  4. Test the Action, only the source in Vertical output in Streamlabs works, not Horizontal output;
  5. Disable Streamlabs' Dual Ouput Mode, leaving the Horizontal output;
  6. Test the Action again, nothing happen.

Expected behavior
Streamlabs Source Visibility Control Action should work in both Horizontal and Vertical output;

Screenshots

Desktop (please complete the following information):

Smartphone (please complete the following information):

Additional context

Documentation needed: Action Queues

Describe the missing documentation
Action queues documentation needs added
Old Wiki Docs Here

Where do you think this documentation should be included? An existing page or new page?
See existing WIP tag on /guide/actions

Additional context
Old docs are pretty verbose and can be cleaned up a good bit

Documentation needed - Trigger - Crowd Control Timed Effect Ended

Describe the missing documentation
Crowd Control Timed Effect Ended Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Timed Effect Ended doesn't exist

Additional context

Variable Value
%__source% CrowdControlTimedEffectEnded
%requestID% e87d1b96-5275-4240-a7f4-7fba7d1e37d8
%effect.effectID% disablehammer
%effect.type% game
%effect.name% Disable Battle Hammer
%effect.duration% 30
%effect.note% <null>
%effect.category[0]% Party Battle Effects
%effect.description% ``
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/disablehammer.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704831408345
%status% end
%timeRemaining% 0
%triggerId% 5dd461b0-fabb-4a92-a9f8-40d4daf07967
%triggerName% Timed Effect Ended
%triggerCategory% CrowdControl
%actionId% bcc1a604-555f-48f7-93cf-e54d77549ebd
%actionName% Crowd Control Timed Effect Ended
%eventSource% crowdcontrol
%runningActionId% b4937619-5ce0-45d8-9335-3c6b121b8790
%actionQueuedAt% 2024-01-09 12:17:21

Documentation needed - Trigger - Crowd Control Effect Success

Describe the missing documentation
Crowd Control Effect Success Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Effect Success doesn't exist yet

Additional context

Variable Value
%__source% CrowdControlEffectSuccess
%requestID% 9fd0c981-90e3-4540-8fa1-0b5f1111dcb9
%effect.effectID% addcoins
%effect.type% game
%effect.name% Give 10 Coins
%effect.duration% 0
%effect.note% <null>
%effect.category% <null>
%effect.description% Give the player 10 coins!
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/addcoins.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704830066776
%triggerId% 110bd56f-50e4-492a-befb-46cea38c8402
%triggerName% Effect Success
%triggerCategory% CrowdControl
%actionId% 46aa125a-a58d-4b6d-8069-894312c58483
%actionName% Crowd Control Effect Success
%user% KermitThePOGGIES
%userName% kermitthepoggies
%userId% 738066902
%userType% twitch
%isSubscribed% False
%isModerator% False
%isVip% True
%userPreviousActive% 2024-01-09 11:52:42
%eventSource% crowdcontrol
%runningActionId% 2c0c4667-ab10-4fcc-8d9a-48ac454636fb
%actionQueuedAt% 2024-01-09 11:54:29

Documentation needed: Built-in Chat

Describe the missing documentation
Everything related to the streamer.bot Chat

Where do you think this documentation should be included? An existing page or new page?
new: /guide/chat

Additional context
image

Documentation needed - Trigger - Crowd Control Game Session End

Describe the missing documentation
Crowd Control Game Session End Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Game Session End doesn't exist yet

Additional context

Variable Value
%__source% CrowdControlGameSessionEnd
%gameSessionId% game_session-01hkqvqy9wsrde6326tpyhw6p7
%triggerId% ee61979f-8330-4ea8-8e6e-1b209d2870bd
%triggerName% Game Session End
%triggerCategory% CrowdControl
%actionId% 186e5e81-3458-4639-983b-51250da37d54
%actionName% Crowd Control Game Session End
%eventSource% crowdcontrol
%runningActionId% 1301c654-374d-4b70-8d0a-29def9d902ec
%actionQueuedAt% 2024-01-09 11:42:55

Documentation needed: VStream Triggers

Describe the missing documentation
Add VStream triggers pages with variables in YAML frontmatter

Where do you think this documentation should be included? An existing page or new page?
/api/triggers/vstream/<trigger>

Additional context
Variable data from TerrierDarts:

//VStream Triggers

//Present Viewers
{
    "__source" :" VStreamPresentViewers",
    "users" : "System.Collections.Generic.List`1[System.Collections.Generic.Dictionary`2[System.String,System.Object]]",
    "isLive" : true,
    "title" : "Test Stream",
    "description" : "",
    "contentWarning" : "none",
    "liveAt" : "08/03/2024 11:45:39 PM",
    "scheduledTime" : "08/03/2024 11:53:35 PM",
    "tags" : "",
    "status" : "live",
    "type" : "livestream",
    "vodVisibility" : "public",
    "triggerId" : "656a2abc-8604-46f1-a409-37bb35fbc288",
    "triggerName" : "Present Viewers",
    "triggerCategory" : "VStream/General",
    "actionId" : "1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5",
    "actionName" : "VStream Testing",
    "eventSource" : "vstream",
    "runningActionId" : "d4beef90-b18a-4b25-b0d3-d1e26caff3c2",
    "actionQueuedAt" : "08/03/2024 11:53:36 PM"
}

//User Data Example
  {
    "id": "chan_01hhaj4h2ee00bzhgd1ceaefa2",
    "userName": "TerrierDarts",
    "display": "terrierdarts",
    "role": 4,
    "isSubscribed": false,
    "isModerator": true
  }

__source = VStreamChatMessage
 messageId = chat_4ngvd3qbb780rakfe1vsmg90he
 createdAt = 09/03/2024 12:13:15 AM
 color = #89e56f
 colorR = 137
 colorG = 229
 colorB = 111
 message = aaa
 emojis = []
 rawInput = aaa
 rawInputEscaped = aaa
 rawInputUrlEncoded = aaa
 input0 = aaa
 inputEscaped0 = aaa
 inputUrlEncoded0 = aaa
 triggerId = 7c245063-658c-42d9-83bb-1cd0b2b218ba
 triggerName = Chat Message
 triggerCategory = VStream/Chat
 actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
 actionName = VStream Testing
 user = terrierdarts
 userName = TerrierDarts
 userId = chan_01hhaj4h2ee00bzhgd1ceaefa2
 userType = vstream
 isModerator = True
 userPreviousActive = 09/03/2024 12:13:17 AM
 eventSource = vstream
 runningActionId = 7837ee38-bafe-4c1a-ae31-a87434c428e9
 actionQueuedAt = 09/03/2024 12:13:17 AM


 __source = VStreamFirstWords
 messageId = chat_4ngvd3qbb780rakfe1vsmg90he
 createdAt = 09/03/2024 12:13:15 AM
 color = #89e56f
 colorR = 137
 colorG = 229
 colorB = 111
 message = aaa
 rawInput = aaa
 rawInputEscaped = aaa
 rawInputUrlEncoded = aaa
 input0 = aaa
 inputEscaped0 = aaa
 inputUrlEncoded0 = aaa
 emojis = []
 triggerId = 3e83e34a-81e1-4bcc-b9a8-0c5ddcf0175c
 triggerName = First Words
 triggerCategory = VStream/General
 actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
 actionName = VStream Testing
 user = terrierdarts
 userName = TerrierDarts
 userId = chan_01hhaj4h2ee00bzhgd1ceaefa2
 userType = vstream
 isModerator = True
 userPreviousActive = 09/03/2024 12:13:17 AM
 eventSource = vstream
 runningActionId = ed5e2b04-6079-436e-bea1-50cdc8c3999d
 actionQueuedAt = 09/03/2024 12:13:17 AM


__source = VStreamChatDeleted
chatId = chat_7hmadefay98bttp1p738cn8s13
videoChannelId = chan_01hhaj4h2ee00bzhgd1ceaefa2
videoId = video_7gntp4zxhg94avaaarq47fk713
triggerId = 041a0a4a-1498-42de-869b-27fba2ec0b95
triggerName = Chat Deleted
triggerCategory = VStream/Chat
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
eventSource = vstream
runningActionId = 169f5a2f-d69a-440d-8792-990ae9969e3b
actionQueuedAt = 09/03/2024 12:16:24 AM


triggerId = d7575e7b-b999-4f8e-aa91-92816f8cfbdf
triggerName = Broadcaster Chat Disconnected
triggerCategory = VStream/Connections
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
runningActionId = 05a52f3d-91af-442f-9ff2-4f8ab9cef61c
actionQueuedAt = 09/03/2024 12:18:04 AM

triggerId = 803f6036-dd61-4b89-9c5b-9325d385f9bc
triggerName = Broadcaster Chat Connected
triggerCategory = VStream/Connections
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
runningActionId = 654e2d34-00eb-4198-a516-2268a3c35997
actionQueuedAt = 09/03/2024 12:18:08 AM

triggerId = be55f829-e4c2-46e6-afba-c4af802ba2c8
triggerName = Broadcaster Authenticated
triggerCategory = VStream/Connections
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
runningActionId = a98edcbf-f2a9-4916-ba34-c492a5fdff54
actionQueuedAt = 09/03/2024 12:19:32 AM

__source = VStreamNewFollower
triggerId = dd98b267-b5db-4da9-ace6-0e4d6d11d6d6
triggerName = New Follower
triggerCategory = VStream/Channel
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
user = lyfesaver
userName = Lyfesaver
userId = chan_01hrg9sffwe00a0mt9c7zfvm7n
userType = vstream
isModerator = False
userPreviousActive = 09/03/2024 12:29:38 AM
eventSource = vstream


__source = VStreamStreamOffline
triggerId = 9c02151d-894e-4815-a80f-93fa4984e676
triggerName = Stream Offline
triggerCategory = VStream/Channel
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
eventSource = vstream
runningActionId = c4330194-466f-4fe4-8e61-526ce43bcd80
actionQueuedAt = 09/03/2024 12:55:02 AM

__source = VStreamStreamOnline
title = test
description = 
vodVisibility = public
triggerId = c78610a5-39de-4d1b-a743-48be5a53c148
triggerName = Stream Online
triggerCategory = VStream/Channel
actionId = 1cff8d9b-56a5-41a4-9fe7-4ea58816bcb5
actionName = VStream Testing
eventSource = vstream
runningActionId = 908864bc-ce55-4918-a2ae-ef053f90fa26
actionQueuedAt = 09/03/2024 12:56:06 AM




//TARGET USER
`%targetUser%`
`%targetUserName%`
`%targetUserId%`
`%targetUserPlatform%`
`%targetBackstory%`
`%targetIntroduction%`
`%targetUserProfileImageUrl%`
`%targetUserProfileImageEscaped%`
`%targetUserStatus%`
`%targetLastActive%`
`%targetPreviousActive%`
`%targetIsSubscribed%`
`%targetIsModerator%`


//Ban
`%bannedUser%`
`%bannedUserName%`
`%bannedUserId%`
`%bannedUserType%`
`%banResult%`

Documentation needed - FetchURL Parse JSON

Describe the missing documentation
There is currently no explanation on how to access the new variables created from the FetchURL with parse JSON feature.

Where do you think this documentation should be included? An existing page or new page?
One the Fetch URL page

Documentation needed - Trigger - Crowd Control Game Session Start

Describe the missing documentation
Crowd Control Game Session Start Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Game Session Start doesn't exist yet

Additional context

Variable Value
%__source% CrowdControlGameSessionStart
%gameSessionId% game_session-01hkqvqy9wsrde6326tpyhw6p7
%triggerId% a0b89444-29ab-4631-b31d-c32e591c72a8
%triggerName% Game Session Start
%triggerCategory% CrowdControl
%actionId% 672e6671-20b1-4237-9640-62055bc217ff
%actionName% Crowd Control Game Session Start
%eventSource% crowdcontrol
%runningActionId% 703119d7-e502-4a42-a9d8-9f3720f29ef0
%actionQueuedAt% 2024-01-09 11:38:44

Documentation needed - Trigger - Crowd Control Effect Request

Describe the missing documentation
Crowd Control Effect Request Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Effect Request doesn't exist yet

Additional context

Variable Value
%__source% CrowdControlEffectRequest
%requestID% 9fd0c981-90e3-4540-8fa1-0b5f1111dcb9
%effect.effectID% addcoins
%effect.type% game
%effect.name% Give 10 Coins
%effect.duration% 0
%effect.note% <null>
%effect.category% <null>
%effect.description% Give the player 10 coins!
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/addcoins.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704830066776
%triggerId% 26d49dd8-48ca-43d9-988e-2b276bd28935
%triggerName% Effect Request
%triggerCategory% CrowdControl
%actionId% 6d37bd82-5493-49ad-88cf-eaea3307c5a5
%actionName% Crowd Control Effect Request
%eventSource% crowdcontrol
%runningActionId% 1e7cec3b-42e7-46b6-9fd9-ab73694db03a
%actionQueuedAt% 2024-01-09 11:54:27

Documentation needed: Update custom triggers documentation

Describe the missing documentation
Add additional context for registering custom triggers within Init()

Where do you think this documentation should be included? An existing page or new page?
https://docs.streamer.bot/guide/triggers#custom-triggers

Additional context
From @Rhondi Discord Post

When registering custom triggers, it's best practice to register them in the public void Init() method. And also adjust the Execute C# Code sub-action to Precompile on Application Start

image

public void Init()
{
    CPH.RegisterCustomTrigger("New Twitch Clip Found", "clip_found", new[] {"Twitch"});
}

image

Add Rondhi's C# Visual Studio guide to docs

Describe the missing documentation
Port existing docs from gist markdown (link below)

Where do you think this documentation should be included? An existing page or new page?
Either a _partial page or new tutorials area, linked from the C# guide page.

Additional context
Rondhi's Gist

Documentation needed: MIDI

Describe the missing documentation
MIDI docs need ported from the old Wiki

Where do you think this documentation should be included? An existing page or new page?
Existing page at https://docs.streamer.bot/guide/midi

Additional context
Review any changes in recent Streamer.bot versions

Parsing JSON Error in FetchURL

Describe the bug
Using API Ninjas the JSON response is not being parsed by Streamer Bot and is instead throwing an error.
[2024-05-01 06:40:50.216 ERR] Unable to parse result as json, falling back to auto typing [{"fact": "Cows do not have any upper front teeth. Instead they have a thick pad on the top jaw"}] Newtonsoft.Json.JsonReaderException: Error reading JObject from JsonReader. Current JsonReader item is not an object: StartArray. Path '', line 1, position 1. at Newtonsoft.Json.Linq.JObject.Load(JsonReader reader, JsonLoadSettings settings) at Newtonsoft.Json.Linq.JObject.Parse(String json, JsonLoadSettings settings) at _3i0Lzx2wqGliKlNC7CtMlJ3XEbJ._7FLWL4s233ypQDlEhdJDrtFUCrh.MoveNext()

To Reproduce
Steps to reproduce the behavior:

  1. Create new action
  2. Create trigger
  3. Create sub action to fetch URL and configure it for API ninjas (https://api-ninjas.com/api/dadjokes) will need account setting the parse JSON option
  4. See error

Expected behavior
It should parse the JSON and allow us to use the generated variables to access the data.

Desktop (please complete the following information):

  • OS: Windows 10
  • Version 0.2.3

Additional context
It seems because it is returning as an array vs dictionary at the start that Streamerbot is having a challenge parsing the data.

Documentation needed - Trigger - Crowd Control Timed Effect Update

Describe the missing documentation
Crowd Control Timed Effect Update Trigger

Where do you think this documentation should be included? An existing page or new page?
Trigger page for Crowd Control Timed Effect Update doesn't exist

Additional context

Variable Value
%__source% CrowdControlTimedEffectEnded
%requestID% e87d1b96-5275-4240-a7f4-7fba7d1e37d8
%effect.effectID% disablehammer
%effect.type% game
%effect.name% Disable Battle Hammer
%effect.duration% 30
%effect.note% <null>
%effect.category[0]% Party Battle Effects
%effect.description% ``
%effect.price% 1
%effect.image% https://resources.crowdcontrol.live/images/PaperMarioTTYD/PaperMarioTTYD/icons/disablehammer.png
%price% 1
%unitPrice% 1
%game.gameID% PaperMarioTTYD
%game.name% Paper Mario: The Thousand-Year Door
%gamePack.gamePackID% PaperMarioTTYD
%gamePack.name% Paper Mario: The Thousand-Year Door
%gamePack.platform% GCN
%target.ccUID% ccuid-01hb25ab3n9v6861v0855s1wdf
%target.name% Rondhi
%target.profile% twitch
%target.originID% 3405825
%target.image% https://static-cdn.jtvnw.net/jtv_user_pictures/9bb598a0-9fab-4a0c-8ad9-48b41d5ab2fe-profile_image-300x300.png
%requester.ccUID% ccuid-01hkkmd53tdf7q4bf43k58effq
%requester.name% KermitThePOGGIES
%requester.profile% twitch
%requester.originID% 738066902
%requester.image% https://static-cdn.jtvnw.net/jtv_user_pictures/4ad22e7e-ac1d-404d-b820-cab16d16f98f-profile_image-300x300.png
%isTest% False
%timestamp% 1704831408345
%status% end
%timeRemaining% 0
%triggerId% e0baf3ab-981e-420c-adcc-ade7db89808a
%triggerName% Timed Effect Update
%triggerCategory% CrowdControl
%actionId% 3ba09bd3-b7ca-40e7-aed0-f15c0037ade4
%actionName% Crowd Control Timed Effect Update
%user% KermitThePOGGIES
%userName% kermitthepoggies
%userId% 738066902
%userType% twitch
%isSubscribed% False
%isModerator% False
%isVip% True
%userPreviousActive% 2024-01-09 12:14:42
%eventSource% crowdcontrol
%runningActionId% e55a9405-82be-44c4-bedc-894c26e5cd19
%actionQueuedAt% 2024-01-09 12:17:21

I don't fully understand how this one is triggered, as it has almost identical variables to the Timed Effect Started/Ended triggers, other than it has variables for who redeemed the effect.

Refactor C# API References

Is your feature request related to a problem? Please describe.
Currently the C# pages are a mixture of autogenerated method definitions and the old wiki-imported pages which were sorting them out in to various 'categories'.

We need a better way to continue to categorize methods and add custom supplementary information while using auto-generation as the primary source of content.

Describe the solution you'd like

  • Consider the benefits/drawbacks of supporting categorization through props or through folder structure
  • Implement a way to support supplementary information on specific C# methods via markdown content files

Additional context
Assigning myself as this requires changes to the docs core repo

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.