frame-djs v1.11.0

frame-djs es un nuevo framework de la libreria discord.js la cual te permitira interactuar con discord de forma mas ordenada y sencilla.

Instalacion:

npm install frame-djs --save

Changelog:

v1.11.0

• Se agregó dos nuevos metodos al constructor DiscordUtils (split_texto, snowflake).

v1.10.0

• Se mejoró la deteccion del cooldown.

v1.7.0

• Se arregló el constructor PageEmbed.

v1.6.0

• Se arreglaron algunas cosas del README.md (documentacion)

Demostracion:

https://youtu.be/ogwUxSFHwhc

Tabla de contenido

• Client
  • tiene_comando
  • obtener_comando
  • ejecutar_comando
  • recargar_comando
  • tiene_cooldown
• Comando
• Evento
• DiscordUtils
  • parse_tiempo
  • obtener_rol
  • obtener_miembro
  • obtener_emoji
  • obtener_canal
  • permisos
  • esObject
  • esArray
  • esFloat
  • esNum
  • unir_array
  • unir_object
  • math
  • verificar_array
  • split_texto
  • snowflake
• PageEmbed
  • paginas
  • emojis
  • tiempo
  • eliminar
  • enviar

Client

Client(opciones)

Este constructor servira para instanciar(crear) un bot, debes de usarlo como archivo principal para iniciar el bot.

Por ejemplo:

const Discord = require("frame-djs");

new Discord.Client({
  token: "BOT_TOKEN", //obligatorio
  comandos: "./comandos", //puedes colocar false si no tienes nada.
  eventos: "./eventos" //obligatorio
})

Nuevos metodos del cliente

Se creó nuevos metodos para el client (client seria la instancia del bot, en otras palabras el bot) las cuales se mostraran a continuacion:

tiene_comando

client.tiene_comando(nombre_comando)

Este metodo te permitirá verificar si existe un comando especifico.

En el caso de que tu comando contenga alias, tambien lo verificara.

Retorna

• true — Si se encontró el comando (existe).
• false — Si no se encontró el comando (no existe).

obtener_comando

client.obtener_comando(nombre_comando)

Este metodo te permitirá obtener un comando especifico.

En el caso de que tu comando contenga alias, tambien lo verificara.

Si no se coloca ningun valor en el parametro nombre_comando, esto regresara un array con los nombres de todos los comandos que actualmente dispones.

Retorna

• object — Regresa un objeto con las propiedades del comando obtenido, tales como el nombre y otras cosas mas las cuales tu puedes especificar en el constructor Comando.
• array — Regresa un array con todos los nombres de los comandos que dispones.
• false — Si no se obtuvo nada.

Por ejemplo:

//Obteniendo un comando especifico
let comando = client.obtener_comando("ping")
console.log(comando) //{nombre: "ping", etc...}

//Obteniendo todos los comandos
let comandos = client.obtener_comando()
console.log(comandos) //["ping", "etc.."]

ejecutar_comando

client.ejecutar_comando(nombre_comando, ...args)

Este metodo te permitirá ejecutar un comando especifico.

En el caso de que tu comando contenga alias, tambien lo verificara.

Por ejemplo:

//ejemplo 1
client.ejecutar_comando("ping", client, message, args)

//ejemplo 2
client.ejecutar_comando("ping", client, message, args, prefix, etc)

Retorna

• none — Esto no retorna nada.

Recuerda

• Usa siempre el metodo tiene_comando antes de este metodo, asi compruebas si el comando existe.
• La cantidad de parametros que uses en ...args, deberás de usarla en la propiedad ejecutar del constructor Comando

recargar_comando

client.recargar_comando(nombre_comando)

Este metodo te permitirá recargar un comando especifico.

Si no se coloca ningun valor en el parametro nombre_comando, esto recargará todos tus comandos.

Por ejemplo:

//ejemplo 1
client.recargar_comando("ping") //recarga el codigo del comando ping

//ejemplo 2
client.recargar_comando() //recarga todos los comandos

Retorna

