Help — RetroHexChat

/bot Command Reference

The /bot command lets admins and server operators create, configure, and manage bots. Every subcommand is administrative, including the ones that only read: running /bot with no arguments opens Bot Management, and anyone else is refused.

Syntax

/bot /bot create <name> [description] /bot destroy <name> /bot list /bot info <name> /bot join <bot> <channel> /bot part <bot> <channel> /bot enable <bot> /bot disable <bot> /bot set <bot> <key> <value> /bot commands <bot> /bot addcmd <bot> <trigger> <response> /bot delcmd <bot> <trigger>

Subcommands

create — Create a new bot. The name must be 2–16 characters. An optional description follows the name.

/bot create GreeterBot Welcomes new users

destroy — Permanently delete a bot and all its data.

/bot destroy GreeterBot

list — Show all registered bots with their status. Available to all users.

/bot list

info — Show detailed information about a bot. Available to all users.

/bot info GreeterBot

join / part — Make a bot join or leave a channel.

/bot join GreeterBot #general /bot part GreeterBot #help

enable / disable — Toggle a bot globally.

/bot enable GreeterBot /bot disable GreeterBot

set — Change a bot setting. Valid keys include: greeting, farewell, greeting_delivery, farewell_delivery, greeter_repeat_window, mention_response, prefix, cooldown, description.

/bot set GreeterBot greeting Welcome, {nickname}! /bot set GreeterBot greeting_delivery private_notice /bot set GreeterBot greeter_repeat_window 3600 /bot set GreeterBot prefix ?

Bot chat text accepts IRC formatting escapes: \c04 sets a colour, \b toggles bold, \i italic, \u underline, and \o resets formatting.

/bot set GreeterBot greeting \c03\bWelcome\o {nickname}!

commands — List custom commands for a bot. Available to all users.

/bot commands GreeterBot

addcmd / delcmd — Add or remove a custom command.

/bot addcmd GreeterBot rules Please read #rules /bot delcmd GreeterBot rules

Examples

/bot list /bot info GreeterBot /bot create GreeterBot Welcomes new users /bot join GreeterBot #general /bot addcmd GreeterBot rules Please read #rules

Rules & Limits

  • Bot names must be 2–16 characters, unique
  • Command prefix can be 1–3 characters (default: !)
  • Cooldown minimum is 500ms (default: 2000ms)
  • Only admins and server operators can use /bot at all — listing bots, reading a bot's info or its feeds included
  • Running /bot with no arguments opens the Bot Management dialog

See Also

Bot Management Dialog · BotService Overview · Bot Custom Commands · Dice · Trivia · Scheduler · RSS · Moderation

Help
GitHub License (MIT)
6 objects
GitHub License (MIT)
  • Restore
  • Minimize
  • Maximize
  • Close
  • Cascade Windows
  • Tile Windows Horizontally
  • Tile Windows Vertically
  • Minimize All Windows