refactor: auto format
This commit is contained in:
parent
13497ebf43
commit
78cdf79fc4
80
README.md
80
README.md
@ -1,136 +1,170 @@
|
|||||||
# Getting started
|
# Getting started
|
||||||
|
|
||||||
Discord utilizes different types of commands to interface with bots. The following explanations aim to explain these types.
|
Discord utilizes different types of commands to interface with bots. The following explanations aim to explain these types.
|
||||||
|
|
||||||
## Slash Commands
|
## Slash Commands
|
||||||
|
|
||||||
Simple text-based commands. Can be entered in any Text-Based-Channel.
|
Simple text-based commands. Can be entered in any Text-Based-Channel.
|
||||||
|
|
||||||
Prefix message with a "Slash" (``/``) and begin typing the name of the command! This prefix and the styling as a code snippet will be used to highlight Slash Commands in this message.
|
Prefix message with a "Slash" (`/`) and begin typing the name of the command! This prefix and the styling as a code snippet will be used to highlight Slash Commands in this message.
|
||||||
|
|
||||||
For clarification, this will also highlight command options as "Slash Command only" by prefixing them with an underscore (``_``)
|
For clarification, this will also highlight command options as "Slash Command only" by prefixing them with an underscore (`_`)
|
||||||
|
|
||||||
## Context Menu Commands
|
## Context Menu Commands
|
||||||
|
|
||||||
"One click" commands. Listed under context (right click) menus, under the group "Apps".
|
"One click" commands. Listed under context (right click) menus, under the group "Apps".
|
||||||
|
|
||||||
Ideally, clicking on Users or Messages, you can apply any type of command with the press of a button. Comes with the downside of lacking further input capabilities.
|
Ideally, clicking on Users or Messages, you can apply any type of command with the press of a button. Comes with the downside of lacking further input capabilities.
|
||||||
|
|
||||||
Under the list of names of any given command, there may be a quoted string. These are meant to highlight context menu capabilities for the current command, by showcasing the commands name in the quote.
|
Under the list of names of any given command, there may be a quoted string. These are meant to highlight context menu capabilities for the current command, by showcasing the commands name in the quote.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# Reaction/Self Roles
|
# Reaction/Self Roles
|
||||||
|
|
||||||
## Name
|
## Name
|
||||||
``/self_roles``
|
|
||||||
|
`/self_roles`
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
Enables users to self assign roles by reacting to a message, utilizing a bot for automated tasks
|
Enables users to self assign roles by reacting to a message, utilizing a bot for automated tasks
|
||||||
|
|
||||||
## Subcommands
|
## Subcommands
|
||||||
|
|
||||||
### create
|
### create
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/self_roles create``
|
|
||||||
|
- `/self_roles create`
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
The bot writes a message with the given contents in the current channel, and then registers said message for self roles
|
The bot writes a message with the given contents in the current channel, and then registers said message for self roles
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _text: String
|
|
||||||
|
- \_text: String
|
||||||
|
|
||||||
### register
|
### register
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/self_roles register``
|
|
||||||
|
- `/self_roles register`
|
||||||
- "Register self roles"
|
- "Register self roles"
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
Fetches any existing message and registers it for self roles directly
|
Fetches any existing message and registers it for self roles directly
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _id: Discord Message ID
|
|
||||||
|
- \_id: Discord Message ID
|
||||||
|
|
||||||
### remove
|
### remove
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/self_roles remove``
|
|
||||||
|
- `/self_roles remove`
|
||||||
- "Remove self roles"
|
- "Remove self roles"
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
Fetches any existing message, looks if it is registered for self roles and then unregisters it
|
Fetches any existing message, looks if it is registered for self roles and then unregisters it
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _id: Discord Message ID
|
|
||||||
|
- \_id: Discord Message ID
|
||||||
|
|
||||||
### add
|
### add
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/self_roles add``
|
|
||||||
|
- `/self_roles add`
|
||||||
- "Add role emoji pair"
|
- "Add role emoji pair"
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
Adds a new Role-Emoji-Pair to a given message. Reacting to said message with the given emoji yields the given role
|
Adds a new Role-Emoji-Pair to a given message. Reacting to said message with the given emoji yields the given role
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _id: Discord Message ID
|
|
||||||
|
- \_id: Discord Message ID
|
||||||
- role: Discord Role
|
- role: Discord Role
|
||||||
- emoji: Unicode [or if accessible, a custom] Emoji
|
- emoji: Unicode [or if accessible, a custom] Emoji
|
||||||
|
|
||||||
## Automated tasks
|
## Automated tasks
|
||||||
|
|
||||||
Registered Messages will automatically:
|
Registered Messages will automatically:
|
||||||
|
|
||||||
- be unregistered during deletion
|
- be unregistered during deletion
|
||||||
- be edited in case the bot owns said message. It will explain the given Role-Emoji-Pairs every time a new pair is added.
|
- be edited in case the bot owns said message. It will explain the given Role-Emoji-Pairs every time a new pair is added.
|
||||||
|
|
||||||
|
|
||||||
# Custom Voice Chat
|
# Custom Voice Chat
|
||||||
|
|
||||||
## Name
|
## Name
|
||||||
``/custom_vc``
|
|
||||||
|
`/custom_vc`
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
Enables users to create a custom, temporary voice chat with full control over it
|
Enables users to create a custom, temporary voice chat with full control over it
|
||||||
|
|
||||||
## Subcommands
|
## Subcommands
|
||||||
|
|
||||||
### create
|
### create
|
||||||
|
|
||||||
Full name:
|
Full name:
|
||||||
``/custom_vc create``
|
`/custom_vc create`
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
The bot creates a new voice channel with the given name and registers said channel for custom VC creation
|
The bot creates a new voice channel with the given name and registers said channel for custom VC creation
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _name: String
|
|
||||||
|
- \_name: String
|
||||||
|
|
||||||
### register
|
### register
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/custom_vc register``
|
|
||||||
|
- `/custom_vc register`
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
Fetches any existing voice channel and registers it for custom VC creation directly
|
Fetches any existing voice channel and registers it for custom VC creation directly
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _id: Discord Channel ID
|
|
||||||
|
- \_id: Discord Channel ID
|
||||||
|
|
||||||
### remove
|
### remove
|
||||||
|
|
||||||
Full names:
|
Full names:
|
||||||
- ``/custom_vc remove``
|
|
||||||
|
- `/custom_vc remove`
|
||||||
|
|
||||||
Description:
|
Description:
|
||||||
Fetches any voice channel, looks if it is registered for custom VC creation and then unregisters it
|
Fetches any voice channel, looks if it is registered for custom VC creation and then unregisters it
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
- _id: Discord Channel ID
|
|
||||||
|
- \_id: Discord Channel ID
|
||||||
|
|
||||||
## Automated tasks
|
## Automated tasks
|
||||||
|
|
||||||
Registered Voice Channels will automatically:
|
Registered Voice Channels will automatically:
|
||||||
|
|
||||||
- be unregistered during deletion
|
- be unregistered during deletion
|
||||||
- be deleted once all users left said channel
|
- be deleted once all users left said channel
|
||||||
- grant full control over permissions, only within said channel, to the author
|
- grant full control over permissions, only within said channel, to the author
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# TO-DO List:
|
# TO-DO List:
|
||||||
|
|
||||||
**NOTE:** These lists can and will easily be appended to in the future. Feel free to give any feedback at all and add to the list of wanted features, since this could make for many great opportunities! The bot is being developed just for this one community after all!
|
**NOTE:** These lists can and will easily be appended to in the future. Feel free to give any feedback at all and add to the list of wanted features, since this could make for many great opportunities! The bot is being developed just for this one community after all!
|
||||||
|
|
||||||
## Planned features
|
## Planned features
|
||||||
|
|
||||||
- Automated alerts/reminders
|
- Automated alerts/reminders
|
||||||
- Removing pairs on reaction/self roles
|
- Removing pairs on reaction/self roles
|
||||||
|
|
||||||
## Quirks/Bugs
|
## Quirks/Bugs
|
||||||
|
|
||||||
- Users are currently unable to overwrite permissions of temporarily generated custom VCs
|
- Users are currently unable to overwrite permissions of temporarily generated custom VCs
|
||||||
|
|
||||||
## Changes
|
## Changes
|
||||||
|
|
||||||
None
|
None
|
||||||
|
Loading…
Reference in New Issue
Block a user