Export and import custom commands

+export puts a custom command in a file: to keep it aside before you change it, copy it to another server or share it. +import puts it back, showing you everything before it writes anything.

To put all of a server's settings in a file, its commands included, see copy a server's settings.

Export a command

The export panel goes step by step, one question at a time; Back returns to the step before without losing your choices.

1. Type +export, then click A command (export and custom permissions, level 3 by default). This first step only shows if you may also export a server or the whole bot.
2. Pick the command in the menu. When the server has many, the arrows change the page, and Search finds a command by part of its keyword. Click Next.
3. The panel shows the commands it calls, and through which button or menu choice.
4. Click This command only, or With the … it calls, which gives their number.

A command that calls none is exported from step 2: Export replaces Next there.

The commands it calls

A command calls another when one of its buttons, or an option of its menus, has a linked command. With the … it calls also puts those commands in the file, then the ones they call in turn, up to 50. The commands that call the one you export are not in it.

With This command only, the panel says how many called commands won't be in the file.

The file

• The bot sends it to you alone, under the panel. Send it to my DMs sends it to your direct messages too. Too big for Discord to send here, it comes to you as a download link.
• Save on the bot also keeps it on the bot, under the name you choose: +import without a file finds it, on any of the bot's servers (the saved files).
• Its name is the command's keyword, followed by .crow.
• It holds all the commands' settings: their messages, their roles, their channels, their emojis, and the members of their lists. Keep it to yourself.
• A role or channel deleted since is no longer in it: the command already didn't use it. A mention in a text stays as it is.
• To put it back, send +import with this file attached (see below). It only opens on a Crow Bots bot.

A member of level 10 or more also picks, at step 2, another server the bot is in from the Server menu, then one of its commands.

Import a file

1. Send +import with the file attached, or reply with +import to the message that holds the file (import and custom permissions, level 3 by default). Without a file, +import lists the saved files on the bot that you can import: choose one, then Import, or Delete to remove it from the bot. A file too big to attach is sent through a link.
2. The panel shows the file: the server it comes from, its date, its commands, and the preview of the main command (its messages and embeds). When the file holds the commands it calls, a menu shows the others' preview.
3. Next moves to the next step: the keywords already taken, then the roles, channels and emojis, then the confirmation. At each step, the menu shows the current decision under each item.
4. Import applies it all. Nothing is written before.

On the server the file comes from, with the same bot, there is nothing to choose: the commands come back as they are in the file.

Keywords already taken

When the server already has a command with the same keyword, it is renamed by default. Choose for each, or for all with Rename all, Replace all and Import none:

• Rename: the command arrives under another keyword (suggested: the same one followed by a number);
• Replace: the imported command takes the place of the server's, and everything that ran the old one runs the new one: its tickets, its welcome message, the buttons of other commands and those already posted. The panel says what runs it;
• Don't import: the server's command is kept, and the imported buttons that called it call it.

The buttons that call a command missing from the file are linked to the server's command with the same keyword; otherwise their link is removed and the button disabled. You can link them to another command of the server.

Roles, channels and emojis

Each role, channel, emoji or sticker of the commands appears once, with the list of its uses. Your choice applies to all of them. By default, the bot takes this server's item of the same name, else creates it, else removes it:

• found: it exists on this server, it is kept;
• found by name: an item with the same name exists here;
• missing: it doesn't exist here;
• not usable everywhere: it exists, but some uses can't take it;
• on another server: a channel of another server the bot is in. It is kept, and the command keeps using it there: match it with a channel of this server to change that.

Picking an item in the menu shows its uses and says what your choice will do, for example: "@Member will be used wherever Vip was used".

For each: Match it with an item of this server, Create it (a role, a text or voice channel, a category, or an emoji of the original server), Keep or Remove it. An emoji can also be replaced with another. A replacement emoji is given as it is (😀) or by the name of a server emoji. The buttons Accept the suggestions (each item found by name is matched with it), Create everything missing and Remove everything missing (each missing item) decide for all at once.

• A role is only accepted where you could put it yourself in the command's panel: a role the command gives can't be above your highest role, nor above the bot's. A use that can't take it is flagged and loses it; the others keep it.
• You can only create what you could create yourself in Discord. A created role has the original's permissions, minus those you don't have, and arrives at the bottom of the role list.
• A mention removed from a text becomes plain text: @Name, #name, :name:.
• The confirmation flags a role with dangerous permissions that the command would give to whoever uses it.

Member lists

A command's allowed and forbidden members only come if you click Import the member lists; the panel shows their names first. An undo file puts them back by itself, like everything else.

Undo an import

Before writing, the bot sends you an undo file, to you alone. Imported on the same server, it puts the replaced commands back as they were and deletes the ones the import added. Everything that changed in those commands since is lost. Too big to be sent to you here, the undo file comes as a link; if it can't reach you at all, nothing is imported.

All the commands

Each command of this guide, with its arguments, its default level and examples: Export and import.