⎛ℹ️⎞ About

UltraX Package is a unique package made by UltraX that allows you to create cool things using simple functions and make it faster, for example there is an invite logger, discord buttons paginator, etc...

⎜📥⎟ Installation

To install UltraX package you need: - You need to install Node.js. - You need a package called discord.js. - You need a package called node-fetch to use the Bin and Wikipediafunction. - You need a package called canvas to use the welcomeImage. Then you can open your application's terminal and type: $ npm install ultrax ## ⎜➡️⎟ Usage The available functions are: - sleep - Functions that creates timeout easily and fast. - passGen - Function to create passwords made by letters and numbers randomly with specified length. - bin - Function that allows you to bin codes. - ButtonPaginator - Function to create embed pages using buttons easily. - welcomeImage - Function that creates a welcome image fully customizable using canvas. - Wikipedia - Function that allows users to search wikipedia and return results for a query. Events: - There is currently only one event called inviteJoin in the package which allows you to get some informations about the invite such as the inviter, etc...

Functions:

sleep

sleep is a simple function, where is make it easier and faster to make a timeout in your code. Example:

// Defining the package
const  ultrax = require('ultrax')
// Getting the sleep function from the package
const  sleep = ultrax.sleep
// this will log "Start!" once i run the application
console.log('Start!')
// using the package sleep function to set a timeout
sleep(5000) // sleep(milliseconds)
// after the 5 seconds (5000 milliseconds) it will log "5 Seconds passed"
console.log('5 Seconds passed')

passGen

this is a simple function that can generate passwords using letters and numbers and the password length is custom so you can change it to any length you want! Example:

// Defining the package
const  ultrax = require('ultrax')
// getting the passGen function from the package
const  passGen = ultrax.passGen
// this will log the randomly generate password in your terminal
console.log(passGen(6)) // passGen(6) that mean it will generate a password from 6 characters.
// you can change it by changing passGen(here will be the length of the password)

Bin

This is a way to bin a code. Example:

// Defining the package
const  ultrax = require('ultrax')
// if it's empty it returns a message saying "what do you want to bin?"
if (!args.join(' ')) return  message.channel.send('What do you want to bin?');
else {
// else if everything works fine, we will make a new varible called "bin"
// it will be used to bin the args.join(' ') also known as the message.content
const  bin = await  ultrax.bin(args.join(' '));
// then here we will send the results!
console.log('Here i binned the code ' + bin)
}

Button Paginator

Button Paginator function allows you to create embed pages easily and fast. styles are:

• red
• grey
• blurple
• green
• url Example:

// Defining the package
const ultrax = require('ultrax')
// getting the MessageEmbed from discord.jsconst { MessageEmbed } = require("discord.js")
// creating embed1
const embed1 = new MessageEmbed()
    .setTitle("1st page embed");
// creating embed2
const embed2 = new MessageEmbed()
    .setTitle("2nd page embed");
// creating embed3
const embed3 = new MessageEmbed()
    .setTitle("3rd page embed");
// creating embed4
const embed4 = new MessageEmbed()
    .setTitle("4th page embed");
// creating the buttons pages
await ultrax.ButtonPaginator(message, [embed1, embed2, embed3, embed4], [{
        style: 'green',
        label: 'back',
        emoji: {
            name: '◀',
            animated: false
        },
        id: 'back' // don't change this line
    },
    {
        style: 'blurple',
        label: 'next',
        emoji: {
            name: '▶',
            animated: false
        },
        id: 'next' // don't change this line
    }
]);

welcomeImage

This function is used to create a welcome image using canvas, fully customizable and fast!

The function returns a Promise to Buffer the image and make it an Attachment, so you need to await it.

await welcomeImage()

As we mentioned before its fully customizable, so lets see the parameters and the options available.

Parameters:

• background
• avatar
• text_1 (Title)
• text_2 (Subtitle)
• text_3 (Footer)
• color

Options (Optional of course):

• font {default: "San Serif"}
• attachmentName {default: "welcome"}

So now lets talk about the correct Syntax for it!

await welcomeImage(background, avatar, text_1, text_2, text_3, color)

The background must be a PNG image

The color must be a HEX color's code. As example this HEX: #FFFFFF
In case you will use the options:

await welcomeImage(background, avatar, text_1, text_2, text_3, color, {font: "Your Font", attachmentName: 'Hello'})

the attachmentName is always PNG, so whatever name you will put it will end with .png as example Hello.png

Example:

// Getting registerFont() from canvas
const { registerFont } = require('canvas')
// Registering the font
registerFont('ShadowsIntoLight-Regular.ttf', { family: "Shadows Into Light" });

To use custom fonts, you need to install the font (ttf/otf) yourself and use registerFont() to register the font and be able to use it.

After all these explanations and examples, lets see a full and nice welcome image function working inside of an guildMemberAdd event! Example: js // defining the package const ultrax = require('ultrax') // Getting registerFont() from canvas const { registerFont } = require('canvas') // Registering the custom font registerFont('ShadowsIntoLight-Regular.ttf', { family: "Shadows Into Light" }); // Event Client.on('guildMemberAdd', async member => { // defining the background as bg let bg = 'https://cdn.discordapp.com/attachments/850808002545319957/859359637106065408/bg.png' // defining the member's avatar with "PNG" as format. let avatar = member.user.displayAvatarURL({ format: "png" }) // defining text_1 (title) let text1 = "welcome" // defining text_2 (subtitle) let text2 = member.user.tag // defining text_3 (footer) let text3 = `You're the ${member.guild.memberCount}th member` // defining the color, here its white let color = '#ffffff' // defining the options and setting them (Those are optional) const options = { font: "Shadows Into Light", attachmentName: `welcome-${member.id}` } // creating the image const image = await ultrax.welcomeImage(bg, avatar, text1, text2, text3, color, options) // sending the image: //channel.send(image) }); ## wikipedia A simple function to allow you to fetch a topic from wikipedia Example js const ultrax = require('ultrax') const prefix = "!" // require bots prefix client.on('message', message => { // Client's message event if (!message.content.startsWith(prefix) || message.author.bot) return; const args = message.content.slice(prefix.length).trim().split(' '); //Defining Args const command = args.shift().toLowerCase(); //defining command if (command === "wikipedia") { //If a user does !wikipedia, this command will execute let query = args.join(" ") //using args to define a search query, exmaple usage !wikipdia earth if (!query) return message.channel.send('Please provide a search query') // Sending a message if a user does not provide a search query const res = new ultrax.Wikipedia({ // Inistigating the wikipedia class message: message, //The message color: "RED", //Color of embed that will be sent query: query //what the search query is }) res.fetch() // fetching the result from wikipedia } }); # Events: ## Invite Logger Event This event is for logging invite uses. This is same as guildMemberAdd event but this is custom event which has 3 parameters: - member - invite - inviter Example: js // Defining the package const ultrax = require("ultrax") //defining discord const discord = require('discord.js') // new discord client const client = new discord.Client() // To Get The new event working we need to initilize it by: ultrax.inviteLogger(client) // put here your discord client // without above code event won't trigger. // now below event will work client.on('inviteJoin', (member, invite, inviter) => { // results console.log(`${member.user.tag} joined using invite code ${invite.code} from ${inviter.tag}. Invite was used ${invite.uses} times since its creation.`) });

⎝🔶⎠ Contact us

In case you have idea's to improve the package, or maybe you found some bugs or you need help, you can contact us from our discord server!