Administrative -------------- * [Logging in and out](#logging-in-and-out) * [login](#login) * [logout](#logout) * [Admin management commands](#admin-management-commands) * [adminadd](#adminadd) * [adminrem](#adminrem) * [Admin levels](#admin-levels) * [adminset](#adminset) * [adminunset](#adminunset) * [Admin metadata list](#admin-metadata-list) * [Channel management commands](#channel-management-commands) * [join](#join) * [part](#part) * [chanadd](#chanadd) * [chanrem](#chanrem) * [chanset](#chanset) * [chanunset](#chanunset) * [chanlist](#chanlist) * [Channel metadata list](#channel-metadata-list) * [ignore](#ignore) * [unignore](#unignore) * [whitelist](#whitelist) * [blacklist](#blacklist) * [mode](#mode) * [ban/mute](#banmute) * [unban/unmute](#unbanunmute) * [kick](#kick) * [Miscellaneous commands](#miscellaneous-commands) * [export](#export) * [refresh](#refresh) * [reload](#reload) * [sl](#sl) * [die](#die) ### Logging in and out You cannot use any of the admin commands unless you login first. Note that login requires that your hostmask matches PBot's records. However, if your admin account have the `loggedin` and `stayloggedin` metadata set to a true value then you will not need to login. #### login Logs into PBot. Usage: `login [channel] ` #### logout Logs out of PBot. Usage: `logout` ### Admin management commands #### adminadd Adds a new admin to PBot. Usage: `adminadd ` Parameter | Description --- | --- `` | A unique name to identify this account (usually the `nick` of the admin, but can be any identifier). `` | Which channel the admin can administrate; use `global` for all channels. This field cannot be changed without removing and re-adding the admin. `` | What hostmask the admin is recognized/allowed to login from (e.g., `somenick!*@*somedomain.com` or `*@unaffiliated/someuser`). This field cannot be changed without removing and re-adding the admin. `` | An integer representing their level of privileges. See [admin-levels](#admin-levels). `` | the password the admin will use to login (from /msg!). A password is not required if the `stayloggedin` and `loggedin` metadata are set for the admin; however, a dummy password still needs to be set. #### adminrem Removes an admin from PBot. You can use the name field or the hostmask field that was set via `adminadd`. Usage: `adminrem ` ##### Admin levels This is a list of admin commands allowed by each admin level. Higher level admins have access to all lower level admin commands. Level | Commands --- | --- 10 | whitelist, blacklist, chanlist, ban, unban, mute, unmute, kick, ignore, unignore 40 | chanset, chanunset, chanadd, chanrem, join, part 60 | adminadd, adminrem, adminset, adminunset, akalink, akaunlink, regadd, regrem, regset, regunset, regchange 90 | sl, load, unload, reload, export, rebuildaliases, refresh, die #### adminset Sets metadata for an admin account. You can use the `name` field or the `hostmask` field that was set via `adminadd`. See also: [admin metadata list](#admin-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: `adminset [ [value]]` #### adminunset Deletes a metadata key from an admin account. You can use the name `field` or the `hostmask` field that was set via adminadd. Usage: `adminunset ` ##### Admin metadata list This is a list of recognized metadata keys for admin accounts. Name | Description --- | --- `name` | A unique name identifying this admin account. `level` | The privilege level of the admin. See [admin levels](#admin-levels). `password` | The password for this admin account. `loggedin` | Whether the admin is logged in or not. `stayloggedin` | Do not log the admin out when they part/quit. ### Channel management commands #### join To temporarily join a channel, use the `join` command. The channels may be a comma- separated list. Usage: `join ` #### part 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 ` #### chanadd `chanadd` permanently adds a channel to PBot's list of channels to auto-join and manage. Usage: `chanadd ` #### chanrem `chanrem` removes a channel from PBot's list of channels to auto-join and manage. Usage: `chanrem ` #### chanset `chanset` sets a channel's metadata. See [channel metadata list](#channel-metadata-list) Usage: `chanset [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 `chanunset` deletes a channel's metadata key. Usage: `chanunset ` #### chanlist `chanlist` lists all added channels and their metadata keys and values. ##### Channel metadata list 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 Ignore a user. If you omit `[channel]` PBot will ignore the user in all channels, including private messages. Usage: `ignore [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`, and so on. #### unignore Unignores a user. If you omit `[channel]` PBot will unignore the user from all channels, including private messages. Usage: `unignore [channel]` #### whitelist Whitelists a hostmask regex to be exempt from ban evasions or anti-flood enforcement. Usages: - `whitelist ` - `whitelist add ` - `whitelist remove ` #### blacklist Blacklists a hostmask regex from joining a channel. Usages: - `blacklist ` - `blacklist add [channel]` - `blacklist remove [channel]` #### mode Sets or unsets channel or user modes. Usage: `mode ` PBot extends the IRC `MODE` command in useful ways. For instance, the `` parameter can contain wildcards. To op everybody whose nick ends with `|dev`, for instance, you can do `!mode +o *|dev`. #### ban/mute 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. Usages: - `ban [channel [timeout]]` - `mute [channel [timeout]]` 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`, and so on. #### unban/unmute 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. Usages: - `unban [channel]` - `unmute [channel]` #### kick Removes a user from the channel. `` 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 [reason]` From private message: `kick [reason]` ### Miscellaneous commands These are some of the miscellaneous admin commands that have not been covered above or in the rest of the PBot documentation. #### export Exports specified list to HTML file in `$data_dir`. Usage: `export ` #### refresh Refreshes/reloads PBot core modules and plugins (not the command-line modules since those are executed/loaded each time they are invoked). #### reload 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 ` #### sl Sends a raw IRC line to the server. This is useful if you want to execute any IRC command on the IRC server, in its raw pure form. Use the `sl` command when PBot does not have a built-in command to do what you need. Usage: `sl ` sl PRIVMSG #channel :Test message Test message #### die Tells PBot to disconnect and exit.