• true — Si el o los comandos fueron actualizados correctamente.
• false — Si el comando no fue actualizado correctamente.

tiene_cooldown

client.tiene_cooldown(nombre_comando, message)

Este metodo te permitirá verificar si un usuario está dentro del cooldown del comando, es decir, si puede o no volver a ejecutar dicho comando.

En el caso de que tu comando contenga alias, tambien lo verificara.

Retorna

• miliseconds — El tiempo restante que le falta para volver a ejecutar el comando (regresa el tiempo en milisegundos).
• false — Si el usuario no está dentro del cooldown (quiere decir que sí puede volver a ejecutar el comando).

Recuerda

• Usa siempre el metodo tiene_comando antes de este metodo, asi compruebas si el comando existe.
• Esto unicamente funcionará si tienes la propiedad cooldown en el comando del constructor Comando

Comando

Comando(opciones)

Este constructor servira para crear un comando facilmente, debes de colocarlo en la carpeta donde especificaste la ubicacion de tus comando Client.

Ejemplo #1

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "ping",
  ejecutar: (client, message, args) => {
    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`API ms: ${client.ping}`)
    return message.channel.send(embed)
  }
})

Propiedades especiales

Se creó propiedades especiales de las cuales puedes hacer uso al momento de crear un comando, son opcionales.

Ejemplo #2

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "ping",
  alias: ["ms", "botping"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {
    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`API ms: ${client.ping}`)
    return message.channel.send(embed)
  }
})

Ejemplo #3

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "ping",
  alias: ["ms", "botping"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  disponible: false, //Deshabilitamos el comando, en mantenimiento...
  ejecutar: (client, message, args) => {
    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`API ms: ${client.ping}`)
    return message.channel.send(embed)
  }
})

Recuerda

• Puedes agregarle mas propiedades, tales como: descripcion, ejemplo, categoria, etc, no hay limites.
• En el caso de que quieras obtener todas las propiedades que le asignaste a un comando, puedes usar el metodo obtener_comando

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "avatar",
  alias: ["av", "foto"],
  cooldown: {
    tiempo: 5,
    permisos: ["ADMINISTRATOR"]
  },
  descripcion: "Este comando te permite ver el avatar de un usuario.",
  categoria: "Informacion",
  ejemplo: "avatar @usuario",
  ejecutar: (client, message, args) => {
    let usuario = message.mentions.members.first() || message.member
    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setImage(usuario.user.displayAvatarURL)
    return message.channel.send(embed)
  }
})

Evento

Evento(opciones)

Este constructor servira para crear un evento facilmente, debes de colocarlo en la carpeta donde especificaste la ubicacion de tus eventos Client.

Ejemplo #1

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Evento({
  nombre: "ready",
  ejecutar: (client) => {
    console.log(`Estoy listo en ${client.guilds.size} servidores!`)
  }
})

Ejemplo #2

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Evento({
  nombre: "message",
  ejecutar: (client, message) => {
    if(message.author.bot || message.channel.type == "dm") return;
    let prefix = "!!"
    let args = message.content.slice(prefix.length).trim().split(/ +/g);
    let comando = args.shift();

    if(client.tiene_comando(comando)) {
      return client.ejecutar_comando(comando, client, message, args)
    }
  }
})

DiscordUtils

DiscordUtils()

Este constructor contiene metodos con las cuales podras hacer muchas cosas, son de utilidad.

parse_tiempo

parse_tiempo(miliseconds, formato, len)

Este metodo te permitirá convertir un numero (debe ser en milisegundos) a un formato de texto donde se muestre el tiempo en formato de fecha, la fecha detecta (años, meses, dias, horas, minutos, segundos) dependiendo del tiempo colocado.

Retorna

• string — Regresa el texto del parametro formato con la fecha.

Por ejemplo:

//En español
const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()
let tiempo = utils.parse_tiempo(65000, "Debes de esperar {{tiempo}} para usar este comando.")

//En ingles
const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()
let tiempo = utils.parse_tiempo(65000, "You must wait {{tiempo}} to use this command.", "en")

Recuerda

