Skip to content

Command Use#

Bot commands are accessible by interacting with the bot through the below means:

Public#

  1. In a public channel using the configuration setting cfg(prefix):

    (in a channel)
    
    @Empus | y help
     @yolk | usage: help [command]
     @yolk | hint: for a command list, try: 'cmds [level]', 'cmds levels' for per level summary, or view: https://armour.bot/cmd
    
  2. In a public channel using the prefix * if configuration setting cfg(char:glob) is enabled:

    (in a channel)
    
    @Empus | * version
      @zen | version: Armour v4.0 (revision: 2024030101 -- status: current with 4_0_beta branch)
    @chief | version: Armour v4.0 (revision: 2024030900 -- status: older than master branch -- usage: update info)
     @yolk | version: Armour v4.0 (revision: 2024030900 -- status: older than master branch -- usage: update info)
    
    Command All Bots

    The use of * is to send commands to multiple Armour bots in a common channel, i.e., the private console channel specified in configuration setting cfg(chan:report)

  3. In a public channel using the bot's nickname if configuration setting cfg(char:nick) is enabled:

    (in a channel)
    
    @Empus | yolk: status
     @yolk | server connection: 5 days, 01:03:29 -- bot uptime: 20 days, 03:54:51 -- machine: FreeBSD 13.1-RELEASE-p3 -- mem: 311K
     @yolk | uptime:  7:50AM  up 406 days,  4:03, 3 users, load averages: 0.12, 0.28, 0.31
     @yolk | traffic: 2160/KB [in] and 257942/KB [out] -- whitelists: 8 entries -- blacklists: 11 entries
    
    Botnick Prefix

    Commanding the bot via botnick prefix is disabled if the openai plugin is loaded and configuration setting cfg(ask:cmdnick) is enabled.

Private#

In private message without any command prefix:

(in a query window)

Empus | info empus
 yolk | user: Empus -- account: Empus -- languages: EN -- access: global (500), #armour (500)
 yolk | email: empus@undernet.org -- lastseen: now (authed 3 days, 05:41:45 ago) -- where: Empus!empus@172.16.164.1

Partyline#

In DCC (partyline) using the command prefix in the configuration setting cfg(prefix), prefixed with .:

(in DCC partyline)

Empus | .y asn 1.1.1.1
 yolk | (ASN) for 1.1.1.1 is 13335 (desc: CLOUDFLARENET, US -- prefix: 1.1.1.0/24 -- country: AU -- registry: apnic -- info: https://bgp.he.net/AS13335)