forked from Raiza.dev/EliteBot
Updated README.md
This commit is contained in:
parent
c0f8606715
commit
f5c3c95565
1 changed files with 22 additions and 25 deletions
47
README.md
47
README.md
|
@ -1,36 +1,33 @@
|
|||
# IRC Bot
|
||||
|
||||
This is an IRC bot written in Python. It connects to an IRC server, authenticates using SASL if desired, and responds to various commands. It is also able to join and save channels that it is invited to.
|
||||
This is an IRC bot written in Python. It connects to an IRC server, authenticates using SASL if desired, and responds to various commands.
|
||||
|
||||
## Requirements
|
||||
## Installation.
|
||||
1. Clone the repository:
|
||||
```bash
|
||||
git clone https://github.com/ComputerTech312/EliteBot.git
|
||||
```
|
||||
|
||||
- Python 3
|
||||
- A configuration file `config.json` containing the following variables:
|
||||
- `BSERVER`: the IRC server to connect to
|
||||
- `BPORT`: the port to use for the connection (can be preceded with a `+` to specify a secure connection)
|
||||
- `BNICK`: the desired bot nickname
|
||||
- `BIDENT`: the bot's ident
|
||||
- `BNAME`: the bot's real name
|
||||
- `UseSASL`: a boolean indicating whether or not to use SASL authentication
|
||||
- `SANICK`: the bot's SASL account name (if using SASL)
|
||||
- `SAPASS`: the bot's SASL password (if using SASL)
|
||||
|
||||
## Usage
|
||||
2. CD into the directory:
|
||||
```bash
|
||||
cd EliteBot
|
||||
```
|
||||
|
||||
To run the bot, simply execute the script with `python3 elitebot.py config.json`. The bot will connect to the specified server and authenticate if necessary. It will then listen for commands and respond accordingly.
|
||||
3. Create a virtual envirionment.
|
||||
```bash
|
||||
python3 -m venv elitebot
|
||||
```
|
||||
|
||||
## Commands
|
||||
4. Activate the virtual environment:
|
||||
```bash
|
||||
source elitebot/bin/activate
|
||||
```
|
||||
|
||||
The following commands are recognized by the bot:
|
||||
5. Install the required packages.
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
- `&moo`: makes the bot moo.
|
||||
- `&join`: makes the bot join the specified channel.
|
||||
- `&part`: makes the bot part the current channel if a channel is not specified.
|
||||
- `&quit`: makes the bot quit.
|
||||
|
||||
## Saving Channels
|
||||
|
||||
The bot is able to save a list of channels that it should automatically join upon connecting to the server.
|
||||
|
||||
## Contributing
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue