Topics

discord.js - Imagine an app•11mo ago

How to create a new channel for a guild?

I have a bot that will create a text channel to write into when invited. My question is how can I do this with discord.js? More specifically. I have this code that I have written by just exploring the API:

const guild = await client.guilds.cache.get("<some-id>");
guild?.channels.create({
    name: "test",
    type: ChannelType.GuildText,
    topic: "test",
});

const guild = await client.guilds.cache.get("<some-id>");
guild?.channels.create({
    name: "test",
    type: ChannelType.GuildText,
    topic: "test",
});

I'm guessing that this will work, but I'm not sure I understand what cache is about. I've seen this throughout the API, but I'm not sure how it works. Do I have to load the cache, or does it happen lazily whenever I try to interact with something?

46 Replies

d.js toolkit•11mo ago

- What's your exact discord.js npm list discord.js and node node -v version? - Not a discord.js issue? Check out #other-js-ts. - Consider reading #how-to-get-help to improve your question! - Explain what exactly your issue is. - Post the full error stack trace, not just the top part! - Show your code! - Issue solved? Press the button!

addamsson•11mo ago

Alternatively it would also help a lot if somebody pointed me to how caching works (I didn't find explicit guidance regarding all the cache properties in the library, but I might have missed it).

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

treble/luna•11mo ago

i also recommend taking a different approach since 1) its kinda bad UX and 2) your bot might not always have perms to create channels

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

treble/luna•11mo ago

why would you want to create a new channel? just make a command like /help or /setup plus the channel isnt perm guarded

addamsson•11mo ago

because it is part of the onboarding process either if you start it from the /setup command or the web client i already have /setup 😅 either way I'll need the channel which is the bad UX part .... aaaaand what is the different approach? makes sense. it is not documented (or at least I don't see the documentation when I browse the code) but it seems that fetch will return a Guild so I guess if no guild is found it will throw? This is my updated code:

const guild = await client.guilds.fetch("<some-id>");
guild?.channels.create({
    name: "test",
    type: ChannelType.GuildText,
    topic: "test",
});

const guild = await client.guilds.fetch("<some-id>");
guild?.channels.create({
    name: "test",
    type: ChannelType.GuildText,
    topic: "test",
});

I just noted that ? is not required here as the signature doesn't have undefined as a possible return value

treble/luna•11mo ago

something else than creating a channel no need to fetch, all guilds are cached by the Guilds intent

addamsson•11mo ago

why is creating a channel bad ux? you don't even know the use case 😅

treble/luna•11mo ago

is it a public bot? because you're not setting perms for the channel thus allowing everyone to see and send messages to it

addamsson•11mo ago

I'm a bit confused here. @thee2d said that it might not be available so to make sure that I have data I need to fetch. or not? yes

treble/luna•11mo ago

all guilds, channels and roles are cached by the Guilds intent

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

treble/luna•11mo ago

for members you would need to fetch

addamsson•11mo ago

what does "cached by the Guilds intent" mean?

treble/luna•11mo ago

exactly as says

addamsson•11mo ago

also there needs to be a fetch operation at some point

treble/luna•11mo ago

not really again

addamsson•11mo ago

i dno't have this data on my server

treble/luna•11mo ago

all guilds etc are cached upon joining a guild, the cache gets updated

addamsson•11mo ago

how does the data get into my server? certainly not by teleporting

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

addamsson•11mo ago

I don't know what aa "Guilds intent" is. I've never used anything else apart from discord.js

d.js docs•11mo ago

guide

Popular Topics: Gateway Intents read more

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

addamsson•11mo ago

ah, that's what you mean so this means that whenever I create the Client it will download all guilds / channels / roles? isn't that a lot of data?

treble/luna•11mo ago

the guilds intent also is required for basic functions

addamsson•11mo ago

i mean how many guilds are there globally?

treble/luna•11mo ago

depends on how many guilds your bot is in

addamsson•11mo ago

oh isee damn it only loads the guilds where my bot is present lol makes sense so if i have this intent i can do the .cache.whatever approach i don't need to fetch

treble/luna•11mo ago

for guilds, channels and roles yes

addamsson•11mo ago

but will fetch throw ? if the guild is not there

