About
The about builder allows you to configure your bot's about command.
By default, Kord Extensions will create an about chat and slash command, with a copyright subcommand. You can configure this command using the about { } builder, adding your own sections and copyright notices as appropriate.
Configuration
The about { } builder provides the following properties.
Property | Type | Description |
|---|---|---|
|
| Whether commands (including the copyright command) should respond to slash commands ephemerally. Defaults to |
|
| Translation bundle, used to translate your section names and descriptions by default. |
Sections
While Kord Extensions provides the copyright subcommand by default, you're free to add any other informational commands you wish. These commands are referred to as "sections," and each section is represented by a subcommand on the about command.
To configure a section, use the section function. This function takes the section name and description as arguments, and provides a builder you can use to configure the section's options and provide a message.
The about { } builder also provides a general builder, providing a standard "general" section with a translated command name and description.
Builders
Builder | Description |
|---|---|
| Call this DSL function to provide a message builder, used to construct the message returned to the user when they access the current section. This builder is a receiver against the |
Properties
Property | Type | Description |
|---|---|---|
|
| Whether this section should respond to slash commands ephemerally. If not provided, defaults to the setting provided in the |
|
| Translation bundle, used to translate the section name and description. If not provided, defaults to the setting provided in the |
Functions
Function | Description |
|---|---|
| Convenience function providing quick access to the i18n system, allowing translation using the given translation key and locale. |
Copyright
The contents of the copyright section are generated based on a list of copyright entries, provided via the copyright function.
Kord Extensions will automatically populate this list with the following data:
The dependencies it uses, along with those used by any first-party modules included with your bot.
A list of currently loaded plugins, without versioning information.
Copyright items may be added by calling the copyright function with a name, SPDX license identifier, item type (Framework, Library, Plugin/Module, or Tool), and optionally a URL.
Modules
If you're writing a module, library, or meta-framework, feel free to include whatever information you feel is relevant by default.
A simple way to do this is by creating an extension function, checking a top-level boolean value, and calling this function in a setup function or class initializer. For example: