Command are listed alphabetically within the two main functional areas: To-Do List and Carrier Movement. It also provides several administration commands. To understand the concepts and common tasks, giving these commands context, see Concepts and Tasks.
All commands can be run by users that can manage channels and users. Some can be delegated to roles. Some commands are also written to the Discord server's audit channel, if specified. See Security for details.
The results of all commands are ephemeral, only shown to the calling user.
Command details, particularly validation and autocomplate, are a work in progress.
Set a goal for a minor faction in a star system. This overrides the implicit Control goal for a supported minor faction (see /todo-list support set). There are no goals for any system or minor faction by default.
To change a goal, use this command again, specifying the same star system and minor faction but the new goal. To remove any goal for a star system and minor faction, use /todo-list goal remove.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| minor-faction | The name of the minor faction to support. | Must be a minor faction known to http://elitebgs.app. | Minor factions known to http://elitebgs.app. |
| star-system | The name of the star system. | Must be a star system known to http://elitebgs.app. | Star systems known to http://elitebgs.app. |
| goal | The name of the goal. | Must be a valid goal. | Known goals. |
Export the set goals as a CSV (command separated variable) file. You can view or edit this file in a text editor or common spreadsheet programs like Microsoft Excel. This allows easy backup or transfer of the goals that can later be imported using /todo-list goal import.
Import a list of set goals as a CSV (command separated variable) file, adding (not replacing) to the existing goals. This allows easy backup or transfer of the goals previously exported using /todo-list goal export.
Existing goals are NOT cleared first. This is additive.
This command is audited.
Similar to /todo-list goal export, this shows a list of set goals in a more human readable format. This helps see what goals are set.
Remove any goal added by /todo-list goal add for a minor faction in a star system.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| minor-faction | The name of the minor faction to support. | Must be a minor faction already used with a goal. | Minor factions used for a goal. |
| star-system | The name of the star system. | Must be a star system already used with a goal. | Star systems used for a goal. |
Similar to /todo-list show, this outputs a list of suggested in-game activities. Unlike /todo-list show, this escapes the markdown formatting, allowing easy copying and pasting into another Discord channel to preserve the formatting. This command is intended for squadron admins that want to use this bot as an aid, customizing its output before posting it.
Show a list of suggested in-game activites. This can be run by (1) squadron admins to help create daily suggested activities to support a minor faction or (2) squadron members themselves if admins are happy to delegate the work to this bot. To get a version that admins can edit before pasting into a Discord channel without losing formatting, use /todo-list raw.
Stop supporting the minor faction previously supported using /todo-list support set. This command is audited.
Show the supported minor faction, if any.
Support a minor faction. For each system where this minor faction is present, this (1) instructs the bot to listen for BGS information, (2) adds an implicit Control goal for that minor faction and (3) writes details of carrier's jumping in to the carrier movement channel, if set. Override this implicit goal for specific star systems using /todo-list goal add. Use /todo-list support clear to stop supporting a minor faction.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| minor-faction | The name of the minor faction to support. | Must be a minor faction known to https://elitebgs.app. | Minor factions known to https://elitebgs.app. |
Stop writting carrier movements to any channel.
Show the channel where this bot writes carrier movements previously set using /carrier-movement channel set.
Set the channel where this bot writes carrier movements. This bot must have Send Messages access to the channel. No channel is set by default so you must use this command to set a channel before the bot will report carriers jumping in.
Use this command again, specifying a different channel, to change the channel where this bot writes carrier commands.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| channel | The channel. | Must be a channel on this server. | A list of channels on this server. |
Ignore a fleet carrier. This prevents the bot reporting when it jumps into a system where a supported minor faction is present. This stops the bot from reporting on friendly or squadron carriers.
To remove a carrier from the ignore list and report its movements, use /carrier-movement ignored-carriers remove.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| carrier-name | The name of the carrier to ignore. | A valid carrier name, ending with the seven character serial number. | Carriers that are not ignored. |
Export the list of ignored fleet carrers as a CSV (command separated variable) file. You can view or edit this file in a text editor or common spreadsheet programs like Microsoft Excel. This allows easy backup or transfer of the goals that can later be imported using /carrier-movement ignored-carriers import.
Import a list of ignored fleet carriers as a CSV (command separated variable) file, adding to (not replacing) the ignored carriers. This allows easy backup or transfer of the goals previously exported using /carrier-movement ignored-carriers export.
The bot writes a short description of each ignored carrier to the audit log.
This command is audited.
Similar to /carrier-movement ignored-carriers export, this shows a list of ignored fleet carriers in a more human readable format. This helps see what carriers are ignored or whether a specific carrier is on the list.
Track a fleet carrier, reporting when it jumps into a system where a supported minor faction is present. All carriers are tracked by default. To remove it from the ignore list and report its movements, use /carrier-movement ignored-carriers remove.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| carrier-name | The name of an ignored carrier. | A valid carrier name, ending with the seven character serial number. | Ignored carriers. |
Stop auditing.
The bot writes a short description of this to any previous audit log. This command is audited.
Get the channel used for auditing.
Set the channel used for auditing. This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| channel | The channel. | Must be a channel on this server. | A list of channels on this server. |
Add a Discord role to a bot role. By default, bot roles are empty. See Security for a description of the roles.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| bot-role | One of this bot's roles (Officer or Member). | Either Officer or Member. | Either OFficer or Member. |
| discord-role | The Discord role to add. | Must be a valid Discord role. | A list of roles on calling Discord server. |
List each bot role with the Discord roles assigned to each. See Security for a description of the roles.
Removed a Discord role from a bot role. See Security for a description of the roles.
This command is audited.
Parameters:
| name | Description | Validation | Autocomplete |
|---|---|---|---|
| bot-role | One of this bot's roles (Officer or Member). | Either Officer or Member. | Either OFficer or Member. |
| discord-role | The Discord role to add. | Must be a valid Discord role. | A list of roles on calling Discord server. |