MissingIdentifier/README.md
2021-03-09 19:18:19 +01:00

83 lines
2.7 KiB
Markdown

# MissingIdentifier
This is a Utility Discord providing some helpful and some not so helpful features. It uses the [JDA wrapper](https://github.com/DV8FromTheWorld/JDA).
## Features
* ANNOY: Sends a message to Guildmembers who did not choose a role yet
* AUTOSELECT: Grands users a Role when they react to a given reaction
* DICE: Roles a dice
* FOLD: Show some statistics about a [Folding@home](https://foldingathome.org) team.
* LOVECALC: chances of two users falling in love (no guarantee)
* ONLINEHIGHLIGHT: Gives users a role who play a certain game
* PURGE: bulk delete messages
* QUOTE: Saves quotes and display them randomly
* RANDOMRESPONDE: Answer to given trigger words
* SECRETCHANNEL: Grants member access to channels if they mention keywords
* SHUFFLE: Color changing role
* STATS: some guild stats
* VOICELOBBY: Temporary Voice channels via command or joining certain channels
* WELCOME: Messages for new members
## How to use MissingIdentifier
### Using my Bot hosted by me
1. Invite Bot to your Discord Guild using this [LINK](https://discordapp.com/oauth2/authorize?client_id=550770123946983440&scope=bot&permissions=285961296) (You may want to adjust the preset bot permissions to your linking).
2. Change Bot Prefix if other Bots use the same (and use it from now on instead of `!`):
```
!admin setprefix <PREFIX>
```
3. Set a Mod-Role so non Guild-Owner are able to configure this Bot (Preferably the admin role)
```
!admin setmodrole <@MODROLE>
```
4. Use the `help` command to get an overview of the available Modules and commands.
5. Activate Modules to your liking:
```
!admin <MODULE>
```
6. Reenter the `help` command to get overview of new settings and commands available
### Self host the bot
1. Create Discord Bot-User
1. Go to the [Discord Developer](https://discord.com/developers/applications) Page
2. Create a new Application and edit it to your liking
3. navigate to `BOT` and hit `add Bot`
4. may activate `Privileged Gateway Intents` (right now bot uses them, may a non presence mode will be implemented)
5. Copy Bot-Token
2. Copy release .jar executable
3. Copy sample config to .jar location
4. Enter Bot-Token from step one into config file
5. run Bot (`java -jar <filename>.jar`)
#### Updating
Just exchange the .jar executable
### Building the bot your self
1. Clone Repo
2. Run `gradle fatJar`
3. .jar executable is located in ./build/libs/
(run the bot via `gradle run` should work fine too)
## Contributing
Uhm may just ask me to get started (COMING SOON)
## Bug Report
(COMING SOON)
## Contact
Well find me ... i am using the name `Hiajen`
or just text me via [Matrix](https://matrix.to/#/@hiajen:matrix.hiajen.de) (`@hiajen:matrix.hiajen.de`)