====== !event ======

[[start|← Go back]]

^ Delay | 1 second |
^ Subcommands | ''on'', ''off'', ''list'', ''edit'', ''target'', ''massping'', ''call'', ''view'' |
^ Aliases | - |
^ Minimal rights | {{:bot:commands:moderator.png?nolink&16|}} Moderator |

===== Event types =====

==== Twitch ====

  - twitch.live
  - twitch.offline
  - twitch.title
    * Placeholders: ''{new}'' - new title
    * Message example: This streamer has changed the title - {new}
  - twitch.game
    * Placeholders: ''{new}'' - new game
    * Message example: This streamer is now playing {new}
  - twitch.message
    * Placeholders: ''{message}'' - target's message, ''{author}'' - username, ''{origin}'' - room name
    * Message example: {author} has just said something in #{origin}: {message}
    * Target example: forsen:twitch.message
    * **Note: To receive the messages, the bot will join the target channel.**
  - twitch.first-message
    * Placeholders: ''{message}'' - user's first message, ''{author}'' - username, ''{origin}'' - room name
    * Message example: {author} has just said their first words in #{origin}: {message}
    * Target example: forsen:twitch.first-message
    * **Note: To receive the first messages, the bot will join the target channel.**

==== Kick ====

  - kick.live
  - kick.offline
  - kick.title
    * Placeholders: ''{new}'' - new title
    * Message example: This streamer has changed the title - {new}
  - kick.game
    * Placeholders: ''{new}'' - new game
    * Message example: This streamer is now playing {new}

==== 7TV ====

  - 7tv.added-emote
    * Placeholders: ''{new}'' - emote name, ''{old}'' - original emote name
    * Message example: New 7TV emote: {new} (originally {old})
    * Target example: xqc:7tv.added-emote
  - 7tv.deleted-emote
    * Placeholders: ''{new}'' - emote name, ''{old}'' - original emote name
    * Message example: 7TV emote {new} (originally {old}) has been removed
    * Target example: xqc:7tv.deleted-emote
  - 7tv.renamed-emote
    * Placeholders: ''{new}'' - new emote name, ''{old}'' - previous emote name
    * Message example: 7TV emote {old} has been renamed to {new}
    * Target example: xqc:7tv.renamed-emote

==== BetterTTV ====

  - bttv.added-emote
    * Placeholders: ''{new}'' - emote name, ''{old}'' - original emote name
    * Message example: New BTTV emote: {new} (originally {old})
    * Target example: forsen:bttv.added-emote
  - bttv.deleted-emote
    * Placeholders: ''{new}'' - emote name, ''{old}'' - original emote name
    * Message example: BTTV emote {new} (originally {old}) has been removed
    * Target example: forsen:bttv.deleted-emote
  - bttv.renamed-emote
    * Placeholders: ''{new}'' - new emote name, ''{old}'' - previous emote name
    * Message example: BTTV emote {old} has been renamed to {new}
    * Target example: forsen:bttv.renamed-emote

==== Social media ====

  - telegram.post
    * Placeholders: ''{message}'' - message content, ''{link}'' - post link
    * Message example: Durov posted a new Telegram post: {message} ({link})
    * Target example: durov:telegram.post
  - twitter.post
    * Placeholders: ''{message}'' - message content, ''{link}'' - post link
    * Message example: Notch posted a new tweet: {message} ({link})
    * Target example: notch:twitter.post

==== Miscellaneous ====

  - rss
    * Placeholders: ''{message}'' - message content, ''{link}'' - post link
    * Message example: new post on tea.shungites.casa: {message} ({link})
    * Target example: https://tea.shungites.casa/index.xml:rss

===== Syntax =====

> ''[target]'' is short for ''[name]:[type]''. For ''[name]'', look for __Target example__ in your [[#event_types|event type]].
> If there is no such field, use Twitch/Kick username.

==== Create a new event ====

''!event on [target] [message...]''

  * ''[target]'' - Event target.
  * ''[message]'' - The message that will be sent with the event.

==== Delete the event ====

''!event off [target]''

  * ''[target]'' - Event target.

==== Make the event massping everytime ====

''!event massping [target]''

  * ''[target]'' - Event target.

==== Edit the event message ====

''!event edit [target] [message...]''

  * ''[target]'' - Event target.
  * ''[message]'' - New message.

==== Set a new target for the event ====

''!event target [target] [new_target]''

  * ''[target]'' - Current event target.
  * ''[new_target]'' - New event target.

==== Call the event ====

> The bot requires {{:bot:commands:moderator.png?nolink&16|}} Moderator privileges on events with the "massping" flag.

''!event call [target]''

  * ''[target]'' - Event target.

==== View the event ====

''!event view [target]''

  * ''[target]'' - Event target.



[[https://bot.alright.party/~/event|Check the source code]]