treble/luna•11mo ago

the promise will reject and getting from cache would return undefined

addamsson•11mo ago

so if I await then it will throw

treble/luna•11mo ago

if you fetch yes

addamsson•11mo ago

nice, thanks

treble/luna•11mo ago

if you get from cache no

addamsson•11mo ago

so why creating a channel is bad UX?

treble/luna•11mo ago

.

addamsson•11mo ago

why is that bad? that's the part i don't understand

treble/luna•11mo ago

because you're giving everyone access to that channel some guilds have send / view perms locked behind a role

addamsson•11mo ago

i get that but you can't really determine if something is bad UX if you don't know what the use case is unless you think that creating channels is universally bad btw in this particular case i don't set permissions because it is just some example code that i wrote during code exploration 😅

Unknown User•11mo ago

Message Not Public

Sign In & Join Server To View

addamsson•10mo ago

when you invite the bot you go through a wizard and in that wizard you choose a channel in which the bot will post things you know about this when you invite the bot so if you know that the bot will do that and you specifically choose the channel you will ban the bot you just invited? 😅

addamsson•10mo ago

https://tenor.com/view/why-huh-but-why-gif-13199396

Tenor

addamsson•10mo ago

TOS of what? Discord? this is the actual code BTW:

//* 👇 safe to do as discord will cache all servers where our bot resides
const guild = client.guilds.cache.get(serverId);
if (!guild) {
    throw new ServerNotFoundError(serverId);
}

//* 📘 It is possible to have multiple channels with the same name
//* (even next to each other) so we need to use find
const exists = guild.channels.cache.find((channel) => {
    const parent = channel.parent;
    let parentCheck = true;
    //* 📘 we don't care about the category of an existing channel
    //* if it is not set in the params
    if (category) {
        parentCheck = parent?.name === category;
    }
    return (
        channel.name === name &&
        channel.type === ChannelType.GuildText &&
        parentCheck
    );
});

if (!exists) {
    await guild.channels.create({
        name,
        type: ChannelType.GuildText,
        parent: category,
        topic: description,
    });
}

//* 👇 safe to do as discord will cache all servers where our bot resides
const guild = client.guilds.cache.get(serverId);
if (!guild) {
    throw new ServerNotFoundError(serverId);
}

//* 📘 It is possible to have multiple channels with the same name
//* (even next to each other) so we need to use find
const exists = guild.channels.cache.find((channel) => {
    const parent = channel.parent;
    let parentCheck = true;
    //* 📘 we don't care about the category of an existing channel
    //* if it is not set in the params
    if (category) {
        parentCheck = parent?.name === category;
    }
    return (
        channel.name === name &&
        channel.type === ChannelType.GuildText &&
        parentCheck
    );
});

if (!exists) {
    await guild.channels.create({
        name,
        type: ChannelType.GuildText,
        parent: category,
        topic: description,
    });
}

so a channel is only created if it does not exist there is no /setup command though so if you just invite the bot to your server (without using our wizard) then nothing will happen 😅

discord.js - Imagine an app Join

Support server for discord.js, a Node.js module to interact with the Discord bot API.

58KMembers

View on Discord

Want results from more Discord servers?

Add your server

More Posts

What are people using for sharding?I recently moved over to the discord-hybrid-sharding library but I have mixed feelings on relying on Change message author as botI saw a channel that converts the user messages like a bot (in counting). I tried to recreate this u How can I make this menu appear after I click on the link?How can I make this menu appear after I click on the link?how can I do this? and dps he answerhow can I do this? and dps he answer hosting on raspberry pirunning node index.js on my vscode works fine, no errors running it on my raspberry pi returns an er Why doesn't my bot always properly set/update a GuildMember's roles?Since I'm developing an RPG bot and a lot of logic also requires guild members to have certain roles ticketHi guys! Everything seems to work about the code but when I try the general support menu, it gives m Mobile StatusI have tried to set the mobile status by doing the `Discord iOS` in ws/index.js but It doesn't seem Auto menuHow can I make a menu that shows all channels or roles with discord.js ?Context menu commands not adding to the Context menu or not updatingHi, i'm trying to add / remove context menu commands to my bots, i create them similarly to the ones