• Este metodo puedes usarlo si tienes activado la propiedad del cooldown y quieras obtener el tiempo que le falta a un usuario para volver a ejecutar un comando, recuerda que el metodo tiene_cooldown regresa el tiempo en milisegundos si un usuario aun no puede volver a ejecutar un comando, ese tiempo puedes pasarlo al parametro miliseconds.

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Evento({
  nombre: "message",
  ejecutar: (client, message) => {
    if(message.author.bot || message.channel.type == "dm") return;
    let prefix = "!!"
    let args = message.content.slice(prefix.length).trim().split(/ +/g);
    let comando = args.shift();

    if(client.tiene_comando(comando)) {
      let coold = client.tiene_cooldown(comando, message)
      if(!coold) { //Si puede volver a ejecutar el comando
        return client.ejecutar_comando(comando, client, message, args)
      }
      //En el caso de que aun tenga que esperar, coold ahora contiene el tiempo de espera en milisegundos
      let utils = new Discord.DiscordUtils()
      return message.channel.send(utils.parse_tiempo(coold, "Necesitas esperar {{tiempo}} para volver a ejecutar el comando"))
    }
  }
})

obtener_rol

obtener_rol(message, nombre_id)

Este metodo te permitirá obtener un rol ya sea mediante una mencion, nombre o ID.

En el caso de que quieras obtener un rol unicamente mediante una mencion, solo usa el parametro message.

En el caso de que quieras obtener un rol mediante una mencion, nombre o ID, usa el parametro nombre_id

Retorna

• Role — Regresa el rol obtenido.
• null — Regresa null en caso de que no se encontró ningun rol.

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "roleinfo",
  alias: ["role"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {
    if(!args[0]) return message.channel.send("Menciona un rol o coloca su nombre o ID.")

    let utils = new Discord.DiscordUtils()
    let rol = utils.obtener_rol(message, args.join(" "))
    if(!rol) return message.channel.send("No se encontró ningun rol")

    let embed = new Discord.RichEmbed()
    embed.setColor(rol.color)
    embed.setDescription(`Nombre: ${rol.name}\nID: ${rol.id}`)
    return message.channel.send(embed)
  }
})

obtener_miembro

obtener_miembro(message, nombre_id, global)

Este metodo te permitirá obtener un miembro (GuildMember) ya sea mediante una mencion, nombre o ID.

En el caso de que quieras obtener un miembro unicamente mediante una mencion, solo usa el parametro message.

En el caso de que quieras obtener un miembro mediante una mencion, nombre o ID, usa el parametro nombre_id.

En el caso de que quieras obtener un usuario (User) ya sea mediante nombre o ID del cache del cliente, es decir, de la coleccion del client.users, usa el parametro global

Retorna

• GuildMember — Regresa el miembro (guildMember) obtenido.
• User — Regresa el Usuario (User) si el parametro global está en true.
• null — Regresa null en caso de que no se encontró ningun miembro/usuario.

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "userinfo",
  alias: ["user"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {
    if(!args[0]) return message.channel.send("Menciona un miembro o coloca su nombre o ID.")

    let utils = new Discord.DiscordUtils()
    let usuario = utils.obtener_miembro(message, args.join(" "))
    if(!usuario) return message.channel.send("No se encontró ningun usuario.")

    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`Nombre: ${usuario.user.username}\nID: ${usuario.id}`)
    embed.setThumbnail(usuario.user.displayAVatarURL)
    return message.channel.send(embed)
  }
})

obtener_emoji

obtener_emoji(message, nombre_id, global)

Este metodo te permitirá obtener un emoji ya sea mediante un nombre o ID.

En el caso de que quieras obtener un emoji del mismo servidor donde se ejecutó el comando, solo usa el parametro message y nombre_id.

En el caso de que quieras obtener un emoji especifico ya sea mediante nombre o ID de la coleccion de todos los emojis a los que el cliente tiene acceso (client.emojis), usa el parametro global

Retorna

