Comprensión de los roles en discordjs

Los roles son una característica poderosa en Discord, este capitulo tiene como objetivo explicar cómo funcionan los roles y los permisos. También exploraremos cómo utilizar roles para proteger sus comandos

Antes de comenzar es necesario saber sobres las jerarquías de los roles en Discord, ir a gestionan de roles, Leelo y vuelve aquí.

Obtener un rol por nombre o identificador (ID)

Tal como hemos visto en el uso de colecciones vamos a obtener los elementos de un rol mediante un ID o nombre.

Obtener elementos de un rol por ID:

let mirol = message.guild.roles.cache.get("ID-ROL");

Obtener elementos de un rol por nombre:

let mirol = message.guild.roles.cache.find(r => r.name === "NOMBRE-ROL");

Comprobando roles

Hemos visto como obtener un rol por nombre usando el metodo find(), podemos comprobar si el rol esta creado o no.

Ejemplo: 16, Comprobando si existe el rol llamado Administrador en el servidor.

let rol = message.guild.roles.cache.find(r => r.name === "Administrador"); if(!rol) { message.channel.send('Rol no encontrado en el servidor.'); } else{ message.channel.send('Si fue encontrado en el servidor.'); };

Ejemplo 17: Comprobamos si el autor del mensaje tiene el rol Administrador.

let rol = message.guild.roles.cache.find(r => r.name === "Administrador"); if(!rol) { message.channel.send('Rol no encontrado en el servidor.'); } else{ if(message.member.roles.cache.has(rol.id)) { message.channel.send('Si tienes el rol: `'+rol.name+'`.'); } else { message.channel.send('No tienes el rol: `'+rol.name+'`.'); }; };

Ejemplo 18: Tambien podemos comprobar si el autor del mensaje tiene un rol enviado por argumento.

if(!args) return message.channel.send('Escriba el nombre de un rol.'); let textoRol = args.join(" "); let rol = message.guild.roles.cache.find(r => r.name === textoRol); if(!rol) { message.channel.send('Rol no encontrado en el servidor.'); } else{ if(message.member.roles.cache.has(rol.id)) { message.channel.send('Si tienes el rol: `'+rol.name+'`.'); } else { message.channel.send('No tienes el rol: `'+rol.name+'`.'); }; };

Ejemplo 19: Tambien podemos comprobar cuantos miembros tienen un rol enviado por argumento.

if(!args) return message.channel.send('Escriba el nombre de un rol.'); let textoRol = args.join(" "); let rol = message.guild.roles.cache.find(r => r.name === textoRol); if(!rol) { message.channel.send('Rol no encontrado en el servidor.'); } else{ let rolesmiembros = message.guild.roles.cache.get(rol.id).members; message.channel.send(`Tienes a **${rolesmiembros.size}** miembro(s) con el rol **${textoRol}**.`); };

Permisos

Los permisos son las caracteristicas de los roles, dando jerarquías a cada rol creado dentro de un servidor.

En los ejemplo 6 del el kick, podemos agregarle el permiso "KICK_MEMBERS" para darle una validación o seguridad al comando, esto quiere decir que solo los miembros que tengan el permiso de "KICK_MEMBERS" podran utilizar el comando. De igual manera para un comando Ban con el permiso de "BAN_MEMBERS".

Comprobando permisos

La forma de comprobar si un miembro tiene o no un permisos, es de la siguiente forma:

let permiso = message.member.hasPermission("NOMBRE-PERMISO-EN-INGLES");

Ejemplo 20: comprobamos si el usuario tiene el permiso de expulsar

let permiso = message.member.hasPermission("KICK_MEMBERS"); if(!permiso){ message.channel.send('No tiene el permiso de kickear'); } else{ message.channel.send('Si tiene el permiso de Kickear'); }

Ejemplo 21: comprobamos si el usuario tiene el permiso de Administrador

let permiso = message.member.hasPermission("ADMINISTRATOR"); if(!permiso){ message.channel.send('No tiene el permiso de Administrador'); } else{ message.channel.send('Si tiene el permiso de Administrador'); }

Lista de permisos

