A chatbot that does whatever I feel like implementing at the time.
Dashbot will listen for messages on all text channels it has access to and do some simple matching (usually a regex test) to figure out which Interaction
or Command
to run. Interactions and Commands are registered in the startup/registerAllComponents.ts file.
See the documentation in each Interaction to see what it does, however, some notable ones are
-
Rolls dice and flips coins, invoke with either
roll dX
(where X can be any whole number > 1 or < -1) or a few variants of the phraseflip coin
. -
There are a few of these that have different responses. Eg.
compliment
will cause DashBot to give you a random compliment.link
will post a random link to a picture of Link. This is the most simple type of Interaction, all responses need to be predefined, and it will pick one randomly. -
If you have an imgur ClientId set, this action will post an random image from the first 20 results of a Imgur search. Usage
!imgur cats
. -
This is one of 2 actions that deal with multiple messages and replies (see SessionStore). After invoking it with "I want to guess a number", it will prompt you to try to guess the number its thinking.
-
Allows you to create polls (much like other existing poll bots).
!poll "this is my question" yes no maybe "i don't know"
.
This project uses Yarn, information on how to install and use yarn can be found here;
-
Clone this repo somewhere!
-
Install the dependencies with yarn by running
yarn install
in the project root. -
Build the project with
yarn build
, you should now have adist
folder. -
Create a config file
dashbot.config.js
. The only required property isdiscordBotToken
/* eslint-disable @typescript-eslint/triple-slash-reference */ /// <reference path="src/DashBotConfig.d.ts" /> /** @type DashBotConfig */ const Config = { imgurClientId: '', servers: [ { type: 'discord', botToken: '', }, { type: 'minecraft', logClient: { type: 'tail', logFilePath: '/path/to/minecraft/logs/latest.log', }, rcon: { host: '127.0.0.1', port: 1234, password: 'example password', }, }, ], tls: { maintainerEmail: 'your.email@exmaple.com', packageAgent: 'dashbot/1.0.0', }, }; module.exports = Config;
This readme may get out of date, I suggest you check the type declaration for the most up to date specification.
To get a bot token, you need to go to the Discord Developers website. You need to create an Application, then go to the Bot page from the menu on the left and create a bot. From there you can get your bot token and put it in the config.
-
Add your bot to your server
So now you're almost set, but to actually test, you need to add your bot to a server, to do this you'll need to get the url below and add your client ID which you can find on your Discord Application page.
https://discordapp.com/api/oauth2/authorize?permissions=515136&scope=bot&client_id=YOUR_CLIENT_ID
Put your client id in there, and open it up. You'll get a page which will allow you to add your bot to any server you have admin control over.
-
Put the config file in the storage location (of your choice), for convenience i usually leave it in the project root.
-
Now you can run the program, in the root of the project run
node dist/main.js --storage "."
The storage flag tells dashbot where to load the config from, as well as where to store its statistics, and log files. By default it will be a directory named "storage".
-
If everything worked correctly, you can go have a look in discord, your bot should be online. Now say something like
roll d20
orjoke
to activate one of its responses.