• Emoji — Regresa el emoji obtenido.
• null — Regresa null en caso de que no se encontró ningun emoji.

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "emoji",
  alias: ["em"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {
    if(!args[0]) return message.channel.send("Coloca el nombre o ID de un emoji.")

    let utils = new Discord.DiscordUtils()
    let emoji = utils.obtener_emoji(message, args.join(" "), true)
    if(!emoji) return message.channel.send("No se encontró ningun emoji.")

    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`Nombre: ${emoji.name}\nID: ${emoji.id}`)
    embed.setThumbnail(emoji.url)
    return message.channel.send(embed)
  }
})

obtener_canal

obtener_canal(message, nombre_id, global)

Este metodo te permitirá obtener un canal ya sea mediante una mencion, nombre o ID.

En el caso de que quieras obtener un canal unicamente mediante una mencion, solo usa el parametro message.

En el caso de que quieras obtener un canal mediante una mencion, nombre o ID, usa el parametro nombre_id.

En el caso de que quieras obtener un canal de todos los canales a los que el cliente tiene acceso (client.channels), usa el parametro global

Retorna

• TextChannel — Regresa el canal obtenido.
• null — Regresa null en caso de que no se encontró ningun canal.

Por ejemplo:

//Ejemplo basico
const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "canalinfo",
  alias: ["canal"],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {
    if(!args[0]) return message.channel.send("Menciona un canal o coloca su nombre o ID.")

    let utils = new Discord.DiscordUtils()
    let canal = utils.obtener_canal(message, args.join(" "), true)
    if(!canal) return message.channel.send("No se encontró ningun canal.")

    let embed = new Discord.RichEmbed()
    embed.setColor("RANDOM")
    embed.setDescription(`Nombre: ${canal.name}\nID: ${canal.id}`)
    return message.channel.send(embed)
  }
})

permisos

permisos(permisos, miembro, len)

Este metodo te permitirá verificar que permisos le falta a un miembro tomando como referencia un array de permisos a verificar.

Esto regresará un array con los permisos faltantes, los nombres de los permisos estaran en español (puedes cambiarlo en el parametro len)

Retorna

• array — Regresa un array con el nombre de los permisos faltantes.

Por ejemplo:

//En español
const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()
let perms = ["MANAGE_ROLES", "KICK_MEMBERS", "MANAGE_CHANNELS"]
if(!message.guild.me.hasPermission(perms)) {
  let faltantes = utils.permisos(perms, message.guild.me)
  return message.channel.send(`Me faltan tener estos permisos:\n\n${faltantes.join("\n")}`)
}

//En ingles
const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()
let perms = ["MANAGE_ROLES", "KICK_MEMBERS", "MANAGE_CHANNELS"]
if(!message.guild.me.hasPermission(perms)) {
  let faltantes = utils.permisos(perms, message.guild.me, "en")
  return message.channel.send(`I'm missing having these permissions:\n\n${faltantes.join("\n")}`)
}

esObject

esObject(elemento)

Este metodo te permitirá verificar si un elemento es un objeto.

Retorna

• true — Si es un objeto (object)
• false — Si no es un objeto (object)

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let elem = "frase del dia"
let elem2 = {
  type: 1
}

console.log(utils.esObject(elem)) //retorna false
console.log(utils.esObject([])) //retorna false
console.log(utils.esObject(["1", {pedro: "12"}])) //retorna false
console.log(utils.esObject(5)) //retorna false
console.log(utils.esObject({type: 5})) //retorna true
console.log(utils.esObject(elem2)) //retorna true

esArray

esArray(elemento)

Este metodo te permitirá verificar si un elemento es un array.

Retorna

• true — Si es un array
• false — Si no es un array

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let elem = "frase del dia"
let elem2 = ["5", "5", ["asd2"]]

console.log(utils.esArray(elem)) //retorna false
console.log(utils.esArray([])) //retorna true
console.log(utils.esArray(5)) //retorna false
console.log(utils.esArray({type: 5})) //retorna false
console.log(utils.esArray(elem2)) //retorna true

esFloat

esFloat(elemento)

Este metodo te permitirá verificar si un elemento es un flotante (numero).

Retorna

