Provides extra functions for guild channels and roles like findOrCreate
npm install avdiscordutilsbash
npm install avdiscordutils --save
`
Usage
`js
const {Structures} = require('discord.js')
require('avdiscordutils')(Structures);
`
Examples
$3
`js
//find one channel
guild.channels.findOne('exampleChannel')
.then(channel => console.log(Channel ${channel.name} has been created))
.catch(console.error)
//find one text channel with a random id in it's name
guild.channels.findOne('EF56HG' , {type : 'text'} , {includes : true})
.then(channel => console.log(Channel ${channel.name} has been created))
.catch(console.error)
//find all text channels with the letter a in it
guild.channels.findAll('a' , {type : 'text'} , {includes : true})
.then(channels => channels.forEach(channel => console.log(channel.name)))
.catch(console.error)
//find or create channel
guild.channels.findOrCreate('exampleChannel')
.then(channel => console.log(Channel ${channel.name} has been created))
.catch(console.error)
//find or create category channel
guild.channels.findOrCreate('exampleChannel' , {type : 'category'})
.then(channel => console.log(Channel ${channel.name} has been created))
.catch(console.error)
//findOrCreate channel with options
guild.channels.findOrCreate('exampleChannel' , {
type: 'voice',
permissionOverwrites: [
{
id: message.author.id,
deny: ['VIEW_CHANNEL'],
},
],
})
.then(channel => console.log(Channel ${channel.name} has been created))
.catch(console.error)
//find and delete category channel
guild.channels.findAndDelete('exampleChannel' , {type : 'category'})
.then(result => console.log(result))
.catch(console.error)
`
$3
`js
//find one role
guild.roles.findOne('exampleRole')
.then(role => console.log(Role ${role.name} has been created))
.catch(console.error)
//find all roles with the letter a in it
guild.roles.findAll('a' , {} , {includes : true})
.then(roles => roles.forEach(role => console.log(role.name)))
.catch(console.error)
//find or create role
guild.roles.findOrCreate('exampleRole')
.then(role => console.log(Role ${role.name} has been created))
.catch(console.error)
//findOrCreate role with options
guild.roles.findOrCreate('exampleRole' , {
data: {
name: 'Super Cool People',
color: 'BLUE',
},
reason: 'we needed a role for Super Cool People',
})
.then(role => console.log(Role ${role.name} has been created))
.catch(console.error)
//find or create role
guild.roles.findAndDelete('exampleRole')
.then(result => console.log(result))
.catch(console.error)
`
##functions docs
`js
//channels
guild.channels.findOne(String name_or_id, Object options, Object settings)
guild.channels.findAll(String name_or_id, Object options, Object settings)
guild.channels.findOrCreate(String name_or_id, Object options, Object settings)
guild.channels.findAndDelete(String name_or_id, Object options, Object settings)
//roles
guild.channels.findOne(String name_or_id, Object options, Object settings)
guild.channels.findAll(String name_or_id, Object options, Object settings)
guild.channels.findOrCreate(String name_or_id, Object options, Object settings)
guild.channels.findAndDelete(String name_or_id, Object options, Object settings)
``