b724229f06
* make the beginning height optional, defaulting to the trees current heigt * improved workflow * fix * new fix * Install modules * remove unnecessary call to build the tables * testing * f * f * oops * undev * fix const * new ci * versioning * Classes, Collections, and new Notification Relay * Fix CI for new env vars * Update to read contents of embeds * Update filter to check for embeds * Update to add includes check * Begin implementing role menu * Role menu ready for testing * Add missing emojis * Fixes, ready for testing * Tentative deploy * Documentation update * I think this fixes unchanging notifications * Update README.md * Make reminders visually distinct * Set Permissions * Added import for PermissionFlagsBits * Add ability to manually send ping from watch chan * CI update * Confusion * Make dev dockerization manual only * Dev Logging * Update reset command * Implement updating of notifications piecemeal * Unified error handling * Change to refresh commands not blindly update * Change to manual run only * Restructured file to allow async use * Move role menu setup and allow everyone to send it * Consolidate setupinfo into setup * Improved error handling * Update opt out method * Cleaning up junk * Added seconds parser and optout detection * Add opt out method * Consolidated to setup command * Add privacy setting and use new parser
46 lines
3.4 KiB
Markdown
Executable File
46 lines
3.4 KiB
Markdown
Executable File
# Silvanus
|
|
Silvanus is the ultimate Grow A Tree companion bot! Quickly compare your server's tree to others on the leaderboard with automatic calculation of tree height differences, active growth detection, watering time calculations, and more!
|
|
|
|
Important Note: Silvanus is only as up-to-date as your server's newest Tree and Tallest Trees messages. Make sure to refresh them before refreshing Silvanus' Compare message.
|
|
|
|
Silvanus is not affiliated with Grow A Tree or Limbo Labs.
|
|
|
|
## Add Silvanus to your server
|
|
[Invite Silvanus to your Discord Server](https://discord.com/api/oauth2/authorize?client_id=521624335119810561&permissions=274877908992&scope=bot%20applications.commands)
|
|
|
|
## voidf1sh Development Support Server
|
|
[Join Discord Server](https://discord.gg/g5JRGn7PxU)
|
|
|
|
## Setup
|
|
|
|
If your `/tree` and `/top trees` messages are in the same channel, simple run `/compare` in that channel and you're good to go!
|
|
|
|
Otherwise, run `/setup` to set the proper channels for the bot to look in for the `/tree` and `/top trees` messages.
|
|
|
|
Use `/commands` to view a description of all my commands.
|
|
|
|
## Permissions
|
|
Silvanus requires permissions to `Send Messages` and `Send Messages in Threads` if applicable. If you plan to use the Role Menu Silvanus will also need permission to `Manage Roles`
|
|
|
|
## Commands
|
|
* `/setup` - You only need to run this command if your server has its `/tree` and `/top trees` messages in separate channels.
|
|
* `/setupinfo` - Displays your server's configuration information.
|
|
* `/compare` - Sends a refreshable embed that calculcates the height difference between your tree and the trees currently displayed on your Tallest Trees message. There is also an Active Growth Indicator (`[💧]`).
|
|
* `/notifications` - Guild members with the `Manage Roles` permission can run this command to set up automatic reminders when your tree is ready to be watered or when fruit is dropping.
|
|
* This feature relies on Grow A Tree's built-in Notification system. Refer to Grow A Tree for instructions on setting them up.
|
|
* `watchchannel`: Select the channel you've configured Grow A Tree to send notifications in.
|
|
* `watermessage`: This option sets the message to send when the tree is ready to be watered. This can include `@pings`, links, etc.
|
|
* `pingchannel`: Select the channel you want Silvanus to forward the notifications to.
|
|
* `fruitmessage`: Optional: This sets the message to send when the tree is dropping fruit. If not set, the `watermessage` will be used instead.
|
|
* `/rolemenu` - Creates a menu for users to give themselves Water and Fruit pingable roles.
|
|
* Requires `Manage Roles` permission to run.
|
|
* `waterrole`: Select the role to give users when they select the Water button
|
|
* `fruitrole`: Optional: Select the role to give users when they select the Fruit button
|
|
* If this option isn't set, no Fruit Role will be available for self-assignment.
|
|
* `/watertime` - Calculates the wait time between waters for a tree of a given height.
|
|
* `height`: The height in feet to calculate for.
|
|
* `/timetoheight` - Calculates how long it would take to grow to a height
|
|
* `endheight`: The destination height, in feet.
|
|
* `beginheight`: Optional: The starting height, in feet. If this option isn't set, the current height of your tree will be used insead.
|
|
* `/reset` - Removes your server's configuration from the database.
|
|
* `/help` - Displays the bot's help page and links to each command. |