- Logging in and out
- User-management
- User capabilities
- Channel management
- Applet-management
- Plugin-management
- Command metadata
- Event-queue management
- Process-management
- Message-history/user-tracking
- Miscellaneous
You cannot use any of the admin commands unless you login. Note that the login
command requires that your currently
connected IRC hostmask matches the hostmask configured for the user account.
You can keep your user account permanently logged in by setting a couple of user metadata values. See the user metadata list for more information.
Logs into PBot.
Usage: login [channel] <password>
Logs out of PBot.
Usage: logout
Adds a new user to PBot.
Usage: useradd <username> <hostmasks> [channels [capabilities [password]]]
Parameter | Description |
---|---|
username |
A unique name to identify this account (usually the nick of the user, but it can be any identifier). |
hostmasks |
The hostmasks from which this user is recognized/allowed to login from (e.g., somenick!*@*.somedomain.com or *!*@unaffiliated/someuser ). Can be a comma-separated list of values. |
channels |
The channels this user belongs to; use global for all channels. Can be a comma-separated list of values. |
capabilities |
A comma-separated list of user-capabilities for this user. |
password |
The password the user will use to login (from /msg , obviously). Users may update their password by using the my command once logged in. |
Removes a user from PBot.
Usage: userdel <username>
Sets metadata or user-capabilities for a user account. See also: user metadata list.
If key
is omitted, it will list all the keys and values that are set. If value
is omitted, it will show the value for key
.
Usage: userset <username> [<key> [value]]
Deletes a metadata or user-capability from a user account.
Usage: userunset <username> <key>
This is a list of recognized metadata keys for user accounts.
Name | Description |
---|---|
autologin |
Automatically log the user in when they join the channel. Note: make sure the user account's hostmask wildcards are as restrictive as possible. |
autoop |
Give the user operator status when they join the channel. Note: make sure the user account's hostmask wildcards are as restrictive as possible. |
autovoice |
Give the user voiced status when they join the channel. Note: make sure the user account's hostmask wildcards are as restrictive as possible. |
capabilities | User-capabilities are managed as user metadata. |
channels |
A comma-separated list of channels this user belongs to. |
hostmasks |
A comma-separated list of hostmasks this user is recognized by. |
location |
Sets your location for using the weather command without any arguments. |
loggedin |
Whether the user is logged in or not. |
notyposub |
Disallows s/// typo substitutions. |
password |
The password for the user account. |
stayloggedin |
Do not log the user out when they part/quit. |
timezone |
Sets your timezone for using the date command without any arguments. |
units |
Sets the unit for Wolfram|Alpha answers (imperial or metric ) |
To list user accounts, use the users
command. This is not an admin command, but
it is included here for completeness. Users with a plus (+) sign next their name have
user-capabilities set on their account.
Usage: users [channel]
When the optional [channel]
argument is provided, only users for that channel
will be listed; no global users will be listed.
When [channel]
is omitted and the command is used in a channel, it will list
the users for that channel, plus all global users.
When [channel]
is omitted and the command is used from private message, it will
list all users from all channels, including global users.
PBot uses a user-capability system to control what users can and cannot do. User-capabilities provides fine-grained permissions over various PBot functionality. User-capabilities may be grouped into roles such as Admin, ChanOp, Moderator, and other user-defined roles.
For example, imagine a user named alice. alice has no capabilities granted yet.
She tries to use the ban
command:
<alice> !ban somebody
<PBot> The ban command requires the can-ban capability, which your user account does not have.
Suppose alice tries to grant herself the can-ban capability:
<alice> !my can-ban 1
<PBot> The can-ban metadata requires the can-modify-capabilities capability, which your user account does not have.
To grant her the can-ban
capability, a user with the can-userset
and can-modifiy-capabilities
capabilities
can use the userset
command:
<bob> !userset alice can-ban 1
Now alice can use the ban
command.
Let's consider the mode
command. Channel operators can use their IRC client's /mode
command to
set any channel modes, including any undesirable modes (such as +k). Suppose you'd prefer to limit
their modes to just a specific subset of all modes. You can do this with user-capabilities. To do so,
instead of making them channel operators you can make them PBot users and grant them specific PBot
user-capabilities.
First grant the user the can-mode
capability so they can use the PBot mode
command. Then grant them the specific
can-mode-<flag>
capabilities. To allow them to set any modes without restriction, grant them the can-mode-any
capability.
See this demonstration:
<alice> !mode +b test
<PBot> The mode command requires the can-mode capability, which your user account does not have.
<bob> !userset alice can-mode 1
<alice> !mode +b test
<PBot> Your user account does not have the can-mode-b capability required to set this mode.
<bob> !userset alice can-mode-b 1
<alice> !mode +b test
* PBot sets mode +b test!*@*
<alice> !mode +k lol
<PBot> Your user account does not have the can-mode-k capability required to set this mode.
As you can see, user-capabilities can be very flexible and very powerful in configuring your channel users. Check out grouping capabilities in the upcoming section of this document, as well. Read on!
Use the cap
command to list capabilities, to manage capability groups and to
see what capabilities a user has.
Usage:
cap list [capability] |
cap group <existing or new capability group> <existing capabilities...> |
cap ungroup <existing capability group> <grouped capability> |
cap userhas <user> [capability] |
cap whohas <capability>
Use cap list [capability]
to list user-capabilities.
If [capability]
is omitted, the command will list all available capabilities.
<pragma-> cap list
<PBot> Capabilities: admin (25 caps), botowner (71 caps), can-ban (1 cap), can-deop (1 cap),
can-devoice (1 cap), can-mode-any (53 caps), can-mute (1 cap), can-op (1 cap), can-unban (1 cap),
can-unmute (1 cap), can-voice (1 cap), chanmod (4 caps), chanop (10 caps), moderator (4 caps),
can-actiontrigger, can-akalink, can-akaunlink, can-antispam, can-blacklist, ...
Capabilities can be grouped together into a collection or role, which can then be applied to a user. Capability groups can contain nested groups.
In the listing capabilities example, the admin
capability is
a group containing several capabilities, including other grouped capabilites such as the chanop
capability
group which itself can contain more groups and capabilities.
Observe.
<pragma-> cap list admin
<PBot> Grouped capabilities for admin: can-mode-any (53 caps), chanop (10 caps),
can-actiontrigger, can-akalink, can-akaunlink, can-antispam, can-blacklist,
can-chanlist, can-clear-bans, can-clear-mutes, can-countertrigger, can-ignore,
can-in, can-join, can-kick-wildcard, can-mode, can-op-wildcard, can-part,
can-unignore, can-useradd, can-userdel, can-userset, can-userunset, can-voice-wildcard
<pragma-> cap list chanop
<PBot> Grouped capabilities for chanop: can-ban (1 cap), can-deop (1 cap), can-devoice (1 cap),
can-mute (1 cap), can-op (1 cap), can-unban (1 cap), can-unmute (1 cap), can-voice (1 cap),
can-invite, can-kick
<pragma-> cap list can-ban
<PBot> Grouped capabilities for can-ban: can-mode-b
To create a new capability group or to add capabilities to an existing group,
use the cap group
command.
Usage: cap group <existing or new capability group> <existing capabilities...>
For example, to create a new capability group called moderator
who can strictly
only set mode +m
or mode -m
and use the voice
and devoice
commands:
<pragma-> cap group moderator can-voice can-devoice can-mode can-mode-m
<pragma-> cap list moderator
<PBot> Grouped capabilities for moderator: can-devoice (1 cap), can-voice (1 cap),
can-mode, can-mode-m
Then you can set this capability group on users with the userset
command.
To remove capabilities from a group or to delete a group, use the cap ungroup
command.
Usage: cap ungroup <existing capability group> <grouped capability>
When the last capability is removed from a group, the group itself will be deleted.
To give capabilities to a user, use the useradd
or the userset
commands.
<pragma-> useradd alice global alice!*@* moderator
or
<pragma-> userset alice moderator 1
To see what capabilities a user account has, use the cap userhas
command.
Usage: cap userhas <user> [capability]
If the [capability]
argument is omitted, the command will list all capability
groups and capabilities the user account has.
If the [capability]
argument is provided, the command will determine if the
capability is granted to the user account.
<pragma-> cap userhas alice
<PBot> User alice has capabilities: moderator (4 caps)
<pragma-> cap userhas alice can-voice
<PBot> Yes. User alice has capability can-voice.
<pragma-> cap userhas alice can-op
<PBot> No. User alice does not have capability can-op.
To list all the users that have a capability, use the cap whohas
command.
Usage: cap whohas <capability>
<pragma-> cap whohas moderator
<PBot> Users with capability moderator: alice
<pragma-> cap whohas can-voice
<PBot> Users with capability can-voice: alice
This is a list of built-in capability groups and capabilities. You can create
new custom capability groups with the cap group
command.
Please note that PBot is sometimes updated more frequently than this list is updated. To see the most
current list of capabilities, use the cap list
command or see the
data/capabilities
file.
Name | Description | Belongs to group |
---|---|---|
botowner |
The most powerful capability group. Contains all capabilities. | none |
admin |
The admin capability group. Contains the basic administrative capabilities. | botowner |
chanop |
Channel operator capability group. Contains the basic channel management capabilities. | botowner, admin |
chanmod |
Channel moderator capability group. Grants can-voice , can-devoice and the use of the mod command without being voiced. |
botowner |
can-<command name> |
If a command <command name> has the cap-required command metadata then the user's account must have the can-<command name> capability to invoke it. For example, the op command requires users to have the can-op capability. |
botowner, various groups |
can-mode-<flag> |
Allows the mode command to set mode <flag> . For example, to allow a user to set mode +m give them the can-mode and can-mode-m capabilities. <flag> is one mode character. |
botowner, can-mode-any |
can-mode-any |
Allows the mode command to set any mode flag. |
botowner |
can-modify-admins |
Allows the user to modify user accounts that have the admin capability |
botowner |
can-modify-capabilities |
Allows the user to use the useradd or userset commands to add or remove capabilities from users. |
botowner |
can-group-capabilities |
Allows the user to use the cap group and cap ungroup commands to modify capability groups. |
botowner |
can-clear-bans |
Allows the user to use unban * to clear a channel's bans. |
botowner, admin |
can-clear-mutes |
Allows the user to use unmute * to clear a channel's mutes. |
botowner, admin |
can-kick-wildcard |
Allows the user to use wildcards with the kick command. |
botowner, admin |
can-op-wildcard |
Allows the user to use wildcards with the op command. |
botowner, admin |
can-voice-wildcard |
Allows the user to use wildcards with the voice command. |
botowner, admin, chanop, chanmod |
is-whitelisted |
The user is exempt from anti-flood, ban-evasion checks, wild-card kicking, etc. | botowner, admin, chanop |
To temporarily join a channel, use the join
command. The channels may be a comma-
separated list.
Usage: join <channel(s)>
To temporarily leave a channel (that is, without removing it from PBot's list
of channels), use the part
command. The channels may be a comma-separated
list.
Usage part <channel(s)>
chanadd
permanently adds a channel to PBot's list of channels to auto-join and manage.
Usage: chanadd <channel>
chanrem
removes a channel from PBot's list of channels to auto-join and manage.
Usage: chanrem <channel>
chanset
sets a channel's metadata. See channel metadata list
Usage: chanset <channel> [key [value]]
If both key
and value
are omitted, chanset will show all the keys and values for that channel. If only value
is omitted, chanset will show the value for that key.
chanunset
deletes a channel's metadata key.
Usage: chanunset <channel> <key>
chanlist
lists all added channels and their metadata keys and values.
Name | Description |
---|---|
enabled |
When set to a true value, PBot will auto-join this channel after identifying to NickServ (unless general.autojoin_wait_for_nickserv is 0 , in which case auto-join happens immediately). |
chanop |
When set to a true value, PBot will perform channel management (anti-flooding, ban-evasion, etc). |
permop |
When set to a true value, PBot will automatically op itself when joining and remain opped instead of automatically opping and deopping as necessary. |
Ignore a user. If you omit [channel]
PBot will ignore the user in all channels, including private messages.
Usage: ignore <hostmask regex> [channel [timeout]]
Timeout can be specified as an relative time in English; for instance, 5 minutes
, 1 month and 2 weeks
, next thursday
, friday after next
, forever
and such.
Unignores a user. If you omit [channel]
PBot will unignore the user from all channels, including private messages.
Usage: unignore <hostmask regex> [channel]
Blacklists a hostmask regex from joining a channel.
Usages:
blacklist <show/list>
blacklist add <hostmask regex> [channel]
blacklist remove <hostmask regex> [channel]
The nicklist
command displays information about entries in PBot's internal nicklist.
Usage: nicklist (<channel [nick]> | <nick>) [-sort <by>] [-hostmask] [-join]
Option | Description |
---|---|
-sort <by> |
sorts results by <by> |
-hostmask |
shows full hostmasks instead of nicks |
-join |
include join timestamps |
Sort method | Description |
---|---|
host | Sort by host portion of hostmask |
join | Sort by channel join timestamp |
nick | Sort by nick |
spoken | Sort by last spoken timestamp |
Examples:
<pragma-> nicklist #c
<PBot> 701 nicks in #c: pragma-: last spoken 1h ago, etc...
<pragma-> nicklist #c pragma-
<PBot> Nicklist information for pragma-!~chaos@user/pragmatic-chaos in #c: last spoken 1h ago, etc...
The banlist
command displays information about entries in PBot's internal banlist. PBot's internal banlist
remembers the original setters and timestamps of ban entries when the IRC server forgets them. PBot's internal
banlist can store extra metadata such as ban-reasons, ban-timeouts, etc.
Usage: banlist <channel>
Example:
<pragma-> banlist #c
<PBot> Ban list for #c: 1 ban: loser!*@* on Tue Aug 31 06:41:24 2021 PDT (14d15h ago) by candide!~pbot3@about/c/bot/candide for chat-flooding (2h remaining); 0 mutes.
The op
, deop
, voice
and devoice
commands all perform their respective named action.
The targets
parameter can be a list of multiple nicks, optionally containing
wildcards. If targets
is omitted, the action will be performed on the caller.
Usages:
In channel:
op [targets]
deop [targets]
voice [targets]
devoice [targets]
From private message:
op <channel> [targets]
deop <channel> [targets]
voice <channel> [targets]
devoice <channel> [targets]
Sets or unsets channel or user modes.
Usage: mode [channel] <flags> [targets]
PBot extends the IRC MODE
command in useful ways. For instance, the targets
parameter may contain wildcards. To op everybody whose nick ends with |dev
you
can do !mode +o *|dev
in a channel.
Bans or mutes a user. If the argument is a nick instead of a hostmask, it will determine an appropriate banmask for that nick. The argument can be a comma-separated list of multiple nicks or masks.
Usage: ban/mute <nick/hostmask,...> [timeout (default: 24h) [reason]] [-c <channel>] [-t <timeout>] [-r <reason>]
If timeout
is omitted, PBot will ban the user for 24 hours. Timeout can be specified as an relative time in English; for instance, 5 minutes
, 1 month and 2 weeks
, next thursday
, friday after next
, forever
and such.
If a ban already exists, you may update the timeout or reason at any time.
Examples:
<pragma-> ban bob 10m being a jerk
<PBot> *!*@user/bob banned in #channel (10 minutes) because being a jerk
<pragma-> mute joe -r "not very nice"
<PBot> *!*@user/joe muted in #channel (1 day) because not very nice
Unbans or unmutes a user. If the argument is a nick instead of a hostmask, it will find all bans that match any of that nick's hostmasks or NickServ accounts and unban them.
The argument can be a comma-separated list of multiple nicks or masks. If the argument is *
then all bans/mutes for the channel will be removed.
Usage: unban/unmute <nick/hostmask,...> [channel]
The checkban
command displays information about an entry in PBot's internal banlist. PBot's internal banlist
remembers the original setters and timestamps of ban entries when the IRC server forgets them. PBot's internal
banlist can store extra metadata such as ban-reasons, ban-timeouts, etc.
Usage: checkban <mask> [channel]
If the [channel]
option is omitted, the channel in which the command is invoked will be used.
Example:
<pragma-> checkban loser!*@*
<PBot> loser!*@* banned in #c on Tue Aug 31 06:41:24 2021 PDT (14d15h ago) by candide!~pbot3@about/c/bot/candide because chat-flooding (2h remaining)
The checkmute
command is identical to the checkban
command, except for mutes instead of bans.
Usage: checkmute [channel]
Invites a user to a channel.
Usage: invite [channel] <nick>
Removes a user from the channel. <nick>
can be a comma-separated list of multiple users, optionally containing wildcards. If [reason]
is omitted, a random insult will be used.
Usage from channel: kick <nick,...> [reason]
From private message: kick <channel> <nick,...> [reason]
Note that applets are "reloaded" each time they are executed. There is no need to refresh
after editing an applet.
This command loads an applet as a PBot command. It is equivalent to factadd
ing a new keyword and then setting
its type
to applet
.
Usage: load <keyword> <applet>
For example, to load applets/qalc.sh
as the qalc
command:
<pragma-> !load qalc qalc.sh
This command unloads an applet. It is equivalent to deleting the factoid keyword the applet was loaded as.
Usage: unload <keyword>
To list the loaded applets, use the list applets
command. This is not an admin command, but
it is included here for completeness.
Usage: list applets
Loads a plugin into PBot.
Usage: plug <plugin>
Unloads a plugin from PBot.
Usage: unplug <plugin>
Reloads a plugin into PBot. The plugin is first unloaded and then it is loaded again.
Usage: replug <plugin>
Lists all currently loaded plugins. This isn't an admin command, but it is included here for completeness.
Usage: pluglist
<pragma-> !pluglist
<PBot> Loaded plugins: ActionTrigger, AntiAway, AntiKickAutoRejoin, AntiNickSpam,
AntiRepeat, AntiTwitter, AutoRejoin, Battleship, Connect4, Counter, Date,
GoogleSearch, Quotegrabs, RemindMe, RestrictedMod, Spinach, TypoSub, UrlTitles,
Weather, Wolfram, Wttr
Use cmdset
to set various metadata for built-in commands.
Usage: cmdset <command> [key [value]]
Omit <key>
and <value>
to list all the keys and values for a command. Specify <key>
, but omit <value>
to see the value for a specific key.
Use cmdunset
to delete various metadata from built-in commands.
Usage: cmdunset <command> <key>
Name | Description |
---|---|
help |
The text to display for the help command. |
cap-required |
When set to a true value then the command requires that users have the can-<command name> capability before they can invoke it. |
dont-replace-pronouns |
When set to a true value then pronouns such as "my", "me", "your", etc, will not be intuitively replaced with nicks and such. |
background-process |
When set to a true value then this command will be executed as a background process. Use this for commands that can potentially take a long time to complete. |
condense-whitespace |
When set to a true value, collapse ajdacent whitespace characters in command output. |
process-timeout |
The timeout, in seconds, before the process is automatically killed. If not set then the processmanager.default_timeout registry value will be used. |
PBot uses an event queue to schedule future tasks or commands. The eventqueue
command can
be used to list or remove upcoming events. It can also be used to schedule a command.
Usage: eventqueue list [filter regex] | add <relative time> <command> [-repeat] | remove <event>
For example, to schedule a command to run 1 hour from now:
<pragma-> eventqueue add "1 hour" echo Ta-da!
<PBot> Command added to event queue.
<pragma-> eventqueue list
<PBot> Queued events: 1) in 1h: command #channel echo Ta-da!
... 1 hour later ...
<PBot> Ta-da!
The remove
command's <event>
argument can include wildcards. For example,
to remove all command
events:
<pragma-> eventqueue remove command *
<PBot> Removed 1 event.
Or to remove all command
events in #channel
:
<pragma-> eventqueue remove command #channel *
Lists all currently running background processes.
Usage: Usage: ps [-atu]
Option | Description |
---|---|
-a |
show all information |
-t |
show running time |
-u |
show user and channel |
Sends the interrupt signal to selected running background processes.
Usage: Usage: kill [-a] [-t <seconds>] [-s <signal>] [pids...]
Option | Description |
---|---|
-a |
kill all processes |
-t <seconds> |
kill processes running longer than <seconds> |
-s <signal> |
send <signal> to processes instead of interrupt signal |
pids... |
space-delimited list of PIDs to kill |
If neither options -a
or -t
are provided then the pids...
option is required.
PBot's message history uses an advanced user tracking algorithm in order to ensure that messages are being stored in the right message history accounts. This is also used for detecting ban-evasions and looking up also-known-as aliases.
Note that "message history account" and "PBot user account" are distinct accounts.
The recall
command queries the message history and displays matching results.
Usage: recall [nick [history [channel]]] [-c <channel>] [-t <text>] [-b <context before>] [-a <context after>] [-x <filter to nick>] [-n <count>] [-r raw mode] [+ ...]
You can chain multiple recalls together with the +
operator.
Option | Description |
---|---|
-c <channel> |
Filter to messages only in <channel> |
-t <text> |
Filter to messages containing <text> |
-b <context before> |
Show <context before> (integral) count messages appearing immediately before matching messages |
-a <context after> |
Show <context after> (integral) count messages appearing immediately after matching messages |
-x <filter to nick> |
Filter messages to only those spoken by <filter to nick> |
-n <count> |
Limit results to <count> (integral); implies -x |
-r |
Show only the message without any nickname or timestamp prefixes |
Examples:
<pragma-> hello
<garp> hi there
<john> hey
<pragma-> PBot: recall garp
<PBot> [20s ago] <garp> hi there
<pragma> PBot: recall garp -b1 -a1
<PBot> [35s ago] <pragma-> hello [20s ago] <garp> hi there [10s ago] <john> hey
<pragma> PBot: recall -t hey
<PBot> [10s ago] <john> hey
The id
command lists various user-tracking and user-account metadata about a user hostmask.
Usage: id [nickname | hostmask | message account id]
If no argument is provided, your own id information will be shown. The hostmask
form accepts wildcards.
The message account id
form is an integer.
Examples:
<pragma-> id
<PBot> pragma- (pragma-!~chaos@user/pragmatic-chaos): user id: 2; user account: pragma- (logged in); NickServ: pragma-
<pragma-> id pragma-
<PBot> pragma- (pragma-!~chaos@user/pragmatic-chaos): user id: 2; user account: pragma- (logged in); NickServ: pragma-
<pragma-> id 2
<PBot> 2 (pragma-!~chaos@user/pragmatic-chaos): user id: 2; user account: pragma- (logged in); NickServ: pragma-
<pragma-> id *!*@*/pragmatic-chaos
<PBot> *!*@*/pragmatic-chaos (pragma-!~chaos@user/pragmatic-chaos): user id: 2; user account: pragma- (logged in); NickServ: pragma-
<pragma-> id *!*@user/*
<PBot> Multiple accounts found: PBot!pbot3@user/pbot (1), pragma-!~chaos@user/pragmatic-chaos (2), ...
The aka
command lists all known aliases for a given message history account.
Usage: aka [-hilngrw] <nick> [-sort <by>]
Option | Description |
---|---|
-h |
show hostmasks |
-i |
show ids |
-l |
show last seen timestamps |
-n |
show nickserv accounts |
-g |
show gecos |
-r |
show relationships |
-w |
include weak links |
Sort by | Description |
---|---|
gecos |
GECOS field |
host |
host portion of hostmask |
hostmask |
hostmask |
id |
account id |
nick |
nick portion of hostmask |
nickserv |
NickServ account |
seen |
last seen timestamp |
user |
user portion of hostmask |
Examples:
<pragma-> aka bob
<PBot> bob also known as: bob, bobby, robert
<pragma-> aka -hl bob
<PBot> bob also known as: bob!~bob@user/bob (seen 5m ago), bobby!~bob@user/bob (seen 6d ago), robert!~bob@127.0.0.1 (seen 20d ago)
PBot's message history uses an advanced user-tracking algorithm in order to ensure that messages are being stored in the right message history accounts. This is also used for detecting ban-evasions and looking up also-known-as aliases.
But sometimes users connect from wholly distinct accounts with no obviously linkable metadata.
If you know for certain that they are the same individual, you can use the akalink
command
to manually link two message history accounts together.
Usage: akalink <target id> <alias id> [type]
The optional type
argument can be 0
(weak) or 1
(strong). Defaults to 1
.
Use the id
command to look up message history account ids for a given hostmask.
The akaunlink
command manually unlinks two message history accounts from each other.
Usage: akaunlink <target id> <alias id>
Use the -r
option with the aka
command to see the target -> alias
relationship.
The akadelete
command deletes message history account metadata or entire message history accounts.
Usage: akadelete [-hn] <account id or hostmask>
Option | Description |
---|---|
-h |
delete only hostmask |
-n |
delete only nickserv accounts |
If neither options -h
or -n
are given, then the entire message history account will be deleted.
These are some of the miscellaneous admin commands that have not been covered above or in the rest of the PBot documentation.
Exports specified list to HTML file in $data_dir
.
Usage: export <factoids|quotegrabs>
Refreshes/reloads PBot core modules and plugins (not the command-line applets since those are executed/loaded each time they are invoked).
For example, suppose you edit some PBot source file, be it a core file such as PBot/Factoids.pm or
a Plugin such as Plugins/Wttr.pm. Rather than shut the bot down and restart it, you can simply use
the refresh
command to reload all modified PBot core files and Plugins.
Reloads a data or configuration file from $data_dir
. This is useful if you
manually edit a data or configuration file and you want PBot to know about the
modifications.
Usage reload <admins|bantimeouts|blacklist|channels|factoids|funcs|ignores|mutetimeouts|registry>
Sends a raw IRC command to the server. Use the sl
command when
PBot does not have a built-in command to do what you need.
Usage: sl <irc command>
<pragma-> sl PRIVMSG #channel :Test message
<PBot> Test message
Tells PBot to disconnect and exit.