• true — Si es un flotante
• false — Si no es un flotante

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let elem = "frase del dia"
let elem2 = "12.6"
let elem3 = 1.6

console.log(utils.esFloat(elem)) //retorna false
console.log(utils.esFloat([])) //retorna false
console.log(utils.esFloat(5)) //retorna false
console.log(utils.esFloat({type: 5})) //retorna false
console.log(utils.esFloat(elem2)) //retorna true
console.log(utils.esFloat(elem3)) //retorna true

esNum

esNum(elemento)

Este metodo te permitirá verificar si un elemento es un numero.

Retorna

• true — Si es un numero
• false — Si no es un numero

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let elem = "frase del dia"
let elem2 = "12.6"
let elem3 = 1.6

console.log(utils.esNum(elem)) //retorna false
console.log(utils.esNum([])) //retorna false
console.log(utils.esNum(5)) //retorna true
console.log(utils.esNum({type: 5})) //retorna false
console.log(utils.esNum(elem2)) //retorna true
console.log(utils.esNum(elem3)) //retorna true
console.log(utils.esNum(true)) //retorna false
console.log(utils.esNum(false)) //retorna false

unir_array

unir_array(primero, ...args)

Este metodo te permitire unir los elementos de dos o mas arrays tomando como punto principal el primer array del parametro primero, esto te regresa un nuevo array sin modificar ninguno de ellos.

Retorna

• array — Regresa un nuevo array con todos los elementos.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let array1 = ["mario", "pedro", "juan"]
let array2 = [1, 2, 3, 4]
let array3 = [[2, 4], {type: 1}]

let nuevo_array = utils.unir_array(array, array2, array3)
console.log(nuevo_array) // ["mario", "pedro", "juan", 1, 2, 3, 4, [2, 4], {type: 1}]
console.log(array1) // ["mario", "pedro", "juan"]
console.log(array2) // [1, 2, 3, 4]
console.log(array3) // [[2, 4], {type: 1}]

unir_object

unir_object(primero, ...args)

Este metodo te permitire unir las propiedades de dos o mas objetos tomando como punto principal el primer objeto del parametro primero, esto te regresa un nuevo objeto sin modificar ninguno de ellos.

Retorna

• object — Regresa un nuevo objeto con todas las propiedades.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let objeto1 = {nombre: "MegaStar"}
let objeto2 = {juego: "paladins", nivel: 15}
let objeto3 = {items: {status: true}}

let nuevo_objeto = utils.unir_object(objeto1, objeto2, objeto3)
console.log(nuevo_objeto)
/*
{
  "nombre": "MegaStar",
  "juego": "paladins",
  "nivel": 15,
  "items": {
    "status": true
  }
}
*/

console.log(objeto1) // {"nombre": "MegaStar"}
console.log(objeto2) // {"juego": "paladins", "nivel": 15}
console.log(objeto3) // {"items": {"status": true}}

math

math(simbolo, ...args)

Este metodo te permite hacer una operacion matematica rapidamente.

Retorna

• numero — Regresa el resultado de la operacion empleada.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let suma = utils.math("+", 1, 10, "15", 2)
console.log(suma) //retorna 28

let resta = utils.math("+", 50, 4, "2", 9, 3)
console.log(resta) //retorna 32

let multiplicacion = utils.math("*", 5, 34, "13")
console.log(multiplicacion) //retorna 2210

let division = utils.math("/", 124, 12)
console.log(division) //retorna 10,3333333

verificar_array

verificar_array(elemento)

Este metodo te permitirá verificar si algun elemento se repite en un array.

Retorna

• true — Si un elemento del array se repite.
• false — Si ningun elemento del array se repite.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let array1 = ["🍇", "🍎", "megastar", "🍎"]
let array2 = ["🍇", "🍎", "🍌", "🍏"]
let array3 = ["mario", "juan", "pedro", "moder"]

console.log(utils.verificar_array(array1)) //retorna true
console.log(utils.verificar_array(array2)) //retorna false
console.log(utils.verificar_array(array3)) //retorna false

split_texto

split_texto(texto, longitud, caracter)

