Skip to main content

Using Bots

Matrix Bots and Commands

A guide to the available bots and commands in our Matrix server.

You may already be familiar with the chat bot functionality of the Matrix Bots, but fail.bot also offers a range of commands.

🛠️ General Commands

!help

Displays a list of available bot commands.

!echo

Echoes your message back to you.

Example:

!echo Hello, World!
Hello, World!

 

!ping [message]

Pings the bot. If you include a message, it replies with it.

Example:

!ping
Pong! (ping took 80 ms to arrive)

 

🌟 Karma Bot

!karma

Manage user karma points through voting and viewing statistics. This is largely a passive bot; users react to posts using 👍 or 👎.

Subcommands:

  • up <Event ID> — Upvote a message/event.
  • down <Event ID> — Downvote a message/event.
  • stats — View global karma stats.
  • view [user ID] — View your or another user's karma.
  • export — Export your karma data.
  • breakdown — View your karma breakdown.
  • top — See the top-rated users.
  • bottom — See the lowest-rated users.
  • best — View the highest-rated messages.
  • worst — View the lowest-rated messages.

Example:

!karma up $eventid12345

!karma top
Highest karma
chris: +23 (+34/-11)
erik: +23 (+34/-11)
chriz: +15 (+15/-0)
tapekebab: +11 (+13/-2)
colin: +10 (+11/-1)
lauren: +8 (+8/-0)
allie: +6 (+6/-0)
nate: +6 (+6/-0)
rick: +6 (+12/-6)
jillian: +5 (+5/-0)

 

🌎 Translation Bot

!translate [text]

Translate text into another language.

Example:

!translate es Hello, how are you?
¿Hola, cómo estás?

⏰ Reminder Bot

!remind

Set reminders, manage schedules, and customize timezones.

Subcommands:

  • !remind <date> [message] — Create a reminder.
  • reschedule <date> — Reschedule an existing reminder.
  • list [all] — List your active or all reminders.
  • locales — View available locales.
  • locale [locale] — Set your preferred locale.
  • timezone [timezone] — Set your timezone.

Example:

!remind 10 seconds wash socks!

I'll remind you to wash socks! in 10 seconds.
(others can 👍 this message to get pinged too)

chris: Wash socks!

🌙 Moon Phase Bot

!moon

Get the current moon phase for today.

Example:

!moon
🌑 New Moon (1% Illuminated)

 

☁️ Weather Bot

!weather

Get the current weather for any location.

Example:

!weather Tokyo
Tokyo: ☁️ +19°C (wttr.in)

Tip: Use !weather help for usage instructions.

🎲 Choice & Dice Bots

!choose <chooseText>

Randomly selects between your provided choices.

Example:

!choose pizza | sushi | tacos
tacos

!roll [pattern]

Roll dice with optional patterns.

Example:

!roll 3d20
27

😊 Reacji Bot

!reacji

Set up emoji-to-room mappings.

When a user reacts with🎖️, the message is automatically cross-posted to #hall-of-fame.

Subcommands:

  • help — Show usage.
  • list [emojus] — List emoji mappings.
  • map <mapping> — Define emoji-to-room mappings.
  • delete <mapping> — Remove a mapping.

Example:

!reacji list
🎖️ to hall-of-fame

 

🧠 Urban Dictionary Bot

!ud [term]

Search Urban Dictionary for slang terms or memes.

Example:

!ud yeet
yeet [1]: A word one may scream while [propelling] an object through the air at [alarming] speeds, [heights], and etc. (link)

📰 RSS Bot

!rss

Manage RSS feed subscriptions in rooms.

Subcommands:

  • subscribe <feed URL> — Subscribe the room to a feed.
  • unsubscribe <feed ID> — Unsubscribe from a feed.
  • template <feed ID> <new template> — Change the notification template.
  • notice <feed ID> [true/false] — Toggle notice sending.
  • subscriptions — List the subscriptions.

💰 Crypto Price Bot

!coin <exch_pair>

Fetch real-time cryptocurrency prices.

Example:

!coin btc/usd
Current exchange rate for BTC/USD: 93913.5970275634

📈 Stock Price Bot

!stock

Fetch current stock price data.

Example:

!stock F
Current data for Ford Motor Company (F):

Price: $10.04, ▼-0.10% from market open @ $10.045
52 Week High: $14.85
52 Week Low: $8.44

ℹ️ Additional Notes

  • Most commands are not case-sensitive.
  • You can add help after many commands for detailed usage (!remind help, !karma help, etc.).
  • Some bots behave slightly differently between private DMs and public rooms.
Back to top