Esta es la lista de permisos que puedes usar para validar tus comandos:

ADMINISTRATOR (implícitamente tiene todos los permisos y omite todas las sobrescrituras de canales) CREATE_INSTANT_INVITE (crea invitaciones al servidor) KICK_MEMBERS BAN_MEMBERS MANAGE_CHANNELS (editar y reordenar canales) MANAGE_GUILD (edita la información del servidor, la región, etc.) ADD_REACTIONS (agregar nuevas reacciones a los mensajes) VIEW_AUDIT_LOG PRIORITY_SPEAKER STREAM VIEW_CHANNEL SEND_MESSAGES SEND_TTS_MESSAGES MANAGE_MESSAGES (eliminar mensajes y reacciones) EMBED_LINKS (los enlaces publicados tendrán una vista previa incrustada) ATTACH_FILES READ_MESSAGE_HISTORY (ver los mensajes publicados antes de abrir Discord) MENTION_EVERYONE USE_EXTERNAL_EMOJIS (usa emojis de diferentes servidores) CONNECT (conectarse a un canal de voz) SPEAK (hablar en un canal de voz) MUTE_MEMBERS (silenciar miembros en todos los canales de voz) DEAFEN_MEMBERS (miembros sordos en todos los canales de voz) MOVE_MEMBERS (mover miembros entre canales de voz) USE_VAD (usar detección de actividad de voz) CHANGE_NICKNAME MANAGE_NICKNAMES (cambiar los apodos de otros miembros) MANAGE_ROLES MANAGE_WEBHOOKS MANAGE_EMOJIS

Agregar roles

Ahora que ya sabes como obtener un rol y comprobar permisos, probablemente desea agregar un rol a un miembro. Discord.js proporciona 2 metodos practicos para agregar y remover un rol.

• Para agregar un rol a un usuario usamos: roles.add()
• Para remover un rol a un usuario usamos: roles.remove()

Ejemplo 22: Agregamos un rol a un miembro mencionandolo, tambien lo validamos con el permiso de Administrador de roles.

let miembro = message.mentions.members.first(); let nombrerol = args.slice(1).join(' '); let role = message.guild.roles.cache.find(r => r.name === nombrerol); let perms = message.member.hasPermission("MANAGE_ROLES"); if(!perms) return message.channel.send("No tienes permisos suficientes, para agregar roles."); if(!miembro) return message.reply('Debe mencionar a un miembro.'); if(!nombrerol) return message.channel.send('Escriba el nombre del rol a agregar.'); if(!role) return message.channel.send('Rol no encontrado en el servidor.'); miembro.roles.add(role).catch(console.error); message.channel.send(`El rol **${role.name}** fue agregado a **${miembro.user.username}**.`);

Ejemplo 23: Removemos un rol a un miembro mencionandolo, tambien lo validamos con el permiso de Administrador de roles.

let miembro = message.mentions.members.first(); let nombrerol = args.slice(1).join(' '); let role = message.guild.roles.cache.find(r => r.name === nombrerol); let perms = message.member.hasPermission("MANAGE_ROLES"); if(!perms) return message.channel.send("No tienes permisos suficientes, para remover roles."); if(!miembro) return message.reply('Debe mencionar a un miembro.'); if(!nombrerol) return message.channel.send('Escriba el nombre del rol a remover.'); if(!role) return message.channel.send('Rol no encontrado en el servidor.'); miembro.roles.remove(role).catch(console.error); message.channel.send(`El rol **${role.name}** fue removido de **${miembro.user.username}**.`);

Ejemplo 24: Tambien podemos agregar un rol enviado por argumento, es la manera basica de obtener roles autoasignables.

if(!args) return message.channel.send('Escriba el nombre de un rol.'); let NombreRol = args.join(" "); let role = message.guild.roles.cache.find("name", NombreRol); if(!role) return message.channel.send('Rol no encontrado en el servidor.'); message.member.roles.add(role).catch(console.error); message.channel.send(`Listo **${message.author.username}**, el rol **${role.name}** te fue agregado.`);

De igual manera puede hacer para remover un rol por argumento, reemplazando addRole() a removeRole().