Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
InsanusMokrassar committed May 8, 2023
1 parent 9c12c92 commit bd24722
Showing 1 changed file with 24 additions and 30 deletions.
54 changes: 24 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,24 @@
# PlaguBot Bot Template

1. Update your dependencies [here](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/build.gradle#L27-L30). Usually in gradle projects/readmes developers define names of
their dependencies
2. Edit [config](config.json). The main points
([full list of parameters with explanation](https://github.com/InsanusMokrassar/PlaguBot/blob/master/template.config.json):
* Change [database](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#L2-L4) section
* Change [bot token](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#L5)
* Change [list of plugins](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#L6-L11):
* Field `type` - it is name of the plugin provided by developer/dependency
* Other fields are parameters of plugin and must be provided directly
* Example is available in the [example section](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#L6-L11): here `Hello` is name of plugin and
`parameter` is its configuration parameter
* Change [params](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#L12-L17):
* Any key here will be available in plugins as name of param
* Any value must contains:
* `type` to detect which one object to instantiate
* Other type parameters
* You may look into example related to database in
[config](https://github.com/InsanusMokrassar/PlaguBotBotTemplate/blob/master/config.json#13): `defaultDatabase`
is easily available in plugins as `params.database` extension

## How to launch

There are two main ways to launch it:

* Run `./gradlew build && ./gradlew run --args="PATH_TO_YOUR_CONFIG"` with replacing of `PATH_TO_YOUR_CONFIG`
* Run `./gradlew build` and get [zip of bot](build/distributions/bot.zip) and unarchive it somewhere you need. In this
archive there is an executable files `bot.bat` (for windows) and `bot` (for linux) by the path inside of archive
`/bot/bin`. After unarchiving you can just launch executable file with one argument: path to the config
# PlaguBotExample

This repository contains the sample of Telegram Bot based on [PlaguBot](https://github.com/InsanusMokrassar/PlaguBot).

## What can this bot do?

In case you will use [config.json](./config.json) as base config for your bot, you will get:

* Captcha
* Bans
* Welcome

In one bot.

## How does it work?

In [config.json](./config.json) you may see `plugins` section: it is the list of plugins you will include in your bot.
Besides, there are several other sections:

* `botToken` - the bot token
* `flushUpdates` - if this option set to `true`, after bot restart the accumulated updates will be skipped
* `clearCommands` - will force reset the commands of `bot` on each start
* `database` - settings of the database. You may use any database available with JDBC Technology (like `Postgres`). For
more info see [DatabaseConfig.kt](https://github.com/InsanusMokrassar/PlaguBot/blob/master/bot/src/main/kotlin/dev/inmo/plagubot/config/DatabaseConfig.kt#L19)

0 comments on commit bd24722

Please sign in to comment.