Skip to content

Commit f8fe4f7

Browse files
committed
Commit README
1 parent 61e48f3 commit f8fe4f7

1 file changed

Lines changed: 47 additions & 0 deletions

File tree

README.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Extendable Discord Bot
2+
####An extendable bot for your Discord Server
3+
4+
[![NPM](https://nodei.co/npm/extendable-discord-bot.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/extendable-discord-bot/)
5+
6+
[![Join the chat at https://gitter.im/Wolvan/ExtendableDiscordBot](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Wolvan/ExtendableDiscordBot?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![npm version](https://badge.fury.io/js/extendable-discord-bot.svg)](https://badge.fury.io/js/extendable-discord-bot)
7+
8+
## Introduction
9+
This is an extendable bot for Discord chats. By itself it does nothing, that's where Plugins come in handy. Drop plugin files into the `/plugins` directory, load them from the bot console (or by restarting completely) and enjoy it's functionality.
10+
11+
## Features
12+
* Lightweight: Being a NodeJS app makes it easily deployable everywhere! Even on low power servers
13+
* Console commands allow you to administrate the bot easily
14+
* Plugin API: The bot doesn't really do anything by itself, you install Plugins for functionality. The following plugins come pre-installed:
15+
* `roll_dice.dbot.js` A dice rolling script that allows to roll any number of dice
16+
* `message_output.dbot.js` Print messages from chat to your output
17+
* `request_q.dbot.js` A queue plugin for requests or commissions
18+
19+
## Install the bot
20+
### from npm (globally)
21+
1. Install NodeJS with npm
22+
2. Use `npm install -g extendable-discord-bot` from a command prompt or terminal
23+
3. Install Plugins
24+
4. Run it with `discord-bot [-e|-p|-t|--help]`
25+
5. Use the `help` command for a list of commands when the bot is running
26+
27+
### from GitHub (locally)
28+
1. Install NodeJS with npm
29+
2. Clone this repository or download the source as .zip file
30+
3. Open a command prompt or terminal and navigate to the folder you cloned the repository to
31+
4. Run `npm install` from a command prompt or terminal
32+
5. Install Plugins
33+
6. Run the bot with `node app.js [-e|-p|-t|--help]`
34+
7. Use the `help` command for a list of commands when the bot is running
35+
36+
## Install plugins
37+
Plugin installation is easy! Download the file with the extension `.dbot.js` and put it in the `/plugins` directory of the bot. Load it by typing `plugins enable <filename>` or by restarting the bot.
38+
39+
##For Developers
40+
Want to write your own Plugin for the bot? That's great!
41+
Easiest is to check existing plugins on how they are written, but you can also check the Wiki of this repository, it should give all the information you should need. I'll also provide a plugin template which you can use.
42+
Make sure that your plugin has the file extension `.dbot.js`.
43+
Plugin Pull Requests are welcome of course.
44+
45+
Wanna work on the bot itself? Go ahead and fork the repository, make your changes and open a Pull Request back into here!
46+
47+
Got any other questions? [Join the Gitter Channel of the bot](https://gitter.im/Wolvan/ExtendableDiscordBot), I should be available there most of the time.

0 commit comments

Comments
 (0)