SheevPad action button

Requirements and availability

Use the matching SheevChat version.

Picker contexts: pad.

Behavior

Click an enabled action button to execute up to 20 stored actions in order. A thrown failure stops remaining actions; visual state toggles only after success. Synthetic username defaults SheevPad, role broadcaster/authority 99, command sheevpad; missing/invalid requested platform defaults Twitch. Buttons are not viewer-triggered events. Groups organize buttons; visual toggle is appearance, not external-device state.

Configure in the app

Open: SheevPad → Add Group / Add Button

SheevPad uses Group rather than Bot Category. Choose Add Group, fill Group Name, optionally enable Favorite group, then Save Group before assigning buttons.

Initial fields

Name

Button label, up to 40 characters.

Type

Action button, or Mobile navigation.

Group

Choose a saved group, or Ungrouped.

Color

Choose button appearance.

Background Image

Optional library image; Upload Images opens the Media Library.

Enabled

On by default.

Visual On/Off state

Off by default; appearance only. If enabled, Current visual state sets the displayed state.

Steps

1. Open SheevPad from the app header. Create and save any groups first.
2. Choose Add Button. Fill Name, Type, Group, Color, optional Background Image and Enabled.
3. For Action button, optionally configure Visual On/Off state and Current visual state. These do not branch the action list or read external device state.
4. Open Do (for commands also expand Advanced Actions). Choose an action category and action, then click Add action; alternatively search for its exact label. Expand its card and fill the documented fields using real resource pickers. Repeat for every action. Use Move action up / Move action down to set execution order. Actions run sequentially; adding several does not create parallel execution.
5. Click Save Button explicitly. Test can execute effects; use it only when safe. Preview arranges the mobile/tablet layout.
6. Save, reopen and verify the persisted fields and action order. Test only when the effects are intended: chat, audio, ads and external app actions can affect connected services. A synthetic test does not establish that a real incoming event or platform permission works. Confirm a real eligible event separately during live UAT.

Contract details

Fields

[
  "kind",
  "groupId",
  "label",
  "enabled",
  "actions",
  "visualToggle",
  "visualActive"
]

Defaults

{
  "kind": "button",
  "enabled": true,
  "visualToggle": false
}

Limits

{
  "actionsPerButton": 20,
  "buttons": 80
}

Navigation

See navigation.pad.*; navigation buttons cannot run actions.

Picker Rule

For command/pad, the action picker exposes all nonhidden actions regardless of declared contexts. Runtime requirements still apply.

Examples

Illustrative configuration; replace fixture resources in the editor. This is not an import file.

{
  "kind": "button",
  "label": "Play example audio",
  "enabled": true,
  "actions": [
    {
      "type": "send_overlay_audio",
      "mediaId": "fixture-audio",
      "volume": 100
    }
  ]
}

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

• server.js — runSheevPadButton / normalizeSheevPadConfig
• public/index.html — runSheevPadButton / normalizeSheevPadConfig
• src/features/sheevpad/visual-toggle-state.js — runSheevPadButton / normalizeSheevPadConfig

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1