pbot/doc/README.md

PBot Documentation

Table of Contents

• QuickStart
  • Installation
    • Docker
    • Installing Perl
    • Installing PBot
      • git (recommended)
      • Download zip archive
  • Initial Setup
    • Installing CPAN modules
      • Installing cpanminus
      • Installing and using local::lib
      • Using cpanminus
      • re::engine::RE2
    • Clone data-directory
    • Configuration
      • Recommended settings for IRC Networks
  • Starting PBot
    • Usage
      • rlwrap
      • Overriding directories
      • Overriding registry
    • First-time start-up
      • Using default settings
      • Using custom settings
    • Regular start-up
  • Additional configuration
    • Creating your bot owner admin account
    • Adding other users and admins
    • Adding channels
  • Further Reading
    • Commands
    • Factoids
    • Plugins
    • Applets
• Plugins
  • About
  • Plang
  • Quotegrabs
• Commands
  • Command interpreter
    • Command invocation
    • Addressing output to users
    • Inline invocation
    • Chaining
    • Piping
    • Substitution
    • Nesting Pipes and Substitutions
    • Variables
    • Selectors
    • Background processing
  • Types of commands
    • Built-in commands
      • Listing all built-in commands
      • Creating new built-in commands
      • Plugins
      • Functions
    • Factoids
      • Code Factoids
      • Applets
  • Commands documented here
    • version
    • help
    • uptime
    • my
    • date
    • weather
  • Commands documented elsewhere
    • Administrative
      • Logging in and out of PBot
      • User-management
      • Channel-management
      • Applet-management
      • Plugin-management
      • Command metadata
      • Event-queue management
      • Process-management
      • Registry
      • Message-history/user-tracking
      • Miscellaneous admin commands
    • Factoid commands
      • Adding/removing factoids
      • Displaying factoids
      • Editing factoids
      • Factoid metadata
      • Information about factoids
• Administrative
  • Logging in and out
    • login
    • logout
  • User-management
    • useradd
    • userdel
    • userset
    • userunset
      • User metadata list
    • Listing users
  • User capabilities
    • Introduction
    • cap
      • Listing capabilities
      • Grouping capabilities
      • Giving capabilities to users
      • Checking user capabilities
      • Listing users who have a capability
      • User capabilities list
  • Channel management
    • join
    • part
    • chanadd
    • chanrem
    • chanset
    • chanunset
    • chanlist
      • Channel metadata list
    • ignore
    • unignore
    • blacklist
    • nicklist
    • banlist
    • op
    • deop
    • voice
    • devoice
    • mode
    • ban/mute
    • unban/unmute
    • checkban
    • checkmute
    • invite
    • kick
  • Applet-management
    • load
    • unload
    • Listing applets
  • Plugin-management
    • plug
    • unplug
    • replug
    • pluglist
  • Command metadata
    • cmdset
    • cmdunset
    • Command metadata list
  • Event-queue management
    • eventqueue
  • Process-management
    • ps
    • kill
  • Message-history/user-tracking
    • recall
    • id
    • aka
    • akalink
    • akaunlink
    • akadelete
  • Miscellaneous
    • export
    • refresh
    • reload
    • sl
    • die
• Factoids
  • About
  • Special commands
    • /say
    • /me
    • /call
    • /msg
    • /code
      • Supported languages
      • Special variables
      • testargs example
      • Setting a usage message
      • poll/vote example
      • SpongeBob Mock meme example
      • Using command-piping
      • Improving SpongeBob Mock meme
      • Formatting and editing lengthy Code Factoids
  • Special variables
    • $args
    • $arg[n]
    • $arg[n:m]
    • $arglen
    • $channel
    • $nick
    • $randomnick
    • $0
  • List variables
    • Expansion modifiers
  • Default values for variables and arguments
  • action_with_args
  • add_nick
  • Channel namespaces
  • Adding/removing factoids
    • factadd
    • factrem
    • forget
    • factalias
  • Displaying factoids
    • fact
    • factshow
  • Editing factoids
    • factchange
    • factmove
    • factundo
    • factredo
  • Factoid metadata
    • factset
    • factunset
    • Factoid metadata List
  • Information about factoids
    • factfind
    • factinfo
    • factlog
    • factset
    • count
    • histogram
    • top50
• Registry
  • About
    • Types of values
    • Creating array values
    • Overriding Registry values per-channel
  • Overriding Registry values via command-line
  • Registry commands
    • regset
    • regunset
    • regchange
    • regshow
    • regfind
    • regsetmeta
    • regunsetmeta
  • Editing Registry file
  • Metadata list
  • List of known Registry items
    • Channel-specific Registry items
• Applets
  • About
  • Creating applets
  • Documentation for built-in applets
    • cc
      • Usage
      • Supported Languages
      • Default Language
      • Disallowed system calls
      • Program termination with no output
      • Abnormal program termination
      • C and C++ Functionality
      • Using the preprocessor
      • main() Function Unnecessary
      • Embedding Newlines
      • Printing in binary/base2
      • Using the GDB debugger
      • Interactive Editing
      • Some Examples
    • english
    • expand
    • prec
    • paren
    • faq
    • cfact
    • cjeopardy
      • hint
      • what
      • w
      • filter
      • score
      • rank
      • reset
      • qstats
      • qshow
    • c99
    • c11
    • c23
    • man
    • google
    • define
    • dict
    • foldoc
    • vera
    • udict
    • wdict
    • acronym
    • math
    • calc
    • qalc
    • compliment
    • insult
    • excuse
    • horoscope
    • quote
• Anti-Abuse
  • Flood control
    • Message flood
    • Join flood
    • Enter key abuse
    • Nick flood
  • Anti-away/Nick-control
  • Anti-auto-rejoin control
  • Opping/Deopping
  • Setting up automatic join-flood enforcement
• Virtual Machine
  • Installation methods
    • libvirt and QEMU
    • Vagrant
  • Host vs guest
  • Environment variables
• Initial virtual machine set-up
  • Prerequisites
    • CPU Virtualization Technology
    • KVM
    • libvirt and QEMU
    • Make a pbot-vm user or directory
    • Add libvirt group to your user
    • Download Linux ISO
  • Create a new virtual machine
    • libvirt
    • QEMU
    • Install Linux in the virtual machine
    • Set up serial ports
      • libvirt
      • QEMU
    • Set up virtio-vsock
      • libvirt
      • QEMU
    • Reboot virtual machine
    • Install PBot VM Guest
    • Install software
    • Start PBot VM Guest
    • Test PBot VM Guest
    • Save initial state
  • Install host packages
  • Initial virtual machine set-up complete
• Start PBot VM Host
  • Test PBot
  • Starting PBot VM again
  • Adding additional VMs
  • QEMU command from libvirt
• Frequently Asked Questions
  • When I type !version it say “new version available”?
  • How do I change the bot trigger?
  • How do I whitelist a user?
  • How do I change how the bot outputs multi-line messages?
  • How can I remove excessive spaces and tabs from command output?
  • How do I change my password?
  • How do I make PBot remember my date timezone?
  • How do I make PBot remember my weather location?
  • How do I set up automatic join-flood enforcement?