Creating User Installed Commands

This page will guide you through the setup of User-Installed commands

PreviousCreating Commands NextCreating Developer Commands

Last updated 8 months ago

What are User-Installed Commands?

Users have the option to install Apps/Discord Bots on their account directly. This means, they can use commands which you have added before as user installed commands in your code in all discord servers, group chats and direct messages. If the discord server "doesnt allow" to use user installed commands in their server, the discord bot will respons with ephemeral (only interaction user visible) messages. We still recommend to set ephemeral to true to not spam channels using the commands and provide a clean discord channel.

Command Building

Here is an example code of a user installed commands which is a dictionary command. The command data has to be in a object format:

const { SlashCommandBuilder, EmbedBuilder } = require('discord.js');
const theme = require("../../../embedConfig.json");
module.exports = {
    data: {
        name: "dictionary",
        description: "search a word in the dictionary",
        "integration_types": [0, 1],
        "contexts": [0, 1, 2],
        options: [
            {
                name: "word",
                required: true,
                type: 3,
                description: "the word you want to search"
            },
        ]
    },

    async execute(interaction) {
 
        const word = interaction.options.getString('word');
 
        let data = await fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
 
        if (data.statusText == 'Not Found') {
            return interaction.reply({ content: 'that word does not exist', ephemeral: true});
        }
 
        let info = await data.json();
        let result = info[0];
 
      let embedInfo = await result.meanings.map((data, index) => {
 
            let definition = data.definitions[0].definition || "No definition found";
            let example = data.definitions[0].example || "No example found";
 
 
            return {
                name: data.partOfSpeech.toUpperCase(),
                value: `\`\`\` Description: ${definition} \n Example: ${example} \`\`\``,
            };
 
 
        });
 
        const embed = new EmbedBuilder()
        .setColor(theme.theme)
        .setTitle(`Definition of | **${result.word}**`)
        .addFields(embedInfo)
 
        await interaction.reply({ embeds: [embed], ephemeral: true });
    }
}

What are User-Installed Commands?

Command Building

Here is an example code of a user installed commands which is a dictionary command. The command data has to be in a object format:

const { SlashCommandBuilder, EmbedBuilder } = require('discord.js');
const theme = require("../../../embedConfig.json");
module.exports = {
    data: {
        name: "dictionary",
        description: "search a word in the dictionary",
        "integration_types": [0, 1],
        "contexts": [0, 1, 2],
        options: [
            {
                name: "word",
                required: true,
                type: 3,
                description: "the word you want to search"
            },
        ]
    },

    async execute(interaction) {
 
        const word = interaction.options.getString('word');
 
        let data = await fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
 
        if (data.statusText == 'Not Found') {
            return interaction.reply({ content: 'that word does not exist', ephemeral: true});
        }
 
        let info = await data.json();
        let result = info[0];
 
      let embedInfo = await result.meanings.map((data, index) => {
 
            let definition = data.definitions[0].definition || "No definition found";
            let example = data.definitions[0].example || "No example found";
 
 
            return {
                name: data.partOfSpeech.toUpperCase(),
                value: `\`\`\` Description: ${definition} \n Example: ${example} \`\`\``,
            };
 
 
        });
 
        const embed = new EmbedBuilder()
        .setColor(theme.theme)
        .setTitle(`Definition of | **${result.word}**`)
        .addFields(embedInfo)
 
        await interaction.reply({ embeds: [embed], ephemeral: true });
    }
}

Creating User Installed Commands

Creating User Installed Commands

Disclaimer

What are User-Installed Commands?

Handler Setup

Command Building

Useful Links

Example of building user-installed commands by Discord (JavaScript)

Developing A User-Installable App

Prebuilt Commands

User Installed commands explained with short tutorial

Disclaimer

What are User-Installed Commands?

Handler Setup

Command Building

Useful Links

Example of building user-installed commands by Discord (JavaScript)

Developing A User-Installable App

Prebuilt Commands

User Installed commands explained with short tutorial