[Feature Request] Support combos
Describe the solution you'd like
I would like Firebot to have event(s) corresponding to channel.bits.use which encompasses "whenever Bits are used on a channel." These presently include the listed events, with a note that it "might be updated in the future as more Twitch features use Bits."
- Cheers
- Power-ups (gigantify an emote, on-screen celebration, message effects)
- Combos (currently in closed beta)
Additional context
There's a related issue and PR in twurple:
- https://github.com/twurple/twurple/issues/618
- https://github.com/twurple/twurple/pull/620
My previous issue about supporting power-ups is also related to some degree:
- https://github.com/crowbartools/Firebot/issues/3151
Dev note I'm going to be writing something for my own use because I need to be notified whenever bits are used, and a streamer that I support had combos enabled but got no events. I need the username and bits used but not necessarily the details (and in fact I couldn't find any examples of the payload for the new "combo" thing). My thought was to create one event per type of bit use, e.g. "Combo used" and "Power-up used" would be separate events even though they emanate from the same underlying eventsub subscription. If this is something you think would be generally useful and would like me to share what I come up with, let me know. If not, that's cool too, and I can just keep it in my own branch until there's better support from Twurple.
Updating this issue to specifically request combos due to #3208. Adding blocked due to combos still being beta
My channel finally got added to the closed beta for combos and I had someone test it out.
- No Firebot event at all (due to this explicitly not doing anything)
- A couple Twurple errors from undocumented events that appear to be for "combo start" and "combo end"
Documenting what I saw -- I had hacked in a log.info to capture the combo payload:
[2025-09-08T05:24:27.055Z] twurple:chat:twitch WARNING Unrecognized usernotice ID: onetapstreakstarted
[2025-09-08T05:24:27.055Z] twurple:chat:twitch WARNING Unrecognized usernotice ID: onetapstreakstarted
[2025-09-08 05:24:27.0474] - info: Received combo bits event, which is not currently handled by Firebot.
[2025-09-08 05:24:27.0474] - info: {
"user_id": "1150767481",
"user_login": "thestaticbrock",
"user_name": "TheStaticBrock",
"broadcaster_user_id": "648285308",
"broadcaster_user_login": "thestaticmage",
"broadcaster_user_name": "TheStaticMage",
"bits": 5,
"type": "combo",
"power_up": null,
"messageText": null,
"messageParts": []
}
<snip>
[2025-09-08T05:25:26.731Z] twurple:chat:twitch WARNING Unrecognized usernotice ID: onetapstreakexpired
[2025-09-08T05:25:26.732Z] twurple:chat:twitch WARNING Unrecognized usernotice ID: onetapstreakexpired
For all intents and purposes, the combo is someone giving you 5 bits, just with a different button. At some point this could be supported in channel.bits.use but I understand the devs wanting to wait until this is out of beta. For now I just hacked my local copy to basically do the exact same thing as the cheer event when the type is combo.
I could not find any reference to onetapstreakstarted or onetapstreakexpired on Twurple's GitHub, on Twitch's site, or even with a general internet search. But it does appear that there may eventually be events to add for these at some point in the future.
The Twurple warnings we can ignore. Those are logged when Twurple IRC chat receives notices it isn't familiar with, but we're eventually going to be moving away from IRC to EventSub for chat, so those won't be relevant.
As for the EventSub event, that empty switch case is intentional as we will not be implementing it until combos leave beta and are generally available for all.
I've written support for combos as a custom script / plugin. At such time as combos become officially released by Twitch, I'll be happy to contribute this.
https://github.com/TheStaticMage/firebot-combo-event