Este metodo te permitirá dividir una cadena de texto en una lontigud especifica, el texto sera dividido en la longitud que especificaste y las partes divididas seran almacenados en un array.

Esto puedes usarlo para mandar un texto con mas de 2000 lineas en un mensaje/embed.

Retorna

• Array — Regresa un array ordenado con el texto dividio.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let lyric = `This was all you, none of it me
You put your hands on, on my body and told me
Mmm
You told me you were ready
For the big one, for the big jump
I'd be your last love everlasting you and me
Mmm
That was what you told me

I'm giving you up
I've forgiven it all
You set me free

Send my love to your new lover
Treat her better
We've gotta let go of all of our ghosts
We both know we ain't kids no more
Send my love to your new lover
Treat her better
We've gotta let go of all of our ghosts
We both know we ain't kids no more

I was too strong, you were trembling
You couldn't handle the hot heat rising (rising)
Mmm
Baby, I'm still rising
I was running, you were walking
You couldn't keep up, you were falling down (down)
Mmm
There's only one way down

I'm giving you up
I've forgiven it all
You set me free, oh

Send my love to your new lover
Treat her better
We gotta let go of all of our ghosts
We both know we ain't kids no more
Send my love to your new lover
Treat her better
We've gotta let go of all of our ghosts
We both know we ain't kids no more...`

let mensajes = utils.split_texto(lyric, 500)
console.log(mensajes)

/*
En el caso de que quieras mandar un mensaje que contenga mas de 2000 caracteres en un embed (setDescription solo puede contener 2024 caracteres)
puedes hacerlo de la siguiente manera:

let mensajes = utils.split_texto(lyric, 2000)

for(var texto of mensajes) {
  let embed = new Discord.RichEmbed()
  embed.setColor("GREEN")
  embed.setDescription(texto)
  message.channel.send(embed)
}
*/

snowflake

snowflake(id)

Este metodo te permitirá obtener la fecha de creacion de una ID (snowflake).

Retorna

• Object — Regresa un objeto con 6 propiedades: (año, mes, dia, hora, minuto, segundo) y el valor de estas propiedades contienen la fecha en formato de numero.

Por ejemplo:

const Discord = require("frame-djs");
let utils = new Discord.DiscordUtils()

let fecha = utils.snowflake("292092693377712128")
console.log(fecha)
/*

{
  "año": "2017",
  "mes": "03",
  "dia": "17",
  "hora": "00",
  "minuto": "32",
  "segundo": "04"
}

*/

console.log(`${fecha.dia}/${fecha.mes}/${fecha.año} - ${fecha.hora}:${fecha.minuto}:${fecha.segundo}`)
// 17/03/2017 - 00:32:04

PageEmbed

PageEmbed(message, modo)

Este constructor contiene metodos con las cuales podras hacer paginas con embeds usando emojis ya sean del mismo discord o personalizados.

Por ejemplo:

//Estilo "seleccion"
let pagina_estilo1 = new Discord.PageEmbed(message)

//Estilo "pagina"
let pagina_estilo2 = new Discord.PageEmbed(message, "pagina")

paginas

paginas(objeto)

Si el modo del constructor PageEmbed es "seleccion", el valor del parametro objeto debe ser un objeto, de lo contrario si el modo es "pagina", debe ser un array.

Por ejemplo:

//En el modo "seleccion"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message)
seleccion_p.paginas({
  "🍇": embed1, //El embed lo puedes construir con el constructor RichEmbed()
  "🍎": embed2, //El embed lo puedes construir con el constructor RichEmbed()
  "600778889463201834": embed3 //El embed lo puedes construir con el constructor RichEmbed()
})

//En el modo "pagina"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message, "pagina")
seleccion_p.paginas([embed1, embed2, embed3, embed4]) //Los embeds puedes construirlo con el constructor RichEmbed()

emojis

emojis(array)

Este metodo unicamente funcionará si el modo del constructor PageEmbed es "pagina".

Por ejemplo:

