dbd.js-utils

dbd.js-utils

An extra Utility that will develop dbd.js bots more easier

What does it do?

• Formatting Dates
• Progress Bars for Music and Others
• ms-parser and parse-ms in one
• Timeago Possibility
• Convert to Music Duration Format
• DBD.JS Command Handling && Reloading
• Extended JavaScript Map options (Collection)

Methods

• parseToMS(string) - Convert Duration in String to MS (Same as ms-parser)

Example

.parseToMS("3d10m3M") // can be declared as 3 Months, 3 days, 10 Minutes

• parseMS(ms) - Convert MS to Durations (seconds, minutes, hours, days, months, years) (More possibilities than parse-ms)

Example

.parseMS(345840000) // 3 and 1 Days, 4 minutes 

Output

{
  second:0,
  minute:4,
  hour:0,
  day:4,
  month:0,
  year:0
}

• progressBar(SubstractSeconds, maxSeconds, AmountOfBars, addMarker, FilledSymbol, UnfilledSymbol) - Creates a Progress bar based on given data

Logic of command

maxSeconds will be divided by AmountOfBars to create the divider, then SubstractSeconds will subtract maxSeconds and will be divided by divider, the results will create a Filled Bar marked with FilledSymbol, if addMarker is given, it will add it to the end of Filled Bar, then the amount of Filled Bar will substract AmountOfBars to get the Unfilled bars that will be filled with UnfilledSymbol.

Example

.progressBar(102, 315, 10, "📀", "―", "―")

Output

――――📀―――――

• formatDate(datestamp / date in ms, format, timezone) - Convert datestamp to Date and Format it

Example

.formatDate(1613374163494, "day, dd mmm yyyy", "UTC")

Output

Monday, 15 Feb 2021

List of Formats

Format	Description	Output
YYYY	Gets the Full Year of date	2021
YY	Gets the last 2 digits of Full Year	21
DDD	Gets the Abbreviation of Day of the Week	Mon
DAY	Gets the Name of Day of the Week	Monday
DD	Gets the Day Date in Month of date	15
D	Gets the Number Day of the Week	2
MMM	Gets the Month Abbreviation	Feb
MONTH	Gets the Month Name of date	February
MM	Gets the Month of date	2
HOUR	Gets the Amount of Hour of date	7
MIN	Gets the Amount of Minutes of date	37
SEC	Gets the Amount of Seconds of date	37

• toMusicDuration(ms) - Convert Milliseconds to Music Duration Format (hour:min:sec)

Example

.toMusicDuration(288000)

Output

4:48

• (class) Collection(Iterable) - Creates an extended Map API with extra methods/functions

Example

const dbdUtil = require("dbd.js-utils")
const Collection = new dbdUtil.Collection()

You can use Object or Array to create a Starting Data (Keys and Values)

new dbdUtil.Collection([["User", "Kino"], ["myId", 123]]) // Array

new dbdUtil.Collection({User:"Kino", myId:123}) // Object

• (class) CommandHandler() - Creates a class that handles commands

Example

const bot = new dbd.Bot({
  //DBD.JS Options
})
const CommandHandler = new dbdUtil.CommandHandler(bot)
CommandHandler.handle("./commands") // ./commands is a path

Can't see a possibility to reload commands? Wrong, you can!

We added an extra property for you to use the CommandHandler

client.CommandHandler

Reloading commands

$djsEval[

  //Reloading the Commands (path will be automatic if you have used it (Not recommended!))
  client.CommandHandler.handle()
  //with Path
  client.CommandHandler.handle("./commands")
  //or if something went wrong
  client.CommandHandler.handle(`${process.cwd()}/commands`)
]

This can also change bot.loadCommands("./commands") path, which is not needed but for People that don't afford to change all its commands.

//Lets say, you used `bot.loadCommands("./commands")
//but you want to change the path
// to `./myOtherCommands`
// with eval (Example $djsEval)

client.CommandHandler.changeDBDLoadCommandsPath("./myOtherCommands")

• resolvePath(absolutePath/Path) - Returns a Full version of given Path

Example

//As example if we run the file in `/home/runner/myBotProject`
dbdUtil.resolvePath("./myCommands") // will Return `/home/runner/myBotProject/myCommands`

Something went wrong? Errors? Bugs? Suggestions?

You can join the dbd.js Support Server or Direct Message me in Discord, ID 502968724207304714.

License

See MIT License for License