|
|
|
|
# Lorebot
|
|
|
|
|
This is the bot running over at the sampled slack.
|
|
|
|
|
|
|
|
|
|
## Commands
|
|
|
|
|
### 2 parameters
|
|
|
|
|
* `lore`: get a specific lore
|
|
|
|
|
* `rip`: rest in piece a target
|
|
|
|
|
* `summon`: summon the specified target
|
|
|
|
|
* `gnu`: educate the target on freedoms
|
|
|
|
|
* `newdubs`: add a new dubs image
|
|
|
|
|
* `rmdubs`: remove an existing dubs image
|
|
|
|
|
* `created`: lookup when lore was created (some old lore wont have this field)
|
|
|
|
|
* `owner`: lookup who created a lore (some old lore wont have this field)
|
|
|
|
|
* `removedby`: lookup who removed a lore
|
|
|
|
|
* `removed`: lookup when lore was removed
|
|
|
|
|
|
|
|
|
|
### 1 parameter
|
|
|
|
|
* `help`: display help message 1
|
|
|
|
|
* `help2`: display help message 2
|
|
|
|
|
* `rng`: display random lore with the new rng algorithm
|
|
|
|
|
* `depricatedrng`: select random lore with the old rng algorithm
|
|
|
|
|
* `roll`: generate a random 8 digit integer
|
|
|
|
|
* `d20`: roll a 20 sided die
|
|
|
|
|
* `rr`: play russian roulette
|
|
|
|
|
* `dice`: roll a 6 sided die
|
|
|
|
|
* `dubs`: pick a random 'dubs checkum' image and roll
|
|
|
|
|
* `listen`: its what you hearin
|
|
|
|
|
* `lorelist`: generate a list of all lore
|
|
|
|
|
* `removedlore`: generate a list of removed lore
|
|
|
|
|
* `lorestatus`: display the number of active lore
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
This project makes use of the `make` command. The following commands are supported.
|
|
|
|
|
|
|
|
|
|
* `all`: dynamically compiles/builds the bot. outputs binary file to `bin/`
|
|
|
|
|
* `run`: runs the bot
|
|
|
|
|
* `stat`: statically compiles/builds the bot. outputs binary file to `bin/`
|
|
|
|
|
* `docker`: builds a docker image
|
|
|
|
|
* `aci`: builds an ACI image
|
|
|
|
|
* `test_docker`: tests the docker image
|
|
|
|
|
* `test_aci`: tests the ACI image
|
|
|
|
|
* `clean`: cleans the project directory of any temp files
|
|
|
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
This bot takes advantage of the gcfg configuration which follows the INI
|
|
|
|
|
syntax.
|
|
|
|
|
|
|
|
|
|
`config.gcfg`
|
|
|
|
|
```
|
|
|
|
|
[lorebot]
|
|
|
|
|
loglevel = "debug"
|
|
|
|
|
slackdebug = false
|
|
|
|
|
bootstrapdelay = 1
|
|
|
|
|
AuthFile = ".auth"
|
|
|
|
|
|
|
|
|
|
[redis]
|
|
|
|
|
host = "127.0.0.1:6379"
|
|
|
|
|
password = ""
|
|
|
|
|
```
|
|
|
|
|
* `loglevel`: loglevel for the app (debug/info/error)
|
|
|
|
|
* `slackdebug`: wheather or not to show slacks API debugging
|
|
|
|
|
* `bootstrapdeplay`: number in seconds to delay binding the bot to redis (useful in containers)
|
|
|
|
|
* `AuthFile`: name/location of file containing the slack key
|
|
|
|
|
* `host`: location of the redis server
|
|
|
|
|
* `password`: password of the redis server
|
|
|
|
|
|
|
|
|
|
`.auth`
|
|
|
|
|
```
|
|
|
|
|
xoxb-86456556-IJDJksfkejsjdfj
|
|
|
|
|
```
|
|
|
|
|
this is a key generated by slack for the bot
|
