From d83043f2e13653c24e3fd72281edd5bf0eeacba4 Mon Sep 17 00:00:00 2001 From: WhazzItToYa Date: Fri, 10 Oct 2025 13:12:29 -0700 Subject: [PATCH 1/3] Document Set Sub-action Weight subaction --- .../core/actions/set-sub-action-weight.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md diff --git a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md new file mode 100644 index 00000000..ed7c8e64 --- /dev/null +++ b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md @@ -0,0 +1,21 @@ +--- +title: Set Sub-Action Weight +description: Changes the random weighting of specific sub-actions within an action +parameters: + - name: Action + type: Select + required: true + description: Choose the parent action of the sub-action you wish to modify + - name: Sub-Action + type: Select + required: true + description: Choose the specific sub-action you wish to modify + - name: Weight + type: float + required: true + description: | + Sets the new "weight" for the selected sub-action, which is the probability, relative to the other subactions' weights, that the subaction will be chosen. For example, if all subaction weights are the same, then they will all be equally likely. If one subaction's weight is double another's, then that subaction will be chosen twice as often. +--- +::tip +Only applies to subactions of an Action or sub-action group that is set to Random. +:: From 57cc852d47f7a216f8efe2f7f5fd4537473506a7 Mon Sep 17 00:00:00 2001 From: WhazzItToYa Date: Fri, 10 Oct 2025 13:18:23 -0700 Subject: [PATCH 2/3] Add version:1.0.0 tags to set-sub-action subactions --- .../3.api/1.sub-actions/core/actions/set-sub-action-state.md | 3 ++- .../3.api/1.sub-actions/core/actions/set-sub-action-weight.md | 1 + 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-state.md b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-state.md index fe16c216..acddfe36 100644 --- a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-state.md +++ b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-state.md @@ -1,6 +1,7 @@ --- title: Set Sub-Action State description: Enable or disable specific sub-actions within an action +version: 1.0.0 parameters: - name: Action type: Select @@ -24,4 +25,4 @@ parameters: ::read-more{to="/api/sub-actions/core/actions/set-action-state"} To modify the state of an entire action, and all sub-actions, see the [Set Action State](/api/sub-actions/core/actions/set-action-state) sub-action -:: \ No newline at end of file +:: diff --git a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md index ed7c8e64..d69ebf98 100644 --- a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md +++ b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md @@ -1,6 +1,7 @@ --- title: Set Sub-Action Weight description: Changes the random weighting of specific sub-actions within an action +version: 1.0.0 parameters: - name: Action type: Select From a90a7d3fc7b1efb0afa531c64667add047445468 Mon Sep 17 00:00:00 2001 From: Whipstickgostop <8366326+Whipstickgostop@users.noreply.github.com> Date: Fri, 10 Oct 2025 16:48:53 -0400 Subject: [PATCH 3/3] fix: formatting --- .../core/actions/set-sub-action-weight.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md index d69ebf98..0e426336 100644 --- a/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md +++ b/streamerbot/3.api/1.sub-actions/core/actions/set-sub-action-weight.md @@ -12,11 +12,16 @@ parameters: required: true description: Choose the specific sub-action you wish to modify - name: Weight - type: float + type: Number required: true description: | - Sets the new "weight" for the selected sub-action, which is the probability, relative to the other subactions' weights, that the subaction will be chosen. For example, if all subaction weights are the same, then they will all be equally likely. If one subaction's weight is double another's, then that subaction will be chosen twice as often. + Sets the new "weight" for the selected sub-action, which is the probability, relative to the other sub-actions' weights, that the sub-action will be chosen. + + For example, if all sub-action weights are the same, then they will all be equally likely to execute. + + If one sub-action's weight is double another's, then that sub-action will be chosen twice as often. --- + ::tip -Only applies to subactions of an Action or sub-action group that is set to Random. +Only applies to sub-actions of an Action or sub-action group that is set to Random. ::