@open-discord-bots/framework 0.3.14 → 0.3.15

package/src/api/modules/builder.ts

@@ -1,1755 +0,0 @@
-///////////////////////////////////////
-//BUILDER MODULE
-///////////////////////////////////////
-import { ODId, ODValidButtonColor, ODValidId, ODSystemError, ODInterfaceWithPartialProperty, ODManagerWithSafety, ODManagerData, ODNoGeneric } from "./base.js"
-import * as discord from "discord.js"
-import { ODWorkerManager, ODWorkerCallback, ODWorker } from "./worker.js"
-import { ODDebugger } from "./console.js"
-
-/**## ODBuilderImplementation `class`
- * This is an Open Discord builder implementation.
- * 
- * It is a basic implementation of the `ODWorkerManager` used by all `ODBuilder` classes.
- * 
- * This class can't be used stand-alone & needs to be extended from!
- */
-export abstract class ODBuilderImplementation<Instance,Origin extends string,Params,BuildType extends {id:ODId},WorkerIds extends string = string> extends ODManagerData {
-    /**The manager that has all workers of this implementation */
-    workers: ODWorkerManager<Instance,Origin,Params,WorkerIds>
-    /**Cache a build or create it every time from scratch when this.build() gets executed. */
-    allowCache: boolean = false
-    /**Did the build already got created/cached? */
-    didCache: boolean = false
-    /**The cache of this build. */
-    cache:BuildType|null = null
-
-    constructor(id:ODValidId, callback?:ODWorkerCallback<Instance,Origin,Params>, priority?:number, callbackId?:ODValidId){
-        super(id)
-        this.workers = new ODWorkerManager("ascending")
-        if (callback) this.workers.add(new ODWorker(callbackId ? callbackId : id,priority ?? 0,callback))
-    }
-
-    /**Set if caching is allowed */
-    setCacheMode(allowed:boolean){
-        this.allowCache = allowed
-        this.resetCache()
-        return this
-    }
-    /**Reset the current cache */
-    resetCache(){
-        this.cache = null
-        this.didCache = false
-        return this
-    }
-    /**Execute all workers & return the result. */
-    abstract build(origin:Origin, params:Params): Promise<BuildType>
-}
-
-/**## ODBuilderManager `class`
- * This is an Open Discord builder manager.
- * 
- * It contains all Open Discord builders. You can find messages, embeds, files & dropdowns, buttons & modals all here!
- * 
- * Using the Open Discord builder system has a few advantages compared to vanilla discord.js:
- * - plugins can extend/edit messages
- * - automatically reply on error
- * - independent workers (with priority)
- * - fail-safe design using try-catch
- * - cache frequently used objects
- * - get to know the origin of the build request for a specific message, button, etc
- * - And so much more!
- */
-export class ODBuilderManager<
-    ButtonIdList extends ODButtonManagerIdConstraint = ODButtonManagerIdConstraint,
-    DropdownIdList extends ODDropdownManagerIdConstraint = ODDropdownManagerIdConstraint,
-    FileIdList extends ODFileManagerIdConstraint = ODFileManagerIdConstraint,
-    EmbedIdList extends ODEmbedManagerIdConstraint = ODEmbedManagerIdConstraint,
-    MessageIdList extends ODMessageManagerIdConstraint = ODMessageManagerIdConstraint,
-    ModalIdList extends ODModalManagerIdConstraint = ODModalManagerIdConstraint
-> {
-    /**The manager for all button builders */
-    buttons: ODButtonManager<ButtonIdList>
-    /**The manager for all dropdown builders */
-    dropdowns: ODDropdownManager<DropdownIdList>
-    /**The manager for all file/attachment builders */
-    files: ODFileManager<FileIdList>
-    /**The manager for all embed builders */
-    embeds: ODEmbedManager<EmbedIdList>
-    /**The manager for all message builders */
-    messages: ODMessageManager<MessageIdList>
-    /**The manager for all modal builders */
-    modals: ODModalManager<ModalIdList>
-
-    constructor(debug:ODDebugger){
-        this.buttons = new ODButtonManager(debug)
-        this.dropdowns = new ODDropdownManager(debug)
-        this.files = new ODFileManager(debug)
-        this.embeds = new ODEmbedManager(debug)
-        this.messages = new ODMessageManager(debug)
-        this.modals = new ODModalManager(debug)
-    }
-}
-
-/**## ODComponentBuildResult `interface`
- * This interface contains the result from a built component (button/dropdown). This can be used in the `ODMessage` builder!
- */
-export interface ODComponentBuildResult {
-    /**The id of this component (button or dropdown) */
-    id:ODId,
-    /**The discord component or `\n` when it is a spacer between action rows */
-    component:discord.MessageActionRowComponentBuilder|"\n"|null
-}
-
-/**## ODButtonManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODButtonManager` class.
- */
-export type ODButtonManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODButtonManager `class`
- * This is an Open Discord button manager.
- * 
- * It contains all Open Discord button builders. Here, you can add your own buttons or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODButtonManager<IdList extends ODButtonManagerIdConstraint = ODButtonManagerIdConstraint> extends ODManagerWithSafety<ODButton<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODButton("opendiscord:unknown-button",(instance,params,origin,cancel) => {
-                instance.setCustomId("od:unknown-button")
-                instance.setMode("button")
-                instance.setColor("red")
-                instance.setLabel("<ODError:Unknown Button>")
-                instance.setEmoji("✖")
-                instance.setDisabled(true)
-                cancel()
-            })
-        },debug,"button")
-    }
-
-    /**Get a newline component for buttons & dropdowns! */
-    getNewLine(id:ODValidId): ODComponentBuildResult {
-        return {
-            id:new ODId(id),
-            component:"\n"
-        }
-    }
-
-    get<ButtonId extends keyof ODNoGeneric<IdList>>(id:ButtonId): ODButton<IdList[ButtonId]["origin"],IdList[ButtonId]["params"],IdList[ButtonId]["workers"]>
-    get(id:ODValidId): ODButton<string,{},string>|null
-    
-    get(id:ODValidId): ODButton<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<ButtonId extends keyof ODNoGeneric<IdList>>(id:ButtonId): ODButton<IdList[ButtonId]["origin"],IdList[ButtonId]["params"],IdList[ButtonId]["workers"]>
-    remove(id:ODValidId): ODButton<string,{},string>|null
-    
-    remove(id:ODValidId): ODButton<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<ButtonId extends keyof ODNoGeneric<IdList>>(id:ButtonId): ODButton<IdList[ButtonId]["origin"],IdList[ButtonId]["params"],IdList[ButtonId]["workers"]>
-    getSafe(id:ODValidId): ODButton<string,{},string>
-    
-    getSafe(id:ODValidId): ODButton<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODButtonData `interface`
- * This interface contains the data to build a button.
- */
-export interface ODButtonData {
-    /**The custom id of this button */
-    customId:string,
-    /**The mode of this button */
-    mode:"button"|"url",
-    /**The url for when the mode is set to "url" */
-    url:string|null,
-    /**The button color */
-    color:ODValidButtonColor|null,
-    /**The button label */
-    label:string|null,
-    /**The button emoji */
-    emoji:string|null,
-    /**Is the button disabled? */
-    disabled:boolean
-}
-
-/**## ODButtonInstance `class`
- * This is an Open Discord button instance.
- * 
- * It contains all properties & functions to build a button!
- */
-export class ODButtonInstance {
-    /**The current data of this button */
-    data: ODButtonData = {
-        customId:"",
-        mode:"button",
-        url:null,
-        color:null,
-        label:null,
-        emoji:null,
-        disabled:false
-    }
-
-    /**Set the custom id of this button */
-    setCustomId(id:ODButtonData["customId"]){
-        this.data.customId = id
-        return this
-    }
-    /**Set the mode of this button */
-    setMode(mode:ODButtonData["mode"]){
-        this.data.mode = mode
-        return this
-    }
-    /**Set the url of this button */
-    setUrl(url:ODButtonData["url"]){
-        this.data.url = url
-        return this
-    }
-    /**Set the color of this button */
-    setColor(color:ODButtonData["color"]){
-        this.data.color = color
-        return this
-    }
-    /**Set the label of this button */
-    setLabel(label:ODButtonData["label"]){
-        this.data.label = label
-        return this
-    }
-    /**Set the emoji of this button */
-    setEmoji(emoji:ODButtonData["emoji"]){
-        this.data.emoji = emoji
-        return this
-    }
-    /**Disable this button */
-    setDisabled(disabled:ODButtonData["disabled"]){
-        this.data.disabled = disabled
-        return this
-    }
-}
-
-/**## ODButton `class`
- * This is an Open Discord button builder.
- * 
- * With this class, you can create a button to use in a message.
- * The only difference with normal buttons is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODButton<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODButtonInstance,Origin,Params,ODComponentBuildResult,WorkerIds> {
-    /**Build this button & compile it for discord.js */
-    async build(origin:Origin, params:Params): Promise<ODComponentBuildResult> {
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        try {
-            //create instance
-            const instance = new ODButtonInstance()
-
-            //wait for workers to finish
-            await this.workers.executeWorkers(instance,origin,params)
-
-            //create the discord.js button
-            const button = new discord.ButtonBuilder()
-            if (instance.data.mode == "button") button.setCustomId(instance.data.customId)
-            if (instance.data.mode == "url") button.setStyle(discord.ButtonStyle.Link)
-            else if (instance.data.color == "gray") button.setStyle(discord.ButtonStyle.Secondary)
-            else if (instance.data.color == "blue") button.setStyle(discord.ButtonStyle.Primary)
-            else if (instance.data.color == "green") button.setStyle(discord.ButtonStyle.Success)
-            else if (instance.data.color == "red") button.setStyle(discord.ButtonStyle.Danger)
-            if (instance.data.url) button.setURL(instance.data.url)
-            if (instance.data.label) button.setLabel(instance.data.label)
-            if (instance.data.emoji) button.setEmoji(instance.data.emoji)
-            if (instance.data.disabled) button.setDisabled(instance.data.disabled)
-            if (!instance.data.emoji && !instance.data.label) button.setLabel(instance.data.customId)
-
-            this.cache = {id:this.id,component:button}
-            this.didCache = true
-            return {id:this.id,component:button}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODButton:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,component:null}
-        }
-    }
-}
-
-/**## ODQuickButton `class`
- * This is an Open Discord quick button builder.
- * 
- * With this class, you can quickly create a button to use in a message.
- * This quick button can be used by Open Discord plugins instead of the normal builders to speed up the process!
- * 
- * Because of the quick functionality, these buttons are less customisable by other plugins.
- */
-export class ODQuickButton {
-    /**The id of this button. */
-    id: ODId
-    /**The current data of this button */
-    data: Partial<ODButtonData>
-
-    constructor(id:ODValidId,data:Partial<ODButtonData>){
-        this.id = new ODId(id)
-        this.data = data
-    }
-
-    /**Build this button & compile it for discord.js */
-    async build(): Promise<ODComponentBuildResult> {
-        try {
-            //create the discord.js button
-            const button = new discord.ButtonBuilder()
-            if (this.data.mode == "button" || (!this.data.mode && this.data.customId)) button.setCustomId(this.data.customId ?? "od:unknown-button")
-            if (this.data.mode == "url") button.setStyle(discord.ButtonStyle.Link)
-            else if (this.data.color == "gray") button.setStyle(discord.ButtonStyle.Secondary)
-            else if (this.data.color == "blue") button.setStyle(discord.ButtonStyle.Primary)
-            else if (this.data.color == "green") button.setStyle(discord.ButtonStyle.Success)
-            else if (this.data.color == "red") button.setStyle(discord.ButtonStyle.Danger)
-            else button.setStyle(discord.ButtonStyle.Secondary)
-            if (this.data.url) button.setURL(this.data.url)
-            if (this.data.label) button.setLabel(this.data.label)
-            if (this.data.emoji) button.setEmoji(this.data.emoji)
-            if (this.data.disabled) button.setDisabled(this.data.disabled)
-            if (!this.data.emoji && !this.data.label) button.setLabel(this.data.customId ?? "od:unknown-button")
-
-            return {id:this.id,component:button}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODQuickButton:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,component:null}
-        }
-    }
-}
-
-/**## ODDropdownManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODDropdownManager` class.
- */
-export type ODDropdownManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODDropdownManager `class`
- * This is an Open Discord dropdown manager.
- * 
- * It contains all Open Discord dropdown builders. Here, you can add your own dropdowns or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODDropdownManager<IdList extends ODDropdownManagerIdConstraint = ODDropdownManagerIdConstraint> extends ODManagerWithSafety<ODDropdown<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODDropdown("opendiscord:unknown-dropdown",(instance,params,origin,cancel) => {
-                instance.setCustomId("od:unknown-dropdown")
-                instance.setType("string")
-                instance.setPlaceholder("❌ <ODError:Unknown Dropdown>")
-                instance.setDisabled(true)
-                instance.setOptions([
-                    {emoji:"❌",label:"<ODError:Unknown Dropdown>",value:"error"}
-                ])
-                cancel()
-            })
-        },debug,"dropdown")
-    }
-
-    /**Get a newline component for buttons & dropdowns! */
-    getNewLine(id:ODValidId): ODComponentBuildResult {
-        return {
-            id:new ODId(id),
-            component:"\n"
-        }
-    }
-
-    get<DropdownId extends keyof ODNoGeneric<IdList>>(id:DropdownId): ODDropdown<IdList[DropdownId]["origin"],IdList[DropdownId]["params"],IdList[DropdownId]["workers"]>
-    get(id:ODValidId): ODDropdown<string,{},string>|null
-    
-    get(id:ODValidId): ODDropdown<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<DropdownId extends keyof ODNoGeneric<IdList>>(id:DropdownId): ODDropdown<IdList[DropdownId]["origin"],IdList[DropdownId]["params"],IdList[DropdownId]["workers"]>
-    remove(id:ODValidId): ODDropdown<string,{},string>|null
-    
-    remove(id:ODValidId): ODDropdown<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<DropdownId extends keyof ODNoGeneric<IdList>>(id:DropdownId): ODDropdown<IdList[DropdownId]["origin"],IdList[DropdownId]["params"],IdList[DropdownId]["workers"]>
-    getSafe(id:ODValidId): ODDropdown<string,{},string>
-    
-    getSafe(id:ODValidId): ODDropdown<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODDropdownData `interface`
- * This interface contains the data to build a dropdown.
- */
-export interface ODDropdownData {
-    /**The custom id of this dropdown */
-    customId:string,
-    /**The type of this dropdown */
-    type:"string"|"role"|"channel"|"user"|"mentionable",
-    /**The placeholder of this dropdown */
-    placeholder:string|null,
-    /**The minimum amount of items to be selected in this dropdown */
-    minValues:number|null,
-    /**The maximum amount of items to be selected in this dropdown */
-    maxValues:number|null,
-    /**Is this dropdown disabled? */
-    disabled:boolean,
-    /**Allowed channel types when the type is "channel" */
-    channelTypes:discord.ChannelType[]
-
-    /**The options when the type is "string" */
-    options:discord.SelectMenuComponentOptionData[],
-    /**The options when the type is "user" */
-    users:discord.User[],
-    /**The options when the type is "role" */
-    roles:discord.Role[],
-    /**The options when the type is "channel" */
-    channels:discord.Channel[],
-    /**The options when the type is "mentionable" */
-    mentionables:(discord.User|discord.Role)[],
-}
-
-/**## ODDropdownInstance `class`
- * This is an Open Discord dropdown instance.
- * 
- * It contains all properties & functions to build a dropdown!
- */
-export class ODDropdownInstance {
-    /**The current data of this dropdown */
-    data: ODDropdownData = {
-        customId:"",
-        type:"string",
-        placeholder:null,
-        minValues:null,
-        maxValues:null,
-        disabled:false,
-        channelTypes:[],
-
-        options:[],
-        users:[],
-        roles:[],
-        channels:[],
-        mentionables:[]
-    }
-
-    /**Set the custom id of this dropdown */
-    setCustomId(id:ODDropdownData["customId"]){
-        this.data.customId = id
-        return this
-    }
-    /**Set the type of this dropdown */
-    setType(type:ODDropdownData["type"]){
-        this.data.type = type
-        return this
-    }
-    /**Set the placeholder of this dropdown */
-    setPlaceholder(placeholder:ODDropdownData["placeholder"]){
-        this.data.placeholder = placeholder
-        return this
-    }
-    /**Set the minimum amount of values in this dropdown */
-    setMinValues(minValues:ODDropdownData["minValues"]){
-        this.data.minValues = minValues
-        return this
-    }
-    /**Set the maximum amount of values ax this dropdown */
-    setMaxValues(maxValues:ODDropdownData["maxValues"]){
-        this.data.maxValues = maxValues
-        return this
-    }
-    /**Set the disabled of this dropdown */
-    setDisabled(disabled:ODDropdownData["disabled"]){
-        this.data.disabled = disabled
-        return this
-    }
-    /**Set the channel types of this dropdown */
-    setChannelTypes(channelTypes:ODDropdownData["channelTypes"]){
-        this.data.channelTypes = channelTypes
-        return this
-    }
-    /**Set the options of this dropdown (when `type == "string"`) */
-    setOptions(options:ODDropdownData["options"]){
-        this.data.options = options
-        return this
-    }
-    /**Set the users of this dropdown (when `type == "user"`) */
-    setUsers(users:ODDropdownData["users"]){
-        this.data.users = users
-        return this
-    }
-    /**Set the roles of this dropdown (when `type == "role"`) */
-    setRoles(roles:ODDropdownData["roles"]){
-        this.data.roles = roles
-        return this
-    }
-    /**Set the channels of this dropdown (when `type == "channel"`) */
-    setChannels(channels:ODDropdownData["channels"]){
-        this.data.channels = channels
-        return this
-    }
-    /**Set the mentionables of this dropdown (when `type == "mentionable"`) */
-    setMentionables(mentionables:ODDropdownData["mentionables"]){
-        this.data.mentionables = mentionables
-        return this
-    }
-}
-
-/**## ODDropdown `class`
- * This is an Open Discord dropdown builder.
- * 
- * With this class, you can create a dropdown to use in a message.
- * The only difference with normal dropdowns is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODDropdown<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODDropdownInstance,Origin,Params,ODComponentBuildResult,WorkerIds> {
-    /**Build this dropdown & compile it for discord.js */
-    async build(origin:Origin, params:Params): Promise<ODComponentBuildResult> {
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        try{
-            //create instance
-            const instance = new ODDropdownInstance()
-
-            //wait for workers to finish
-            await this.workers.executeWorkers(instance,origin,params)
-
-            //create the discord.js dropdown
-            if (instance.data.type == "string"){
-                const dropdown = new discord.StringSelectMenuBuilder()
-                dropdown.setCustomId(instance.data.customId)
-                dropdown.setOptions(...instance.data.options)
-                if (instance.data.placeholder) dropdown.setPlaceholder(instance.data.placeholder)
-                if (instance.data.minValues) dropdown.setMinValues(instance.data.minValues)
-                if (instance.data.maxValues) dropdown.setMaxValues(instance.data.maxValues)
-                if (instance.data.disabled) dropdown.setDisabled(instance.data.disabled)
-                
-                this.cache = {id:this.id,component:dropdown}
-                this.didCache = true
-                return {id:this.id,component:dropdown}
-
-            }else if (instance.data.type == "user"){
-                const dropdown = new discord.UserSelectMenuBuilder()
-                dropdown.setCustomId(instance.data.customId)
-                if (instance.data.users.length > 0) dropdown.setDefaultUsers(...instance.data.users.map((u) => u.id))
-                if (instance.data.placeholder) dropdown.setPlaceholder(instance.data.placeholder)
-                if (instance.data.minValues) dropdown.setMinValues(instance.data.minValues)
-                if (instance.data.maxValues) dropdown.setMaxValues(instance.data.maxValues)
-                if (instance.data.disabled) dropdown.setDisabled(instance.data.disabled)
-                
-                this.cache = {id:this.id,component:dropdown}
-                this.didCache = true
-                return {id:this.id,component:dropdown}
-
-            }else if (instance.data.type == "role"){
-                const dropdown = new discord.RoleSelectMenuBuilder()
-                dropdown.setCustomId(instance.data.customId)
-                if (instance.data.roles.length > 0) dropdown.setDefaultRoles(...instance.data.roles.map((r) => r.id))
-                if (instance.data.placeholder) dropdown.setPlaceholder(instance.data.placeholder)
-                if (instance.data.minValues) dropdown.setMinValues(instance.data.minValues)
-                if (instance.data.maxValues) dropdown.setMaxValues(instance.data.maxValues)
-                if (instance.data.disabled) dropdown.setDisabled(instance.data.disabled)
-                
-                this.cache = {id:this.id,component:dropdown}
-                this.didCache = true
-                return {id:this.id,component:dropdown}
-
-            }else if (instance.data.type == "channel"){
-                const dropdown = new discord.ChannelSelectMenuBuilder()
-                dropdown.setCustomId(instance.data.customId)
-                if (instance.data.channels.length > 0) dropdown.setDefaultChannels(...instance.data.channels.map((c) => c.id))
-                if (instance.data.placeholder) dropdown.setPlaceholder(instance.data.placeholder)
-                if (instance.data.minValues) dropdown.setMinValues(instance.data.minValues)
-                if (instance.data.maxValues) dropdown.setMaxValues(instance.data.maxValues)
-                if (instance.data.disabled) dropdown.setDisabled(instance.data.disabled)
-                
-                this.cache = {id:this.id,component:dropdown}
-                this.didCache = true
-                return {id:this.id,component:dropdown}
-
-            }else if (instance.data.type == "mentionable"){
-                const dropdown = new discord.MentionableSelectMenuBuilder()
-
-                const values: ({type:discord.SelectMenuDefaultValueType.User,id:string}|{type:discord.SelectMenuDefaultValueType.Role,id:string})[] = []
-                instance.data.mentionables.forEach((m) => {
-                    if (m instanceof discord.User){
-                        values.push({type:discord.SelectMenuDefaultValueType.User,id:m.id})
-                    }else{
-                        values.push({type:discord.SelectMenuDefaultValueType.Role,id:m.id})
-                    }
-                })
-
-                dropdown.setCustomId(instance.data.customId)
-                if (instance.data.mentionables.length > 0) dropdown.setDefaultValues(...values)
-                if (instance.data.placeholder) dropdown.setPlaceholder(instance.data.placeholder)
-                if (instance.data.minValues) dropdown.setMinValues(instance.data.minValues)
-                if (instance.data.maxValues) dropdown.setMaxValues(instance.data.maxValues)
-                if (instance.data.disabled) dropdown.setDisabled(instance.data.disabled)
-                
-                this.cache = {id:this.id,component:dropdown}
-                this.didCache = true
-                return {id:this.id,component:dropdown}
-            }else{
-                throw new Error("Tried to build an ODDropdown with unknown type!")
-            }
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODDropdown:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,component:null}
-        }
-    }
-}
-
-/**## ODQuickDropdown `class`
- * This is an Open Discord quick dropdown builder.
- * 
- * With this class, you can quickly create a dropdown to use in a message.
- * This quick dropdown can be used by Open Discord plugins instead of the normal builders to speed up the process!
- * 
- * Because of the quick functionality, these dropdowns are less customisable by other plugins.
- */
-export class ODQuickDropdown {
-    /**The id of this dropdown. */
-    id: ODId
-    /**The current data of this dropdown */
-    data: Partial<ODDropdownData>
-
-    constructor(id:ODValidId,data:Partial<ODDropdownData>){
-        this.id = new ODId(id)
-        this.data = data
-    }
-
-    /**Build this dropdown & compile it for discord.js */
-    async build(): Promise<ODComponentBuildResult> {
-        try{
-            //create the discord.js dropdown
-            if (this.data.type == "string"){
-                if (!this.data.options) throw new ODSystemError("ODQuickDropdown:build(): "+this.id.value+" => Dropdown requires at least 1 option to be present.")
-                const dropdown = new discord.StringSelectMenuBuilder()
-                dropdown.setCustomId(this.data.customId ?? "od:unknown-dropdown")
-                dropdown.setOptions(...this.data.options)
-                if (this.data.placeholder) dropdown.setPlaceholder(this.data.placeholder)
-                if (this.data.minValues) dropdown.setMinValues(this.data.minValues)
-                if (this.data.maxValues) dropdown.setMaxValues(this.data.maxValues)
-                if (this.data.disabled) dropdown.setDisabled(this.data.disabled)
-                
-                return {id:this.id,component:dropdown}
-
-            }else if (this.data.type == "user"){
-                if (!this.data.users) throw new ODSystemError("ODQuickDropdown:build(): "+this.id.value+" => Dropdown requires at least 1 user option to be present.")
-                const dropdown = new discord.UserSelectMenuBuilder()
-                dropdown.setCustomId(this.data.customId ?? "od:unknown-dropdown")
-                if (this.data.users.length > 0) dropdown.setDefaultUsers(...this.data.users.map((u) => u.id))
-                if (this.data.placeholder) dropdown.setPlaceholder(this.data.placeholder)
-                if (this.data.minValues) dropdown.setMinValues(this.data.minValues)
-                if (this.data.maxValues) dropdown.setMaxValues(this.data.maxValues)
-                if (this.data.disabled) dropdown.setDisabled(this.data.disabled)
-                
-                return {id:this.id,component:dropdown}
-
-            }else if (this.data.type == "role"){
-                if (!this.data.roles) throw new ODSystemError("ODQuickDropdown:build(): "+this.id.value+" => Dropdown requires at least 1 role option to be present.")
-                const dropdown = new discord.RoleSelectMenuBuilder()
-                dropdown.setCustomId(this.data.customId ?? "od:unknown-dropdown")
-                if (this.data.roles.length > 0) dropdown.setDefaultRoles(...this.data.roles.map((r) => r.id))
-                if (this.data.placeholder) dropdown.setPlaceholder(this.data.placeholder)
-                if (this.data.minValues) dropdown.setMinValues(this.data.minValues)
-                if (this.data.maxValues) dropdown.setMaxValues(this.data.maxValues)
-                if (this.data.disabled) dropdown.setDisabled(this.data.disabled)
-                
-                return {id:this.id,component:dropdown}
-
-            }else if (this.data.type == "channel"){
-                if (!this.data.channels) throw new ODSystemError("ODQuickDropdown:build(): "+this.id.value+" => Dropdown requires at least 1 channel option to be present.")
-                const dropdown = new discord.ChannelSelectMenuBuilder()
-                dropdown.setCustomId(this.data.customId ?? "od:unknown-dropdown")
-                if (this.data.channels.length > 0) dropdown.setDefaultChannels(...this.data.channels.map((c) => c.id))
-                if (this.data.placeholder) dropdown.setPlaceholder(this.data.placeholder)
-                if (this.data.minValues) dropdown.setMinValues(this.data.minValues)
-                if (this.data.maxValues) dropdown.setMaxValues(this.data.maxValues)
-                if (this.data.disabled) dropdown.setDisabled(this.data.disabled)
-                
-                return {id:this.id,component:dropdown}
-
-            }else if (this.data.type == "mentionable"){
-                if (!this.data.mentionables) throw new ODSystemError("ODQuickDropdown:build(): "+this.id.value+" => Dropdown requires at least 1 mentionable option to be present.")
-                const dropdown = new discord.MentionableSelectMenuBuilder()
-
-                const values: ({type:discord.SelectMenuDefaultValueType.User,id:string}|{type:discord.SelectMenuDefaultValueType.Role,id:string})[] = []
-                this.data.mentionables.forEach((m) => {
-                    if (m instanceof discord.User){
-                        values.push({type:discord.SelectMenuDefaultValueType.User,id:m.id})
-                    }else{
-                        values.push({type:discord.SelectMenuDefaultValueType.Role,id:m.id})
-                    }
-                })
-
-                dropdown.setCustomId(this.data.customId ?? "od:unknown-dropdown")
-                if (this.data.mentionables.length > 0) dropdown.setDefaultValues(...values)
-                if (this.data.placeholder) dropdown.setPlaceholder(this.data.placeholder)
-                if (this.data.minValues) dropdown.setMinValues(this.data.minValues)
-                if (this.data.maxValues) dropdown.setMaxValues(this.data.maxValues)
-                if (this.data.disabled) dropdown.setDisabled(this.data.disabled)
-                
-                return {id:this.id,component:dropdown}
-            }else{
-                throw new Error("Tried to build an ODQuickDropdown with unknown type!")
-            }
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODQuickDropdown:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,component:null}
-        }
-    }
-}
-
-/**## ODFileManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODFileManager` class.
- */
-export type ODFileManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODFileManager `class`
- * This is an Open Discord file manager.
- * 
- * It contains all Open Discord file builders. Here, you can add your own files or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODFileManager<IdList extends ODFileManagerIdConstraint = ODFileManagerIdConstraint> extends ODManagerWithSafety<ODFile<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODFile("opendiscord:unknown-file",(instance,params,origin,cancel) => {
-                instance.setName("opendiscord_unknown-file.txt")
-                instance.setDescription("❌ <ODError:Unknown File>")
-                instance.setContents("Couldn't find file in registery `opendiscord.builders.files`")
-                cancel()
-            })
-        },debug,"file")
-    }
-
-    get<FileId extends keyof ODNoGeneric<IdList>>(id:FileId): ODFile<IdList[FileId]["origin"],IdList[FileId]["params"],IdList[FileId]["workers"]>
-    get(id:ODValidId): ODFile<string,{},string>|null
-    
-    get(id:ODValidId): ODFile<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<FileId extends keyof ODNoGeneric<IdList>>(id:FileId): ODFile<IdList[FileId]["origin"],IdList[FileId]["params"],IdList[FileId]["workers"]>
-    remove(id:ODValidId): ODFile<string,{},string>|null
-    
-    remove(id:ODValidId): ODFile<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<FileId extends keyof ODNoGeneric<IdList>>(id:FileId): ODFile<IdList[FileId]["origin"],IdList[FileId]["params"],IdList[FileId]["workers"]>
-    getSafe(id:ODValidId): ODFile<string,{},string>
-    
-    getSafe(id:ODValidId): ODFile<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODFileData `interface`
- * This interface contains the data to build a file.
- */
-export interface ODFileData {
-    /**The file buffer, string or raw data */
-    file:discord.BufferResolvable
-    /**The name of the file */
-    name:string,
-    /**The description of the file */
-    description:string|null,
-    /**Set the file to be a spoiler */
-    spoiler:boolean
-}
-
-/**## ODFileBuildResult `interface`
- * This interface contains the result from a built file (attachment). This can be used in the `ODMessage` builder!
- */
-export interface ODFileBuildResult {
-    /**The id of this file */
-    id:ODId,
-    /**The discord file */
-    file:discord.AttachmentBuilder|null
-}
-
-/**## ODFileInstance `class`
- * This is an Open Discord file instance.
- * 
- * It contains all properties & functions to build a file!
- */
-export class ODFileInstance {
-    /**The current data of this file */
-    data: ODFileData = {
-        file:"",
-        name:"file.txt",
-        description:null,
-        spoiler:false
-    }
-
-    /**Set the file path of this attachment */
-    setFile(file:string){
-        this.data.file = file
-        return this
-    }
-    /**Set the file contents of this attachment */
-    setContents(contents:string|Buffer){
-        this.data.file = (typeof contents == "string") ? Buffer.from(contents) : contents
-        return this
-    }
-    /**Set the name of this attachment */
-    setName(name:ODFileData["name"]){
-        this.data.name = name
-        return this
-    }
-    /**Set the description of this attachment */
-    setDescription(description:ODFileData["description"]){
-        this.data.description = description
-        return this
-    }
-    /**Set this attachment to show as a spoiler */
-    setSpoiler(spoiler:ODFileData["spoiler"]){
-        this.data.spoiler = spoiler
-        return this
-    }
-}
-
-/**## ODFile `class`
- * This is an Open Discord file builder.
- * 
- * With this class, you can create a file to use in a message.
- * The only difference with normal files is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODFile<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODFileInstance,Origin,Params,ODFileBuildResult,WorkerIds> {
-    /**Build this attachment & compile it for discord.js */
-    async build(origin:Origin, params:Params): Promise<ODFileBuildResult> {
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        try{
-            //create instance
-            const instance = new ODFileInstance()
-
-            //wait for workers to finish
-            await this.workers.executeWorkers(instance,origin,params)
-
-            //create the discord.js attachment
-            const file = new discord.AttachmentBuilder(instance.data.file)
-            file.setName(instance.data.name ? instance.data.name : "file.txt")
-            if (instance.data.description) file.setDescription(instance.data.description)
-            if (instance.data.spoiler) file.setSpoiler(instance.data.spoiler)
-            
-
-            this.cache = {id:this.id,file}
-            this.didCache = true
-            return {id:this.id,file}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODFile:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,file:null}
-        }
-    }
-}
-
-/**## ODQuickFile `class`
- * This is an Open Discord quick file builder.
- * 
- * With this class, you can quickly create a file to use in a message.
- * This quick file can be used by Open Discord plugins instead of the normal builders to speed up the process!
- * 
- * Because of the quick functionality, these files are less customisable by other plugins.
- */
-export class ODQuickFile {
-    /**The id of this file. */
-    id: ODId
-    /**The current data of this file */
-    data: Partial<ODFileData>
-
-    constructor(id:ODValidId,data:Partial<ODFileData>){
-        this.id = new ODId(id)
-        this.data = data
-    }
-
-    /**Build this attachment & compile it for discord.js */
-    async build(): Promise<ODFileBuildResult> {
-        try{
-            //create the discord.js attachment
-            const file = new discord.AttachmentBuilder(this.data.file ?? "<empty-file>")
-            file.setName(this.data.name ? this.data.name : "file.txt")
-            if (this.data.description) file.setDescription(this.data.description)
-            if (this.data.spoiler) file.setSpoiler(this.data.spoiler)
-            
-            return {id:this.id,file}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODQuickFile:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,file:null}
-        }
-    }
-}
-
-/**## ODEmbedManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODEmbedManager` class.
- */
-export type ODEmbedManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODEmbedManager `class`
- * This is an Open Discord embed manager.
- * 
- * It contains all Open Discord embed builders. Here, you can add your own embeds or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODEmbedManager<IdList extends ODEmbedManagerIdConstraint = ODEmbedManagerIdConstraint> extends ODManagerWithSafety<ODEmbed<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODEmbed("opendiscord:unknown-embed",(instance,params,origin,cancel) => {
-                instance.setFooter("opendiscord:unknown-embed")
-                instance.setColor("#ff0000")
-                instance.setTitle("❌ <ODError:Unknown Embed>")
-                instance.setDescription("Couldn't find embed in registery `opendiscord.builders.embeds`")
-                cancel()
-            })
-        },debug,"embed")
-    }
-
-    get<EmbedId extends keyof ODNoGeneric<IdList>>(id:EmbedId): ODEmbed<IdList[EmbedId]["origin"],IdList[EmbedId]["params"],IdList[EmbedId]["workers"]>
-    get(id:ODValidId): ODEmbed<string,{},string>|null
-    
-    get(id:ODValidId): ODEmbed<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<EmbedId extends keyof ODNoGeneric<IdList>>(id:EmbedId): ODEmbed<IdList[EmbedId]["origin"],IdList[EmbedId]["params"],IdList[EmbedId]["workers"]>
-    remove(id:ODValidId): ODEmbed<string,{},string>|null
-    
-    remove(id:ODValidId): ODEmbed<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<EmbedId extends keyof ODNoGeneric<IdList>>(id:EmbedId): ODEmbed<IdList[EmbedId]["origin"],IdList[EmbedId]["params"],IdList[EmbedId]["workers"]>
-    getSafe(id:ODValidId): ODEmbed<string,{},string>
-    
-    getSafe(id:ODValidId): ODEmbed<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODEmbedData `interface`
- * This interface contains the data to build an embed.
- */
-export interface ODEmbedData {
-    /**The title of the embed */
-    title:string|null,
-    /**The color of the embed */
-    color:discord.ColorResolvable|string|null,
-    /**The url of the embed */
-    url:string|null,
-    /**The description of the embed */
-    description:string|null,
-    /**The author text of the embed */
-    authorText:string|null,
-    /**The author image of the embed */
-    authorImage:string|null,
-    /**The author url of the embed */
-    authorUrl:string|null,
-    /**The footer text of the embed */
-    footerText:string|null,
-    /**The footer image of the embed */
-    footerImage:string|null,
-    /**The image of the embed */
-    image:string|null,
-    /**The thumbnail of the embed */
-    thumbnail:string|null,
-    /**The fields of the embed */
-    fields:ODInterfaceWithPartialProperty<discord.EmbedField,"inline">[],
-    /**The timestamp of the embed */
-    timestamp:number|Date|null
-}
-
-/**## ODEmbedBuildResult `interface`
- * This interface contains the result from a built embed. This can be used in the `ODMessage` builder!
- */
-export interface ODEmbedBuildResult {
-    /**The id of this embed */
-    id:ODId,
-    /**The discord embed */
-    embed:discord.EmbedBuilder|null
-}
-
-/**## ODEmbedInstance `class`
- * This is an Open Discord embed instance.
- * 
- * It contains all properties & functions to build an embed!
- */
-export class ODEmbedInstance {
-    /**The current data of this embed */
-    data: ODEmbedData = {
-        title:null,
-        color:null,
-        url:null,
-        description:null,
-        authorText:null,
-        authorImage:null,
-        authorUrl:null,
-        footerText:null,
-        footerImage:null,
-        image:null,
-        thumbnail:null,
-        fields:[],
-        timestamp:null
-    }
-
-    /**Set the title of this embed */
-    setTitle(title:ODEmbedData["title"]){
-        this.data.title = title
-        return this
-    }
-    /**Set the color of this embed */
-    setColor(color:ODEmbedData["color"]){
-        this.data.color = color
-        return this
-    }
-    /**Set the url of this embed */
-    setUrl(url:ODEmbedData["url"]){
-        this.data.url = url
-        return this
-    }
-    /**Set the description of this embed */
-    setDescription(description:ODEmbedData["description"]){
-        this.data.description = description
-        return this
-    }
-    /**Set the author of this embed */
-    setAuthor(text:ODEmbedData["authorText"], image?:ODEmbedData["authorImage"], url?:ODEmbedData["authorUrl"]){
-        this.data.authorText = text
-        this.data.authorImage = image ?? null
-        this.data.authorUrl = url ?? null
-        return this
-    }
-    /**Set the footer of this embed */
-    setFooter(text:ODEmbedData["footerText"], image?:ODEmbedData["footerImage"]){
-        this.data.footerText = text
-        this.data.footerImage = image ?? null
-        return this
-    }
-    /**Set the image of this embed */
-    setImage(image:ODEmbedData["image"]){
-        this.data.image = image
-        return this
-    }
-    /**Set the thumbnail of this embed */
-    setThumbnail(thumbnail:ODEmbedData["thumbnail"]){
-        this.data.thumbnail = thumbnail
-        return this
-    }
-    /**Set the fields of this embed */
-    setFields(fields:ODEmbedData["fields"]){
-        //TEMP CHECKS
-        fields.forEach((field,index) => {
-            if (field.value.length >= 1024) throw new ODSystemError("ODEmbed:setFields() => field "+index+" reached 1024 character limit!")
-            if (field.name.length >= 256) throw new ODSystemError("ODEmbed:setFields() => field "+index+" reached 256 name character limit!")
-        })
-
-        this.data.fields = fields
-        return this
-    }
-    /**Add fields to this embed */
-    addFields(...fields:ODEmbedData["fields"]){
-        //TEMP CHECKS
-        fields.forEach((field,index) => {
-            if (field.value.length >= 1024) throw new ODSystemError("ODEmbed:addFields() => field "+index+" reached 1024 character limit!")
-            if (field.name.length >= 256) throw new ODSystemError("ODEmbed:addFields() => field "+index+" reached 256 name character limit!")
-        })
-
-        this.data.fields.push(...fields)
-        return this
-    }
-    /**Clear all fields from this embed */
-    clearFields(){
-        this.data.fields = []
-        return this
-    }
-    /**Set the timestamp of this embed */
-    setTimestamp(timestamp:ODEmbedData["timestamp"]){
-        this.data.timestamp = timestamp
-        return this
-    }
-}
-
-/**## ODEmbed `class`
- * This is an Open Discord embed builder.
- * 
- * With this class, you can create a embed to use in a message.
- * The only difference with normal embeds is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODEmbed<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODEmbedInstance,Origin,Params,ODEmbedBuildResult,WorkerIds> {
-    /**Build this embed & compile it for discord.js */
-    async build(origin:Origin, params:Params): Promise<ODEmbedBuildResult> {
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        try{
-            //create instance
-            const instance = new ODEmbedInstance()
-
-            //wait for workers to finish
-            await this.workers.executeWorkers(instance,origin,params)
-
-            //create the discord.js embed
-            const embed = new discord.EmbedBuilder()
-            if (instance.data.title) embed.setTitle(instance.data.title)
-            if (instance.data.color) embed.setColor(instance.data.color as discord.ColorResolvable)
-            if (instance.data.url) embed.setURL(instance.data.url)
-            if (instance.data.description) embed.setDescription(instance.data.description)
-            if (instance.data.authorText) embed.setAuthor({
-                name:instance.data.authorText,
-                iconURL:instance.data.authorImage ?? undefined,
-                url:instance.data.authorUrl ?? undefined
-            })
-            if (instance.data.footerText) embed.setFooter({
-                text:instance.data.footerText,
-                iconURL:instance.data.footerImage ?? undefined,
-            })
-            if (instance.data.image) embed.setImage(instance.data.image)
-            if (instance.data.thumbnail) embed.setThumbnail(instance.data.thumbnail)
-            if (instance.data.timestamp) embed.setTimestamp(instance.data.timestamp)
-            if (instance.data.fields.length > 0) embed.setFields(instance.data.fields)
-
-            this.cache = {id:this.id,embed}
-            this.didCache = true
-            return {id:this.id,embed}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODEmbed:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,embed:null}
-        }
-    }
-}
-
-/**## ODQuickEmbed `class`
- * This is an Open Discord quick embed builder.
- * 
- * With this class, you can quickly create a embed to use in a message.
- * This quick embed can be used by Open Discord plugins instead of the normal builders to speed up the process!
- * 
- * Because of the quick functionality, these embeds are less customisable by other plugins.
- */
-export class ODQuickEmbed {
-    /**The id of this embed. */
-    id: ODId
-    /**The current data of this embed */
-    data: Partial<ODEmbedData>
-
-    constructor(id:ODValidId,data:Partial<ODEmbedData>){
-        this.id = new ODId(id)
-        this.data = data
-    }
-
-    /**Build this embed & compile it for discord.js */
-    async build(): Promise<ODEmbedBuildResult> {
-        try{
-            //create the discord.js embed
-            const embed = new discord.EmbedBuilder()
-            if (this.data.title) embed.setTitle(this.data.title)
-            if (this.data.color) embed.setColor(this.data.color as discord.ColorResolvable)
-            if (this.data.url) embed.setURL(this.data.url)
-            if (this.data.description) embed.setDescription(this.data.description)
-            if (this.data.authorText) embed.setAuthor({
-                name:this.data.authorText,
-                iconURL:this.data.authorImage ?? undefined,
-                url:this.data.authorUrl ?? undefined
-            })
-            if (this.data.footerText) embed.setFooter({
-                text:this.data.footerText,
-                iconURL:this.data.footerImage ?? undefined,
-            })
-            if (this.data.image) embed.setImage(this.data.image)
-            if (this.data.thumbnail) embed.setThumbnail(this.data.thumbnail)
-            if (this.data.timestamp) embed.setTimestamp(this.data.timestamp)
-            if (this.data.fields && this.data.fields.length > 0) embed.setFields(this.data.fields)
-            
-            return {id:this.id,embed}
-        }catch(err){
-            process.emit("uncaughtException",new ODSystemError("ODQuickEmbed:build(\""+this.id.value+"\") => Major Error (see next error)"))
-            process.emit("uncaughtException",err)
-            return {id:this.id,embed:null}
-        }
-    }
-}
-
-/**## ODMessageManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODMessageManager` class.
- */
-export type ODMessageManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODMessageManager `class`
- * This is an Open Discord message manager.
- * 
- * It contains all Open Discord message builders. Here, you can add your own messages or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODMessageManager<IdList extends ODMessageManagerIdConstraint = ODMessageManagerIdConstraint> extends ODManagerWithSafety<ODMessage<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODMessage("opendiscord:unknown-message",(instance,params,origin,cancel) => {
-                instance.setContent("**❌ <ODError:Unknown Message>**\nCouldn't find message in registery `opendiscord.builders.messages`")
-                cancel()
-            })
-        },debug,"message")
-    }
-
-    get<MessageId extends keyof ODNoGeneric<IdList>>(id:MessageId): ODMessage<IdList[MessageId]["origin"],IdList[MessageId]["params"],IdList[MessageId]["workers"]>
-    get(id:ODValidId): ODMessage<string,{},string>|null
-    
-    get(id:ODValidId): ODMessage<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<MessageId extends keyof ODNoGeneric<IdList>>(id:MessageId): ODMessage<IdList[MessageId]["origin"],IdList[MessageId]["params"],IdList[MessageId]["workers"]>
-    remove(id:ODValidId): ODMessage<string,{},string>|null
-    
-    remove(id:ODValidId): ODMessage<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<MessageId extends keyof ODNoGeneric<IdList>>(id:MessageId): ODMessage<IdList[MessageId]["origin"],IdList[MessageId]["params"],IdList[MessageId]["workers"]>
-    getSafe(id:ODValidId): ODMessage<string,{},string>
-    
-    getSafe(id:ODValidId): ODMessage<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODMessageData `interface`
- * This interface contains the data to build a message.
- */
-export interface ODMessageData {
-    /**The content of this message. `null` when no content */
-    content:string|null,
-    /**Poll data for this message */
-    poll:discord.PollData|null,
-    /**Try to make this message ephemeral when available */
-    ephemeral:boolean,
-
-    /**Embeds from this message */
-    embeds:ODEmbedBuildResult[],
-    /**Components from this message */
-    components:ODComponentBuildResult[],
-    /**Files from this message */
-    files:ODFileBuildResult[],
-
-    /**Additional options that aren't covered by the Open Discord api!*/
-    additionalOptions:Omit<discord.MessageCreateOptions,"poll"|"content"|"embeds"|"components"|"files"|"flags">
-}
-
-/**## ODMessageBuildResult `interface`
- * This interface contains the result from a built message. This can be sent in a discord channel!
- */
-export interface ODMessageBuildResult {
-    /**The id of this message */
-    id:ODId,
-    /**The discord message */
-    message:Omit<discord.MessageCreateOptions,"flags">,
-    /**When enabled, the bot will try to send this as an ephemeral message */
-    ephemeral:boolean
-}
-
-/**## ODMessageInstance `class`
- * This is an Open Discord message instance.
- * 
- * It contains all properties & functions to build a message!
- */
-export class ODMessageInstance {
-    /**The current data of this message */
-    data: ODMessageData = {
-        content:null,
-        poll:null,
-        ephemeral:false,
-        embeds:[],
-        components:[],
-        files:[],
-        additionalOptions:{}
-    }
-
-    /**Set the content of this message */
-    setContent(content:ODMessageData["content"]){
-        this.data.content = content
-        return this
-    }
-    /**Set the poll of this message */
-    setPoll(poll:ODMessageData["poll"]){
-        this.data.poll = poll
-        return this
-    }
-    /**Make this message ephemeral when possible */
-    setEphemeral(ephemeral:ODMessageData["ephemeral"]){
-        this.data.ephemeral = ephemeral
-        return this
-    }
-    /**Set the embeds of this message */
-    setEmbeds(...embeds:ODEmbedBuildResult[]){
-        this.data.embeds = embeds
-        return this
-    }
-    /**Add an embed to this message! */
-    addEmbed(embed:ODEmbedBuildResult){
-        this.data.embeds.push(embed)
-        return this
-    }
-    /**Remove an embed from this message */
-    removeEmbed(id:ODValidId){
-        const index = this.data.embeds.findIndex((embed) => embed.id.value === new ODId(id).value)
-        if (index > -1) this.data.embeds.splice(index,1)
-        return this
-    }
-    /**Get an embed from this message */
-    getEmbed(id:ODValidId){
-        const embed = this.data.embeds.find((embed) => embed.id.value === new ODId(id).value)
-        if (embed) return embed.embed
-        else return null
-    }
-    /**Set the components of this message */
-    setComponents(...components:ODComponentBuildResult[]){
-        this.data.components = components
-        return this
-    }
-    /**Add a component to this message! */
-    addComponent(component:ODComponentBuildResult){
-        this.data.components.push(component)
-        return this
-    }
-    /**Remove a component from this message */
-    removeComponent(id:ODValidId){
-        const index = this.data.components.findIndex((component) => component.id.value === new ODId(id).value)
-        if (index > -1) this.data.components.splice(index,1)
-        return this
-    }
-    /**Get a component from this message */
-    getComponent(id:ODValidId){
-        const component = this.data.components.find((component) => component.id.value === new ODId(id).value)
-        if (component) return component.component
-        else return null
-    }
-    /**Set the files of this message */
-    setFiles(...files:ODFileBuildResult[]){
-        this.data.files = files
-        return this
-    }
-    /**Add a file to this message! */
-    addFile(file:ODFileBuildResult){
-        this.data.files.push(file)
-        return this
-    }
-    /**Remove a file from this message */
-    removeFile(id:ODValidId){
-        const index = this.data.files.findIndex((file) => file.id.value === new ODId(id).value)
-        if (index > -1) this.data.files.splice(index,1)
-        return this
-    }
-    /**Get a file from this message */
-    getFile(id:ODValidId){
-        const file = this.data.files.find((file) => file.id.value === new ODId(id).value)
-        if (file) return file.file
-        else return null
-    }
-}
-
-/**## ODMessage `class`
- * This is an Open Discord message builder.
- * 
- * With this class, you can create a message to send in a discord channel.
- * The only difference with normal messages is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODMessage<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODMessageInstance,Origin,Params,ODMessageBuildResult,WorkerIds> {
-    /**Build this message & compile it for discord.js */
-    async build(origin:Origin, params:Params){
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        //create instance
-        const instance = new ODMessageInstance()
-
-        //wait for workers to finish
-        await this.workers.executeWorkers(instance,origin,params)
-
-        //create the discord.js message
-        const componentArray: discord.ActionRowBuilder<discord.MessageActionRowComponentBuilder>[] = []
-        let currentRow: discord.ActionRowBuilder<discord.MessageActionRowComponentBuilder> = new discord.ActionRowBuilder()
-        instance.data.components.forEach((c) => {
-            //return when component crashed
-            if (c.component == null) return
-            else if (c.component == "\n"){
-                //create new current row when required
-                if (currentRow.components.length > 0){
-                    componentArray.push(currentRow)
-                    currentRow = new discord.ActionRowBuilder()
-                }
-            }else if (c.component instanceof discord.BaseSelectMenuBuilder){
-                //push current row when not empty
-                if (currentRow.components.length > 0){
-                    componentArray.push(currentRow)
-                    currentRow = new discord.ActionRowBuilder()
-                }
-                currentRow.addComponents(c.component)
-                //create new current row after dropdown
-                componentArray.push(currentRow)
-                currentRow = new discord.ActionRowBuilder()
-            }else{
-                //push button to current row
-                currentRow.addComponents(c.component)
-            }
-
-            //create new row when 5 rows in length
-            if (currentRow.components.length == 5){
-                componentArray.push(currentRow)
-                currentRow = new discord.ActionRowBuilder()
-            }
-        })
-        //push final row to array
-        if (currentRow.components.length > 0) componentArray.push(currentRow)
-
-        const filteredEmbeds = instance.data.embeds.map((e) => e.embed).filter((e) => e instanceof discord.EmbedBuilder) as discord.EmbedBuilder[]
-        const filteredFiles = instance.data.files.map((f) => f.file).filter((f) => f instanceof discord.AttachmentBuilder) as discord.AttachmentBuilder[]
-        
-        const message : discord.MessageCreateOptions = {
-            content:instance.data.content ?? "",
-            poll:instance.data.poll ?? undefined,
-            embeds:filteredEmbeds,
-            components:componentArray,
-            files:filteredFiles
-        }
-        
-        let result = {id:this.id,message,ephemeral:instance.data.ephemeral}
-
-        Object.assign(result.message,instance.data.additionalOptions)
-
-        this.cache = result
-        this.didCache = true
-        return result
-    }
-    /**Duplicate this message. Warning: If workers access external variables (outside parameters), the clone will still use those variables. This might result in unexpected behaviour! */
-    duplicate(newId?:ODValidId): ODMessage<Origin,Params,WorkerIds> {
-        const newMessage = new ODMessage<Origin,Params,WorkerIds>(newId ?? this.id.value)
-        for (const worker of this.workers.getAll()){
-            newMessage.workers.add(worker.duplicate())
-        }
-        return newMessage
-    }
-}
-
-/**## ODQuickMessage `class`
- * This is an Open Discord quick message builder.
- * 
- * With this class, you can quickly create a message to send in a discord channel.
- * This quick message can be used by Open Discord plugins instead of the normal builders to speed up the process!
- * 
- * Because of the quick functionality, these messages are less customisable by other plugins.
- */
-export class ODQuickMessage {
-    /**The id of this message. */
-    id: ODId
-    /**The current data of this message. */
-    data: Partial<ODMessageData>
-
-    constructor(id:ODValidId,data:Partial<ODMessageData>){
-        this.id = new ODId(id)
-        this.data = data
-    }
-
-    /**Build this message & compile it for discord.js */
-    async build(): Promise<ODMessageBuildResult> {
-        //create the discord.js message
-        const componentArray: discord.ActionRowBuilder<discord.MessageActionRowComponentBuilder>[] = []
-        let currentRow: discord.ActionRowBuilder<discord.MessageActionRowComponentBuilder> = new discord.ActionRowBuilder()
-        this.data.components?.forEach((c) => {
-            //return when component crashed
-            if (c.component == null) return
-            else if (c.component == "\n"){
-                //create new current row when required
-                if (currentRow.components.length > 0){
-                    componentArray.push(currentRow)
-                    currentRow = new discord.ActionRowBuilder()
-                }
-            }else if (c.component instanceof discord.BaseSelectMenuBuilder){
-                //push current row when not empty
-                if (currentRow.components.length > 0){
-                    componentArray.push(currentRow)
-                    currentRow = new discord.ActionRowBuilder()
-                }
-                currentRow.addComponents(c.component)
-                //create new current row after dropdown
-                componentArray.push(currentRow)
-                currentRow = new discord.ActionRowBuilder()
-            }else{
-                //push button to current row
-                currentRow.addComponents(c.component)
-            }
-
-            //create new row when 5 rows in length
-            if (currentRow.components.length == 5){
-                componentArray.push(currentRow)
-                currentRow = new discord.ActionRowBuilder()
-            }
-        })
-        //push final row to array
-        if (currentRow.components.length > 0) componentArray.push(currentRow)
-
-        const filteredEmbeds = (this.data.embeds?.map((e) => e.embed).filter((e) => e instanceof discord.EmbedBuilder) as discord.EmbedBuilder[]) ?? [] 
-        const filteredFiles = (this.data.files?.map((f) => f.file).filter((f) => f instanceof discord.AttachmentBuilder) as discord.AttachmentBuilder[]) ?? []
-        
-        const message : discord.MessageCreateOptions = {
-            content:this.data.content ?? "",
-            poll:this.data.poll ?? undefined,
-            embeds:filteredEmbeds,
-            components:componentArray,
-            files:filteredFiles
-        }
-        
-        let result = {id:this.id,message,ephemeral:this.data.ephemeral ?? false}
-
-        Object.assign(result.message,this.data.additionalOptions)
-        return result
-    }
-}
-
-/**## ODModalManagerIdConstraint `type`
- * The constraint/layout for id mappings/interfaces of the `ODModalManager` class.
- */
-export type ODModalManagerIdConstraint = Record<string,{origin:string,params:object,workers:string}>
-
-/**## ODModalManager `class`
- * This is an Open Discord modal manager.
- * 
- * It contains all Open Discord modal builders. Here, you can add your own modals or edit existing ones!
- * 
- * It's recommended to use this system in combination with all the other Open Discord builders!
- */
-export class ODModalManager<IdList extends ODModalManagerIdConstraint = ODModalManagerIdConstraint> extends ODManagerWithSafety<ODModal<string,{},string>> {
-    constructor(debug:ODDebugger){
-        super(() => {
-            return new ODModal("opendiscord:unknown-modal",(instance,params,origin,cancel) => {
-                instance.setCustomId("od:unknown-modal")
-                instance.setTitle("❌ <ODError:Unknown Modal>")
-                instance.setQuestions(
-                    {
-                        style:"short",
-                        customId:"error",
-                        label:"error",
-                        placeholder:"Contact the bot creator for more info!"
-                    }
-                )
-                cancel()
-            })
-        },debug,"modal")
-    }
-
-    get<ModalId extends keyof ODNoGeneric<IdList>>(id:ModalId): ODModal<IdList[ModalId]["origin"],IdList[ModalId]["params"],IdList[ModalId]["workers"]>
-    get(id:ODValidId): ODModal<string,{},string>|null
-    
-    get(id:ODValidId): ODModal<string,{},string>|null {
-        return super.get(id)
-    }
-
-    remove<ModalId extends keyof ODNoGeneric<IdList>>(id:ModalId): ODModal<IdList[ModalId]["origin"],IdList[ModalId]["params"],IdList[ModalId]["workers"]>
-    remove(id:ODValidId): ODModal<string,{},string>|null
-    
-    remove(id:ODValidId): ODModal<string,{},string>|null {
-        return super.remove(id)
-    }
-
-    exists(id:keyof ODNoGeneric<IdList>): boolean
-    exists(id:ODValidId): boolean
-    
-    exists(id:ODValidId): boolean {
-        return super.exists(id)
-    }
-
-    getSafe<ModalId extends keyof ODNoGeneric<IdList>>(id:ModalId): ODModal<IdList[ModalId]["origin"],IdList[ModalId]["params"],IdList[ModalId]["workers"]>
-    getSafe(id:ODValidId): ODModal<string,{},string>
-    
-    getSafe(id:ODValidId): ODModal<string,{},string> {
-        return super.getSafe(id)
-    }
-}
-
-/**## ODModalDataQuestion `interface`
- * This interface contains the data to build a modal question.
- */
-export interface ODModalDataQuestion {
-    /**The style of this modal question */
-    style:"short"|"paragraph",
-    /**The custom id of this modal question */
-    customId:string
-    /**The label of this modal question */
-    label?:string,
-    /**The min length of this modal question */
-    minLength?:number,
-    /**The max length of this modal question */
-    maxLength?:number,
-    /**Is this modal question required? */
-    required?:boolean,
-    /**The placeholder of this modal question */
-    placeholder?:string,
-    /**The initial value of this modal question */
-    value?:string
-}
-
-/**## ODModalData `interface`
- * This interface contains the data to build a modal.
- */
-export interface ODModalData {
-    /**The custom id of this modal */
-    customId:string,
-    /**The title of this modal */
-    title:string|null,
-    /**The collection of questions in this modal */
-    questions:ODModalDataQuestion[],
-}
-
-/**## ODModalBuildResult `interface`
- * This interface contains the result from a built modal (form). This can be used in the `ODMessage` builder!
- */
-export interface ODModalBuildResult {
-    /**The id of this modal */
-    id:ODId,
-    /**The discord modal */
-    modal:discord.ModalBuilder
-}
-
-/**## ODModalInstance `class`
- * This is an Open Discord modal instance.
- * 
- * It contains all properties & functions to build a modal!
- */
-export class ODModalInstance {
-    /**The current data of this modal */
-    data: ODModalData = {
-        customId:"",
-        title:null,
-        questions:[]
-    }
-
-    /**Set the custom id of this modal */
-    setCustomId(customId:ODModalData["customId"]){
-        this.data.customId = customId
-        return this
-    }
-    /**Set the title of this modal */
-    setTitle(title:ODModalData["title"]){
-        this.data.title = title
-        return this
-    }
-    /**Set the questions of this modal */
-    setQuestions(...questions:ODModalData["questions"]){
-        this.data.questions = questions
-        return this
-    }
-    /**Add a question to this modal! */
-    addQuestion(question:ODModalDataQuestion){
-        this.data.questions.push(question)
-        return this
-    }
-    /**Remove a question from this modal */
-    removeQuestion(customId:string){
-        const index = this.data.questions.findIndex((question) => question.customId === customId)
-        if (index > -1) this.data.questions.splice(index,1)
-        return this
-    }
-    /**Get a question from this modal */
-    getQuestion(customId:string){
-        const question = this.data.questions.find((question) => question.customId === customId)
-        if (question) return question
-        else return null
-    }
-}
-
-/**## ODModal `class`
- * This is an Open Discord modal builder.
- * 
- * With this class, you can create a modal to use as response in interactions.
- * The only difference with normal modals is that this one can be edited by Open Discord plugins!
- * 
- * This is possible by using "workers" or multiple functions that will be executed in priority order!
- */
-export class ODModal<Origin extends string,Params,WorkerIds extends string = string> extends ODBuilderImplementation<ODModalInstance,Origin,Params,ODModalBuildResult,WorkerIds> {
-    /**Build this modal & compile it for discord.js */
-    async build(origin:Origin, params:Params){
-        if (this.didCache && this.cache && this.allowCache) return this.cache
-        
-        //create instance
-        const instance = new ODModalInstance()
-
-        //wait for workers to finish
-        await this.workers.executeWorkers(instance,origin,params)
-
-        //create the discord.js modal
-        const modal = new discord.ModalBuilder()
-        modal.setCustomId(instance.data.customId)
-        if (instance.data.title) modal.setTitle(instance.data.title)
-        else modal.setTitle(instance.data.customId)
-        
-        instance.data.questions.forEach((question) => {
-            const input = new discord.TextInputBuilder()
-                .setStyle(question.style == "paragraph" ? discord.TextInputStyle.Paragraph : discord.TextInputStyle.Short)
-                .setCustomId(question.customId)
-                .setLabel(question.label ? question.label : question.customId)
-                .setRequired(question.required ? true : false)
-            
-            if (question.minLength) input.setMinLength(question.minLength)
-            if (question.maxLength) input.setMaxLength(question.maxLength)
-            if (question.value) input.setValue(question.value)
-            if (question.placeholder) input.setPlaceholder(question.placeholder)
-
-            modal.addComponents(
-                new discord.ActionRowBuilder<discord.ModalActionRowComponentBuilder>()
-                    .addComponents(input)
-            )
-        })
-
-        this.cache = {id:this.id,modal}
-        this.didCache = true
-        return {id:this.id,modal}
-    }
-}