//En el modo "pagina"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message, "pagina")
seleccion_p.paginas([embed1, embed2, embed3, embed4]) //Los embeds puedes construirlo con el constructor RichEmbed()
seleccion_p.emojis(["⬅", "607390384074653716", "➡"]) //Aqui tambien estoy usando una ID de un emoji.
//⬅ para retroceder de pagina
// 607390384074653716 para eliminar las paginas(cancelar)
//➡ para avanzar de pagina

tiempo

tiempo(miliseconds)

Este metodo te permite ponerle un tiempo especifico a tus paginas que hiciste con los embeds, es decir, pasando el tiempo que especificaste, ya no se podra cambiar de pagina, practicamente esto le pone una duracion (por default el tiempo de duracion es de 60000 = 1 minuto)

Por ejemplo:

//En el modo "seleccion"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message)
seleccion_p.paginas({
  "🍇": embed1,
  "🍎": embed2,
  "600778889463201834": embed3
})
seleccion_p.tiempo(30000) //Solo durará 30 segundos

//En el modo "pagina"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message, "pagina")
seleccion_p.paginas([embed1, embed2, embed3, embed4])
seleccion_p.emojis(["⬅", "607390384074653716", "➡"])
seleccion_p.tiempo(30000) //Solo durará 30 segundos

eliminar

eliminar(boolean)

Este metodo te permite eliminar el mensaje que contiene las paginas una vez que la duracion haya terminado, por default esto está en false (no se eliminara)

Por ejemplo:

//En el modo "seleccion"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message)
seleccion_p.paginas({
  "🍇": embed1,
  "🍎": embed2,
  "600778889463201834": embed3
})
seleccion_p.tiempo(30000)
seleccion_p.eliminar(true) //El mensaje se eliminará cuando el tiempo haya terminado

//En el modo "pagina"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message, "pagina")
seleccion_p.paginas([embed1, embed2, embed3, embed4])
seleccion_p.emojis(["⬅", "607390384074653716", "➡"])
seleccion_p.tiempo(30000)
seleccion_p.eliminar(true) //El mensaje se eliminará cuando el tiempo haya terminado

enviar

enviar()

Este metodo servira para enviar el mensaje con las paginas, recuerda que siempre debe ir al final de todos los metodos nombrados anteriormente.

Por ejemplo:

//En el modo "seleccion"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message)
seleccion_p.paginas({
  "🍇": embed1,
  "🍎": embed2,
  "600778889463201834": embed3
})
seleccion_p.tiempo(30000)
seleccion_p.eliminar(true)
return seleccion_p.enviar()

//En el modo "pagina"
const Discord = require("frame-djs");

let seleccion_p = new Discord.PageEmbed(message, "pagina")
seleccion_p.paginas([embed1, embed2, embed3, embed4])
seleccion_p.emojis(["⬅", "607390384074653716", "➡"])
seleccion_p.tiempo(30000)
seleccion_p.eliminar(true)
return seleccion_p.enviar()

Ejemplo usando el metodo "seleccion"

const Discord = require("frame-djs");

module.exports = new Discord.Comando({
  nombre: "pagina1",
  alias: [],
  cooldown: {
    tiempo: 10,
    permisos: ["ADMINISTRATOR"]
  },
  ejecutar: (client, message, args) => {

    let p_1 = new Discord.RichEmbed()
    p_1.setDescription("Esta es la pagina 1")
    p_1.setColor("GREEN")
    p_1.setFooter("Hola mundo")

    let p_2 = new Discord.RichEmbed()
    p_2.setDescription("Esta es la pagina 2")
    p_2.setColor("BLUE")
    p_2.setFooter("MegaStar")
  
    let p_3 = new Discord.RichEmbed()
    p_3.setDescription("Esta es la pagina 3")
    p_3.setColor("RED")
    p_3.setFooter("usa frame-djs")

    let seleccion_p = new Discord.PageEmbed(message)
    seleccion_p.paginas({
      "🍇": p_1,
      "🍎": p_2,
      "🍌": p_3
    })
    seleccion_p.tiempo(30000)
    seleccion_p.eliminar(true)
    return seleccion_p.enviar()    
  }

})