butterrobot/docs/plugins.md

1.9 KiB

Provided plugins

Development

  • ping: Say ping to get response with time elapsed.

Fun and entertainment

  • Lo quito: What happens when you say "lo quito"...? (Spanish pun)
  • Dice: Put !dice and wathever roll you want to perform.
  • Coin: Flip a coin and get heads or tails.
  • How Long To Beat: Get game completion times from HowLongToBeat.com using !hltb <game name>

Utility

  • Help: Shows available commands when you type !help. Lists all enabled plugins for the current channel organized by category with their descriptions and usage instructions.
  • Remind Me: Reply to a message with !remindme <duration> to set a reminder. Supported duration units: y (years), mo (months), d (days), h (hours), m (minutes), s (seconds). Examples: !remindme 1y for 1 year, !remindme 3mo for 3 months, !remindme 2d for 2 days, !remindme 3h for 3 hours. The bot will mention you with a reminder after the specified time.
  • Search and Replace: Reply to any message with s/search/replace/[flags] to perform text substitution. Supports flags: g (global), i (case insensitive), n (regex pattern). Example: s/hello/hi/gi replaces all occurrences of "hello" with "hi" case-insensitively.

Security

  • Domain Blocker: Blocks messages containing links from specified domains. Configure it per channel with a comma-separated list of domains to block. When a message contains a link matching any of the blocked domains, the bot will notify that the message contained a blocked domain. This plugin requires configuration through the admin interface.

Social Media

  • Twitter Link Expander: Automatically converts twitter.com and x.com links to fxtwitter.com links and removes tracking parameters. This allows for better media embedding in chat platforms.
  • Instagram Link Expander: Automatically converts instagram.com links to ddinstagram.com links and removes tracking parameters. This allows for better media embedding in chat platforms.