@open-discord-bots/framework 0.0.1 → 0.0.2

package/src/api/modules/checker.ts

@@ -0,0 +1,1549 @@
+///////////////////////////////////////
+//CONFIG CHECKER MODULE
+///////////////////////////////////////
+import { ODDiscordIdType, ODId, ODManager, ODManagerData, ODValidId, ODValidJsonType } from "./base"
+import { ODConfig } from "./config"
+import { ODLanguageManager } from "./language"
+import { ODDebugger } from "./console"
+
+/**## ODCheckerResult `interface`
+ * This interface is the result from a config checker check() function.
+ */
+export interface ODCheckerResult {
+    valid:boolean
+    messages:ODCheckerMessage[]
+}
+
+/**## ODCheckerManager `class`
+ * This is an Open Discord checker manager.
+ * 
+ * It manages all config checkers in the bot and allows plugins to access config checkers from Open Discord & other plugins!
+ * 
+ * You can use this class to get/add a config checker (`ODChecker`) in your plugin!
+ */
+export class ODCheckerManager extends ODManager<ODChecker> {
+    /**The global temporary storage shared between all config checkers. */
+    storage: ODCheckerStorage
+    /**The class responsible for rendering the config checker report. */
+    renderer: ODCheckerRenderer
+    /**The class responsible for translating the config checker report. */
+    translation: ODCheckerTranslationRegister
+    /**Final functions are global functions executed just before the report is created. */
+    functions: ODCheckerFunctionManager
+    /**A variable containing the last result returned from `checkAll()` */
+    lastResult: ODCheckerResult|null = null
+
+    constructor(debug:ODDebugger, storage:ODCheckerStorage, renderer:ODCheckerRenderer, translation:ODCheckerTranslationRegister, functions:ODCheckerFunctionManager){
+        super(debug,"config checker")
+        this.storage = storage
+        this.renderer = renderer
+        this.translation = translation
+        this.functions = functions
+    }
+    /**Check all config checkers registered in this manager.*/
+    checkAll(sort:boolean): ODCheckerResult {
+        this.storage.reset()
+
+        let isValid = true
+        const final: ODCheckerMessage[] = []
+        
+        const checkers = this.getAll()
+        checkers.sort((a,b) => b.priority-a.priority)
+
+        checkers.forEach((checker) => {
+            const res = checker.check()
+            final.push(...res.messages)
+
+            if (!res.valid) isValid = false
+        })
+
+        this.functions.getAll().forEach((func) => {
+            const res = func.func(this,this.functions)
+            final.push(...res.messages)
+
+            if (!res.valid) isValid = false
+        })
+
+        //sort messages => (info, warning, error)
+        if (sort) final.sort((a,b) => {
+            const typeA = (a.type == "error") ? 2 : (a.type == "warning") ? 1 : 0
+            const typeB = (b.type == "error") ? 2 : (b.type == "warning") ? 1 : 0
+
+            return typeA-typeB
+        })
+
+        this.lastResult = {
+            valid:isValid,
+            messages:final
+        }
+
+        return {
+            valid:isValid,
+            messages:final
+        }
+    }
+    /**Create temporary and unlisted `ODConfig`, `ODChecker` & `ODCheckerStorage` classes. This will help you use a `ODCheckerStructure` validator without officially registering it in `opendiscord.checkers`. */
+    createTemporaryCheckerEnvironment(){
+        return new ODChecker("opendiscord:temporary-environment",new ODCheckerStorage(),0,new ODConfig("opendiscord:temporary-environment",{}),new ODCheckerStructure("opendiscord:temporary-environment",{}))
+    }
+}
+
+/**## ODCheckerStorage `class`
+ * This is an Open Discord checker storage. 
+ * 
+ * It stores temporary data to share between config checkers!
+ * (e.g. The `messages.json` needs to access the `"id"` from `options.json`)
+ * 
+ * 
+ * You can use this class when you create your own config checker implementation! (not required for using the built-in config checker)
+ */
+export class ODCheckerStorage {
+    /**This is the array that stores all the data. ❌ **(don't edit unless really needed!)***/
+    storage: {source:ODId, key:string, value:any}[] = []
+
+    /**Get data from the database (`source` => id of `ODChecker`) */
+    get(source:ODValidId, key:string): any|null {
+        const result = this.storage.find(d => (d.source.value == new ODId(source).value) && (d.key == key))
+        return (result) ? result.value : null
+    }
+    /**Add data to the database (`source` => id of `ODChecker`). This function also overwrites existing data!*/
+    set(source:ODValidId, key:string, value:any){
+        const index = this.storage.findIndex(d => (d.source.value == new ODId(source).value) && (d.key == key))
+        if (index > -1){
+            //overwrite
+            this.storage[index] = {
+                source:new ODId(source),
+                key,value
+            }
+            return true
+        }else{
+            this.storage.push({
+                source:new ODId(source),
+                key,value
+            })
+            return false
+        }
+    }
+    /**Delete data from the database (`source` => id of `ODChecker`) */
+    delete(source:ODValidId, key:string){
+        const index = this.storage.findIndex(d => (d.source.value == new ODId(source).value) && (d.key == key))
+        if (index > -1){
+            //delete
+            this.storage.splice(index,1)
+            return true
+        }else return false
+    }
+    
+    /**Reset the entire database */
+    reset(){
+        this.storage = []
+    }
+}
+
+/**## ODCheckerRenderer `class`
+ * This is an Open Discord checker renderer. 
+ * 
+ * It's responsible for rendering the config checker result in the console.
+ * This class doesn't provide any components! You need to create them by extending this class
+ * 
+ * You can use this class if you want to change how the config checker looks!
+ */
+export class ODCheckerRenderer {
+    /**Get all components */
+    getComponents(compact:boolean, renderEmpty:boolean, translation:ODCheckerTranslationRegister, data:ODCheckerResult): string[] {
+        return []
+    }
+    /**Render all components */
+    render(components:string[]){
+        if (components.length < 1) return
+        console.log("\n")
+        components.forEach((c) => {
+            console.log(c)
+        })
+        console.log("\n")
+    }
+}
+
+/**## ODCheckerTranslationRegister `class`
+ * This is an Open Discord checker translation register. 
+ * 
+ * It's used to store & manage the translation for each message from the config checker!
+ * Most translations are stored by message id, but there are some exceptions like the additional text on the checker report.
+ * 
+ * You can use this class if you want to translate your config checker messages! **This is optional & isn't required for the checker to work!**
+ */
+export class ODCheckerTranslationRegister {
+    /**This is the array that stores all the data. ❌ **(don't edit unless really needed!)***/
+    #translations: {type:"message"|"other", id:string, translation:string}[] = []
+
+    /**Get the translation from a config checker message/sentence */
+    get(type:"message"|"other", id:string): string|null {
+        const result = this.#translations.find(d => (d.id == id) && (d.type == type))
+        return (result) ? result.translation : null
+    }
+    /**Set the translation for a config checker message/sentence. This function also overwrites existing translations!*/
+    set(type:"message"|"other", id:string, translation:string){
+        const index = this.#translations.findIndex(d => (d.id == id) && (d.type == type))
+        if (index > -1){
+            //overwrite
+            this.#translations[index] = {type,id,translation}
+            return true
+        }else{
+            this.#translations.push({type,id,translation})
+            return false
+        }
+    }
+    /**Delete the translation for a config checker message/sentence. */
+    delete(type:"message"|"other", id:string){
+        const index = this.#translations.findIndex(d => (d.id == id) && (d.type == type))
+        if (index > -1){
+            //delete
+            this.#translations.splice(index,1)
+            return true
+        }else return false
+    }
+
+    /**Get all translations */
+    getAll(){
+        return this.#translations
+    }
+
+    /**Insert the translation params into the text. */
+    insertTranslationParams(text:string, translationParams:string[]){
+        translationParams.forEach((value,index) => {
+            text = text.replace(`{${index}}`,value)
+        })
+        return text
+    }
+    /**A shortcut to copy translations from the `ODLanguageManager` to `ODCheckerTranslationRegister` */
+    quickTranslate(manager:ODLanguageManager, translationId:string, type:"other"|"message", id:string){
+        const translation = manager.getTranslation(translationId)
+        if (translation) this.set(type,id,translation)
+    }
+}
+
+/**## ODCheckerFunctionCallback `type`
+ * This is the function used in the `ODCheckerFunction` class.
+ */
+export type ODCheckerFunctionCallback = (manager:ODCheckerManager, functions:ODCheckerFunctionManager) => ODCheckerResult
+
+/**## ODCheckerFunction `class`
+ * This is an Open Discord config checker function.
+ * 
+ * It is a global function that will be executed after all config checkers. It can do additional checks for invalid/missing configurations.
+ * It's mostly used for things that need to be checked globally!
+ */
+export class ODCheckerFunction extends ODManagerData {
+    /**The function which will be executed globally after all config checkers. */
+    func: ODCheckerFunctionCallback
+
+    constructor(id:ODValidId, func:ODCheckerFunctionCallback){
+        super(id)
+        this.func = func
+    }
+}
+
+/**## ODCheckerFunctionManager `class`
+ * This is an Open Discord config checker function manager.
+ * 
+ * It manages all `ODCheckerFunction`'s and it has some extra shortcuts for frequently used methods.
+ */
+export class ODCheckerFunctionManager extends ODManager<ODCheckerFunction> {
+    constructor(debug:ODDebugger){
+        super(debug,"config checker function")
+    }
+
+    /**A shortcut to create a warning, info or error message */
+    createMessage(checkerId:ODValidId, id:ODValidId, filepath:string, type:"info"|"warning"|"error", message:string, locationTrace:ODCheckerLocationTrace, docs:string|null, translationParams:string[], locationId:ODId, locationDocs:string|null): ODCheckerMessage {
+        return {
+            checkerId:new ODId(checkerId),
+            messageId:new ODId(id),
+            locationId,
+
+            type,message,
+            path:this.locationTraceToString(locationTrace),
+            filepath,
+            translationParams,
+            
+            messageDocs:docs,
+            locationDocs
+        }
+    }
+    /**Create a string from the location trace (path)*/
+    locationTraceToString(trace:ODCheckerLocationTrace){
+        const final: ODCheckerLocationTrace = []
+        trace.forEach((t) => {
+            if (typeof t == "number"){
+                final.push(`:${t}`)
+            }else{
+                final.push(`."${t}"`)
+            }
+        })
+        return final.join("").substring(1)
+    }
+    /**De-reference the locationTrace array. Use this before adding a value to the array*/
+    locationTraceDeref(trace:ODCheckerLocationTrace): ODCheckerLocationTrace {
+        return JSON.parse(JSON.stringify(trace))
+    }
+}
+
+/**## ODCheckerLocationTrace `type`
+ * This type is an array of strings & numbers which represents the location trace from the config checker.
+ * It's used to generate a path to the error (e.g. `"abc"."efg".1."something"`)
+ */
+export type ODCheckerLocationTrace = (string|number)[]
+
+/**## ODCheckerOptions `interface`
+ * This interface contains all optional properties to customise in the `ODChecker` class.
+ */
+export interface ODCheckerOptions {
+    /**The name of this config in the Interactive Setup CLI. */
+    cliDisplayName?:string
+    /**The description of this config in the Interactive Setup CLI. */
+    cliDisplayDescription?:string
+} 
+
+/**## ODChecker `class`
+ * This is an Open Discord config checker.
+ * 
+ * It checks a specific config file for invalid/missing configurations. This data can then be used to show to the user what's wrong!
+ * You can check for example if a string is longer/shorter than a certain amount of characters & more!
+ * 
+ * You can use this class when you create your own custom config file & you want to check it for syntax errors.
+ */
+export class ODChecker extends ODManagerData {
+    /**The storage of this checker (reference for `ODCheckerManager.storage`) */
+    storage: ODCheckerStorage
+    /**The higher the priority, the faster it gets checked! */
+    priority: number
+    /**The config file that needs to be checked */
+    config: ODConfig
+    /**The structure of the config file */
+    structure: ODCheckerStructure
+    /**Temporary storage for all error messages from the check() method (not recommended to use) */
+    messages: ODCheckerMessage[] = []
+    /**Temporary storage for the quit status from the check() method (not recommended to use) */
+    quit: boolean = false
+    /**All additional properties of this config checker. */
+    options: ODCheckerOptions
+
+    constructor(id:ODValidId, storage: ODCheckerStorage, priority:number, config:ODConfig, structure:ODCheckerStructure, options?:ODCheckerOptions){
+        super(id)
+        this.storage = storage
+        this.priority = priority
+        this.config = config
+        this.structure = structure
+        this.options = options ?? {}
+    }
+
+    /**Get a human-readable number string. */
+    #ordinalNumber(num:number){
+        const i = Math.abs(Math.round(num))
+        const cent = i % 100
+        if (cent >= 10 && cent <= 20) return i+'th'
+        const dec = i % 10
+        if (dec === 1) return i+'st'
+        if (dec === 2) return i+'nd'
+        if (dec === 3) return i+'rd'
+        return i+'th'
+    }
+    /**Run this checker. Returns all errors*/
+    check(): ODCheckerResult {
+        this.messages = []
+        this.quit = false
+
+        this.structure.check(this,this.config.data,[])
+        return {
+            valid:!this.quit,
+            messages:this.messages
+        }
+    }
+    /**Create a string from the location trace/path in a human readable format. */
+    locationTraceToString(trace:ODCheckerLocationTrace){
+        const final: ODCheckerLocationTrace = []
+        trace.forEach((t) => {
+            if (typeof t == "number"){
+                final.push(`:(${this.#ordinalNumber(t+1)})`)
+            }else{
+                final.push(`."${t}"`)
+            }
+        })
+        return final.join("").substring(1)
+    }
+    /**De-reference the locationTrace array. Use this before adding a value to the array*/
+    locationTraceDeref(trace:ODCheckerLocationTrace): ODCheckerLocationTrace {
+        return JSON.parse(JSON.stringify(trace))
+    }
+
+    /**A shortcut to create a warning, info or error message */
+    createMessage(id:ODValidId, type:"info"|"warning"|"error", message:string, locationTrace:ODCheckerLocationTrace, docs:string|null, translationParams:string[], locationId:ODId, locationDocs:string|null){
+        if (type == "error") this.quit = true
+        this.messages.push({
+            checkerId:this.id,
+            messageId:new ODId(id),
+            locationId,
+
+            type,message,
+            path:this.locationTraceToString(locationTrace),
+            filepath:this.config.path,
+            translationParams,
+            
+            messageDocs:docs,
+            locationDocs
+        })
+    }
+}
+
+/**## ODCheckerMessage `interface`
+ * This interface is an object which has all variables required for a config checker message!
+ */
+export interface ODCheckerMessage {
+    checkerId:ODId,
+    messageId:ODId,
+    locationId:ODId,
+
+    type:"info"|"warning"|"error",
+    message:string,
+    path:string,
+    filepath:string,
+    translationParams:string[],
+
+    messageDocs:string|null,
+    locationDocs:string|null
+}
+
+/**## ODCheckerStructureOptions `interface`
+ * This interface has the basic options for the `ODCheckerStructure`!
+ */
+export interface ODCheckerStructureOptions {
+    /**Add a custom checker function. Returns `true` when valid. */
+    custom?:(checker:ODChecker, value:ODValidJsonType, locationTrace:ODCheckerLocationTrace, locationId:ODId, locationDocs:string|null) => boolean,
+    /**Set the url to the documentation of this variable. */
+    docs?:string,
+    /**The name of this config in the Interactive Setup CLI. */
+    cliDisplayName?:string
+    /**The description of this config in the Interactive Setup CLI. */
+    cliDisplayDescription?:string
+    /**Hide the description of this config in the Interactive Setup CLI parent view/list. */
+    cliHideDescriptionInParent?:boolean
+    /**The default value of this variable when creating it in the Interactive Setup CLI. When not specified, the user will be asked to insert a value. */
+    cliInitDefaultValue?:ODValidJsonType
+}
+
+/**## ODCheckerStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for a single variable in a config file, customise it in the settings!
+ * If you want prebuilt checkers (for strings, booleans, numbers, ...), check the other `ODCheckerStructure`'s!
+ * 
+ * **Not recommended to use!** It's recommended to extend from another `ODConfigCheckerStructure` class!
+ */
+export class ODCheckerStructure {
+    /**The id of this checker structure */
+    id: ODId
+    /**The options for this checker structure */
+    options: ODCheckerStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerStructureOptions){
+        this.id = new ODId(id)
+        this.options = options
+    }
+
+    /**Check a variable if it matches all settings in this checker. This function is automatically executed by Open Discord! */
+    check(checker:ODChecker, value:ODValidJsonType, locationTrace:ODCheckerLocationTrace): boolean {
+        if (typeof this.options.custom != "undefined"){
+            return this.options.custom(checker,value,locationTrace,this.id,(this.options.docs ?? null))
+        }else return true
+    }
+}
+
+/**## ODCheckerObjectStructureOptions `interface`
+ * This interface has the options for `ODCheckerObjectStructure`!
+ */
+export interface ODCheckerObjectStructureOptions extends ODCheckerStructureOptions {
+    /**Add a checker for a property in an object (can also be optional) */
+    children:{key:string, priority?:number, optional?:boolean, cliHideInEditMode?:boolean, checker:ODCheckerStructure}[],
+    /**A list of keys to skip when creating this object with the Interactive Setup CLI. The default value of these properties will be used instead. */
+    cliInitSkipKeys?:string[],
+    /**The key of a (primitive) property in this object to show the value of in the Interactive Setup CLI when listed in an array. */
+    cliDisplayKeyInParentArray?:string,
+    /**A list of additional (primitive) property keys in this object to show the value of in the Interactive Setup CLI when listed in an array. */
+    cliDisplayAdditionalKeysInParentArray?:string[]
+}
+
+/**## ODCheckerObjectStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for an object variable in a config file, customise it in the settings!
+ * A checker for the children can be set in the settings.
+ */
+export class ODCheckerObjectStructure extends ODCheckerStructure {
+    declare options: ODCheckerObjectStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerObjectStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:object, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+
+        //check type & options
+        if (typeof value != "object"){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: object!",lt,null,["object"],this.id,(this.options.docs ?? null))
+            return false
+        }
+        
+        //sort children
+        if (typeof this.options.children == "undefined") return super.check(checker,value,locationTrace)
+        const sortedChildren = this.options.children.sort((a,b) => {
+            if ((a.priority ?? 0) < (b.priority ?? 0)) return -1
+            else if ((a.priority ?? 0) > (b.priority ?? 0)) return 1
+            else return 0
+        })
+
+        //check children
+        let localQuit = false
+        sortedChildren.forEach((child) => {
+            const localLt = checker.locationTraceDeref(lt)
+            localLt.push(child.key)
+
+            if (typeof value[child.key] == "undefined"){
+                if (!child.optional){
+                    localQuit = true
+                    checker.createMessage("opendiscord:property-missing","error",`The property "${child.key}" is mising from this object!`,lt,null,[`"${child.key}"`],this.id,(this.options.docs ?? null))
+                }else{
+                    checker.createMessage("opendiscord:property-optional","info",`The property "${child.key}" is optional in this object!`,lt,null,[`"${child.key}"`],this.id,(this.options.docs ?? null))
+                }
+            }else if (!child.checker.check(checker,value[child.key],localLt)) localQuit = true
+        })
+
+        //do local quit or check custom function
+        if (localQuit) return false
+        else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerStringStructureOptions `interface`
+ * This interface has the options for `ODCheckerStringStructure`!
+ */
+export interface ODCheckerStringStructureOptions extends ODCheckerStructureOptions {
+    /**The minimum length of this string */
+    minLength?:number,
+    /**The maximum length of this string */
+    maxLength?:number,
+    /**Set the required length of this string */
+    length?:number,
+    /**This string needs to start with ... */
+    startsWith?:string,
+    /**This string needs to end with ... */
+    endsWith?:string,
+    /**This string needs to contain ... */
+    contains?:string,
+    /**This string is not allowed to contain ... */
+    invertedContains?:string,
+    /**You need to choose between ... */
+    choices?:string[],
+    /**This string needs to be in lowercase. */
+    lowercaseOnly?:boolean,
+    /**This string needs to be in uppercase. */
+    uppercaseOnly?:boolean,
+    /**This string shouldn't contain any special characters (allowed: A-Z, a-z, 0-9, space, a few punctuation marks, ...). */
+    noSpecialCharacters?:boolean,
+    /**Do not allow any spaces in this string. */
+    withoutSpaces?:boolean,
+    /**Give a warning when a sentence doesn't start with a capital letter. Or require every word to start with a capital letter. (Ignores numbers, unicode characters, ...) */
+    capitalLetterWarning?:false|"sentence"|"word"
+    /**Give a warning when a sentence doesn't end with a punctuation letter (.,?!) */
+    punctuationWarning?:boolean
+    /**The string needs to match this regex */
+    regex?:RegExp,
+    /**Provide an optional list for autocomplete when using the Interactive Setup CLI. Defaults to the `choices` option. */
+    cliAutocompleteList?:string[],
+    /**Dynamically provide a list for autocomplete items when using the Interactive Setup CLI. */
+    cliAutocompleteFunc?:() => Promise<string[]|null>
+}
+
+/**## ODCheckerStringStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for a string variable in a config file, customise it in the settings!
+ */
+export class ODCheckerStringStructure extends ODCheckerStructure {
+    declare options: ODCheckerStringStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerStringStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:string, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+
+        //check type & options
+        if (typeof value != "string"){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: string!",lt,null,["string"],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.minLength != "undefined" && value.length < this.options.minLength){
+            checker.createMessage("opendiscord:string-too-short","error",`This string can't be shorter than ${this.options.minLength} characters!`,lt,null,[this.options.minLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.maxLength != "undefined" && value.length > this.options.maxLength){
+            checker.createMessage("opendiscord:string-too-long","error",`This string can't be longer than ${this.options.maxLength} characters!`,lt,null,[this.options.maxLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.length != "undefined" && value.length !== this.options.length){
+            checker.createMessage("opendiscord:string-length-invalid","error",`This string needs to be ${this.options.length} characters long!`,lt,null,[this.options.length.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.startsWith != "undefined" && !value.startsWith(this.options.startsWith)){
+            checker.createMessage("opendiscord:string-starts-with","error",`This string needs to start with "${this.options.startsWith}"!`,lt,null,[`"${this.options.startsWith}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.endsWith != "undefined" && !value.endsWith(this.options.endsWith)){
+            checker.createMessage("opendiscord:string-ends-with","error",`This string needs to end with "${this.options.endsWith}"!`,lt,null,[`"${this.options.endsWith}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.contains != "undefined" && !value.includes(this.options.contains)){
+            checker.createMessage("opendiscord:string-contains","error",`This string needs to contain "${this.options.contains}"!`,lt,null,[`"${this.options.contains}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.invertedContains != "undefined" && value.includes(this.options.invertedContains)){
+            checker.createMessage("opendiscord:string-inverted-contains","error",`This string is not allowed to contain "${this.options.invertedContains}"!`,lt,null,[`"${this.options.invertedContains}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.choices != "undefined" && !this.options.choices.includes(value)){
+            checker.createMessage("opendiscord:string-choices","error",`This string can only be one of the following values: "${this.options.choices.join(`", "`)}"!`,lt,null,[`"${this.options.choices.join(`", "`)}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (this.options.lowercaseOnly && value !== value.toLowerCase()){
+            checker.createMessage("opendiscord:string-lowercase","error",`This string must be written in lowercase only!`,lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (this.options.uppercaseOnly && value !== value.toUpperCase()){
+            checker.createMessage("opendiscord:string-uppercase","error",`This string must be written in uppercase only!`,lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (this.options.noSpecialCharacters && !/^[A-Za-z0-9 ]*$/.test(value)){
+            checker.createMessage("opendiscord:string-special-characters","error",`This string is not allowed to contain any special characters! (a-z, 0-9 & space only)`,lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (this.options.withoutSpaces && value.includes(" ")){
+            checker.createMessage("opendiscord:string-no-spaces","error",`This string is not allowed to contain spaces!`,lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.regex != "undefined" && !this.options.regex.test(value)){
+            checker.createMessage("opendiscord:string-regex","error","This string is invalid!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else{
+            //warnings
+            if ((this.options.capitalLetterWarning == "word" && !value.split(" ").every((word) => word.length == 0 || /^[^a-z].*/.test(word)))) checker.createMessage("opendiscord:string-capital-word","warning",`It's recommended that each word in this string starts with a capital letter!`,lt,null,[],this.id,(this.options.docs ?? null))
+            if ((this.options.capitalLetterWarning == "sentence" && !value.split(/ *[.?!] */).every((sentence) => sentence.length == 0 || /^[^a-z].*/.test(sentence)))) checker.createMessage("opendiscord:string-capital-sentence","warning",`It looks like some sentences in this string don't start with a capital letter!`,lt,null,[],this.id,(this.options.docs ?? null))
+            if (this.options.punctuationWarning && value.length > 0 && (!value.endsWith(".") && !value.endsWith("?") && !value.endsWith("!") && !value.endsWith("'") && !value.endsWith('"') && !value.endsWith(",") && !value.endsWith(";") && !value.endsWith(":") && !value.endsWith("="))) checker.createMessage("opendiscord:string-punctuation","warning",`It looks like the sentence in this string doesn't end with a punctuation mark!`,lt,null,[],this.id,(this.options.docs ?? null))
+            
+            return super.check(checker,value,locationTrace)
+        }
+    }
+}
+
+/**## ODCheckerNumberStructureOptions `interface`
+ * This interface has the options for `ODCheckerNumberStructure`!
+ */
+export interface ODCheckerNumberStructureOptions extends ODCheckerStructureOptions {
+    /**Is `NaN` (not a number) allowed? (`false` by default) */
+    nanAllowed?:boolean
+    /**The minimum length of this number */
+    minLength?:number,
+    /**The maximum length of this number */
+    maxLength?:number,
+    /**Set the required length of this number */
+    length?:number,
+    /**The minimum value of this number */
+    min?:number,
+    /**The maximum value of this number */
+    max?:number,
+    /**This number is required to match the value */
+    is?:number,
+    /**Only allow a multiple of ... starting at `this.offset` or 0 */
+    step?:number,
+    /**The offset for the step function. */
+    offset?:number,
+    /**This number needs to start with ... */
+    startsWith?:string,
+    /**This number needs to end with ... */
+    endsWith?:string,
+    /**This number needs to contain ... */
+    contains?:string,
+    /**This number is not allowed to contain ... */
+    invertedContains?:string,
+    /**You need to choose between ... */
+    choices?:number[],
+    /**Are numbers with a decimal value allowed? */
+    floatAllowed?:boolean,
+    /**Are negative numbers allowed (without zero) */
+    negativeAllowed?:boolean,
+    /**Are positive numers allowed (without zero) */
+    positiveAllowed?:boolean,
+    /**Is zero allowed? */
+    zeroAllowed?:boolean
+}
+
+/**## ODCheckerNumberStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for a number variable in a config file, customise it in the settings!
+ */
+export class ODCheckerNumberStructure extends ODCheckerStructure {
+    declare options: ODCheckerNumberStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerNumberStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:number, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+
+        //offset for step
+        const stepOffset = (typeof this.options.offset != "undefined") ? this.options.offset : 0
+
+        //check type & options
+        if (typeof value != "number"){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: number!",lt,null,["number"],this.id,(this.options.docs ?? null))
+            return false
+        }else if (!this.options.nanAllowed && isNaN(value)){
+            checker.createMessage("opendiscord:number-nan","error",`This number can't be NaN (Not A Number)!`,lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.minLength != "undefined" && value.toString().length < this.options.minLength){
+            checker.createMessage("opendiscord:number-too-short","error",`This number can't be shorter than ${this.options.minLength} characters!`,lt,null,[this.options.minLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.maxLength != "undefined" && value.toString().length > this.options.maxLength){
+            checker.createMessage("opendiscord:number-too-long","error",`This number can't be longer than ${this.options.maxLength} characters!`,lt,null,[this.options.maxLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.length != "undefined" && value.toString().length !== this.options.length){
+            checker.createMessage("opendiscord:number-length-invalid","error",`This number needs to be ${this.options.length} characters long!`,lt,null,[this.options.length.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.min != "undefined" && value < this.options.min){
+            checker.createMessage("opendiscord:number-too-small","error",`This number needs to be at least ${this.options.min}!`,lt,null,[this.options.min.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.max != "undefined" && value > this.options.max){
+            checker.createMessage("opendiscord:number-too-large","error",`This number needs to be at most ${this.options.max}!`,lt,null,[this.options.max.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.is != "undefined" && value == this.options.is){
+            checker.createMessage("opendiscord:number-not-equal","error",`This number needs to be ${this.options.is}!`,lt,null,[this.options.is.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.step != "undefined" && ((value - stepOffset) % this.options.step) !== 0){
+            if (stepOffset > 0) checker.createMessage("opendiscord:number-step-offset","error",`This number needs to be a multiple of ${this.options.step} starting with ${stepOffset}!`,lt,null,[this.options.step.toString(),stepOffset.toString()],this.id,(this.options.docs ?? null))
+            else checker.createMessage("opendiscord:number-step","error",`This number needs to be a multiple of ${this.options.step}!`,lt,null,[this.options.step.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.startsWith != "undefined" && !value.toString().startsWith(this.options.startsWith)){
+            checker.createMessage("opendiscord:number-starts-with","error",`This number needs to start with "${this.options.startsWith}"!`,lt,null,[`"${this.options.startsWith}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.endsWith != "undefined" && !value.toString().endsWith(this.options.endsWith)){
+            checker.createMessage("opendiscord:number-ends-with","error",`This number needs to end with "${this.options.endsWith}"!`,lt,null,[`"${this.options.endsWith}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.contains != "undefined" && !value.toString().includes(this.options.contains)){
+            checker.createMessage("opendiscord:number-contains","error",`This number needs to contain "${this.options.contains}"!`,lt,null,[`"${this.options.contains}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.invertedContains != "undefined" && value.toString().includes(this.options.invertedContains)){
+            checker.createMessage("opendiscord:number-inverted-contains","error",`This number is not allowed to contain "${this.options.invertedContains}"!`,lt,null,[`"${this.options.invertedContains}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.choices != "undefined" && !this.options.choices.includes(value)){
+            checker.createMessage("opendiscord:number-choices","error",`This number can only be one of the following values: "${this.options.choices.join(`", "`)}"!`,lt,null,[`"${this.options.choices.join(`", "`)}"`],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.floatAllowed != "undefined" && !this.options.floatAllowed && (value % 1) !== 0){
+            checker.createMessage("opendiscord:number-float","error","This number can't be a decimal!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.negativeAllowed != "undefined" && !this.options.negativeAllowed && value < 0){
+            checker.createMessage("opendiscord:number-negative","error","This number can't be negative!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.positiveAllowed != "undefined" && !this.options.positiveAllowed && value > 0){
+            checker.createMessage("opendiscord:number-positive","error","This number can't be positive!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.zeroAllowed != "undefined" && !this.options.zeroAllowed && value === 0){
+            checker.createMessage("opendiscord:number-zero","error","This number can't be zero!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerBooleanStructureOptions `interface`
+ * This interface has the options for `ODCheckerBooleanStructure`!
+ */
+export interface ODCheckerBooleanStructureOptions extends ODCheckerStructureOptions {
+    /**Is `true` allowed? */
+    trueAllowed?:boolean,
+    /**Is `false` allowed? */
+    falseAllowed?:boolean
+}
+
+/**## ODCheckerBooleanStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for a boolean variable in a config file, customise it in the settings!
+ */
+export class ODCheckerBooleanStructure extends ODCheckerStructure {
+    declare options: ODCheckerBooleanStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerBooleanStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:boolean, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+
+        //check type & options
+        if (typeof value != "boolean"){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: boolean!",lt,null,["boolean"],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.trueAllowed != "undefined" && !this.options.trueAllowed && value == true){
+            checker.createMessage("opendiscord:boolean-true","error","This boolean can't be true!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.falseAllowed != "undefined" && !this.options.falseAllowed && value == false){
+            checker.createMessage("opendiscord:boolean-false","error","This boolean can't be false!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerArrayStructureOptions `interface`
+ * This interface has the options for `ODCheckerArrayStructure`!
+ */
+export interface ODCheckerArrayStructureOptions extends ODCheckerStructureOptions {
+    /**The checker for all the properties in this array */
+    propertyChecker?:ODCheckerStructure,
+    /**Don't allow this array to be empty */
+    disableEmpty?:boolean,
+    /**This array is required to be empty */
+    emptyRequired?:boolean,
+    /**The minimum length of this array */
+    minLength?:number,
+    /**The maximum length of this array */
+    maxLength?:number,
+    /**The length of the array needs to be the same as this value */
+    length?:number,
+    /**Allow double values (only for `string`, `number` & `boolean`) */
+    allowDoubles?:boolean
+    /**Only allow these types in the array (for multi-type propertyCheckers) */
+    allowedTypes?:("string"|"number"|"boolean"|"null"|"array"|"object"|"other")[],
+    /**The name of the properties inside this array. Used in the GUI of the Interactive Setup CLI. */
+    cliDisplayPropertyName?:string
+}
+
+/**## ODCheckerArrayStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for an array variable in a config file, customise it in the settings!
+ */
+export class ODCheckerArrayStructure extends ODCheckerStructure {
+    declare options: ODCheckerArrayStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerArrayStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:Array<any>, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+        
+        if (!Array.isArray(value)){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: array!",lt,null,["array"],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.disableEmpty != "undefined" && this.options.disableEmpty && value.length == 0){
+            checker.createMessage("opendiscord:array-empty-disabled","error","This array isn't allowed to be empty!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.emptyRequired != "undefined" && this.options.emptyRequired && value.length != 0){
+            checker.createMessage("opendiscord:array-empty-required","error","This array is required to be empty!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.minLength != "undefined" && value.length < this.options.minLength){
+            checker.createMessage("opendiscord:array-too-short","error",`This array needs to have a length of at least ${this.options.minLength}!`,lt,null,[this.options.minLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.maxLength != "undefined" && value.length > this.options.maxLength){
+            checker.createMessage("opendiscord:array-too-long","error",`This array needs to have a length of at most ${this.options.maxLength}!`,lt,null,[this.options.maxLength.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.length != "undefined" && value.length == this.options.length){
+            checker.createMessage("opendiscord:array-length-invalid","error",`This array needs to have a length of ${this.options.length}!`,lt,null,[this.options.length.toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.allowedTypes != "undefined" && !this.#arrayAllowedTypesCheck(value,this.options.allowedTypes)){
+            checker.createMessage("opendiscord:array-invalid-types","error",`This array can only contain the following types: ${this.options.allowedTypes.join(", ")}!`,lt,null,[this.options.allowedTypes.join(", ").toString()],this.id,(this.options.docs ?? null))
+            return false
+        }else if (typeof this.options.allowDoubles != "undefined" && !this.options.allowDoubles && this.#arrayHasDoubles(value)){
+            checker.createMessage("opendiscord:array-double","error","This array doesn't allow the same value twice!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else{
+            //check all properties
+            let localQuit = false
+            if (this.options.propertyChecker) value.forEach((property,index) => {
+                if (!this.options.propertyChecker) return
+                
+                const localLt = checker.locationTraceDeref(lt)
+                localLt.push(index)
+
+                if (!this.options.propertyChecker.check(checker,property,localLt)) localQuit = true
+            })
+
+            //return false if invalid properties
+            if (localQuit){
+                checker.quit = true
+                return false
+            }else return super.check(checker,value,locationTrace)
+        }
+    }
+
+    /**Check this array for the allowed types */
+    #arrayAllowedTypesCheck(array:any[],allowedTypes:("string"|"number"|"boolean"|"null"|"array"|"object"|"other")[]): boolean {
+        //return TRUE if ALL values are valid
+        return !array.some((value) => {
+            if (allowedTypes.includes("string") && typeof value == "string"){
+                return false //this value is valid
+            }else if (allowedTypes.includes("number") && typeof value == "number"){
+                return false //this value is valid
+            }else if (allowedTypes.includes("boolean") && typeof value == "boolean"){
+                return false //this value is valid
+            }else if (allowedTypes.includes("object") && typeof value == "object"){
+                return false //this value is valid
+            }else if (allowedTypes.includes("array") && Array.isArray(value)){
+                return false //this value is valid
+            }else if (allowedTypes.includes("null") && value === null){
+                return false //this value is valid
+            }else if (allowedTypes.includes("other")){
+                return false //this value is valid
+            }else{
+                return true //this value is invalid
+            }
+        })
+    }
+    /**Check this array for doubles */
+    #arrayHasDoubles(array:any[]): boolean {
+        const alreadyFound: string[] = []
+        let hasDoubles = false
+        array.forEach((value) => {
+            if (alreadyFound.includes(value)) hasDoubles = true
+            else alreadyFound.push(value)
+        })
+
+        return hasDoubles
+    }
+}
+
+/**## ODCheckerNullStructureOptions `interface`
+ * This interface has the options for `ODCheckerNullStructure`!
+ */
+export interface ODCheckerNullStructureOptions extends ODCheckerStructureOptions {
+    /**Is the value allowed to be null */
+    nullAllowed?:boolean
+}
+
+/**## ODCheckerNullStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will check for a null variable in a config file, customise it in the settings!
+ */
+export class ODCheckerNullStructure extends ODCheckerStructure {
+    declare options: ODCheckerNullStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerNullStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:null, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+
+        //check type & options
+        if (typeof this.options.nullAllowed != "undefined" && !this.options.nullAllowed && value == null){
+            checker.createMessage("opendiscord:null-invalid","error","This property can't be null!",lt,null,[],this.id,(this.options.docs ?? null))
+            return false
+        }else if (value !== null){
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: null!",lt,null,["null"],this.id,(this.options.docs ?? null))
+            return false
+        }else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerTypeSwitchStructureOptions `interface`
+ * This interface has the options for `ODCheckerTypeSwitchStructure`!
+ */
+export interface ODCheckerTypeSwitchStructureOptions extends ODCheckerStructureOptions {
+    /**A checker that will always run (replaces all other checkers) */
+    all?:ODCheckerStructure,
+    /**A checker when the property is a string */
+    string?:ODCheckerStringStructure,
+    /**A checker when the property is a number */
+    number?:ODCheckerNumberStructure,
+    /**A checker when the property is a boolean */
+    boolean?:ODCheckerBooleanStructure,
+    /**A checker when the property is null */
+    null?:ODCheckerNullStructure,
+    /**A checker when the property is an array */
+    array?:ODCheckerArrayStructure,
+    /**A checker when the property is an object */
+    object?:ODCheckerObjectStructure,
+    /**A checker when the property is something else */
+    other?:ODCheckerStructure,
+    /**A list of allowed types */
+    allowedTypes:("string"|"number"|"boolean"|"null"|"array"|"object"|"other")[]
+}
+
+/**## ODCheckerTypeSwitchStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will switch checkers based on the type of the variable in a config file, customise it in the settings!
+ */
+export class ODCheckerTypeSwitchStructure extends ODCheckerStructure {
+    declare options: ODCheckerTypeSwitchStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerTypeSwitchStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:any, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+        
+        if (this.options.all){
+            return this.options.all.check(checker,value,lt)
+
+        }else if (this.options.string && typeof value == "string"){
+            return this.options.string.check(checker,value,lt)
+
+        }else if (this.options.number && typeof value == "number"){
+            return this.options.number.check(checker,value,lt)
+
+        }else if (this.options.boolean && typeof value == "boolean"){
+            return this.options.boolean.check(checker,value,lt)
+
+        }else if (this.options.array && Array.isArray(value)){
+            return this.options.array.check(checker,value,lt)
+            
+        }else if (this.options.null && value === null){
+            return this.options.null.check(checker,value,lt)
+            
+        }else if (this.options.object && typeof value == "object"){
+            return this.options.object.check(checker,value,lt)
+
+        }else if (this.options.other){
+            return this.options.other.check(checker,value,lt)
+
+        }else if (this.options.allowedTypes && this.options.allowedTypes.length > 0){
+            checker.createMessage("opendiscord:switch-invalid-type","error",`This needs to be one of the following types: ${this.options.allowedTypes.join(", ")}!`,lt,null,[this.options.allowedTypes.join(", ")],this.id,(this.options.docs ?? null))
+            return false
+        }else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerObjectSwitchStructureOptions `interface`
+ * This interface has the options for `ODCheckerObjectSwitchStructure`!
+ */
+export interface ODCheckerObjectSwitchStructureOptions extends ODCheckerStructureOptions {
+    /**An array of object checkers with their name, properties & priority. */
+    objects:{
+        /**The properties to match for this checker to be used. */
+        properties:{key:string, value:boolean|string|number}[],
+        /**The name for this object type (used in rendering) */
+        name:string,
+        /**The higher the priority, the earlier this checker will be tested. */
+        priority:number,
+        /**The object checker used once the properties have been matched. */
+        checker:ODCheckerObjectStructure
+    }[]
+}
+
+/**## ODCheckerObjectSwitchStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will switch object checkers based on a variable match in one of the objects, customise it in the settings!
+ */
+export class ODCheckerObjectSwitchStructure extends ODCheckerStructure {
+    declare options: ODCheckerObjectSwitchStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerObjectSwitchStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:object, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+        
+        if (this.options.objects){
+            //check type & options
+            if (typeof value != "object"){
+                checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: object!",lt,null,["object"],this.id,(this.options.docs ?? null))
+                return false
+            }
+            
+            //sort objects
+            const sortedObjects = this.options.objects.sort((a,b) => {
+                if (a.priority < b.priority) return -1
+                else if (a.priority > b.priority) return 1
+                else return 0
+            })
+
+
+            //check objects
+            let localQuit = false
+            let didSelectObject = false
+            sortedObjects.forEach((obj) => {
+                if (!obj.properties.some((p) => value[p.key] !== p.value)){
+                    didSelectObject = true
+                    if (!obj.checker.check(checker,value,lt)) localQuit = true
+                }
+            })
+
+            //do local quit or check custom function
+            if (!didSelectObject){
+                checker.createMessage("opendiscord:object-switch-invalid-type","error",`This object needs to be one of the following types: ${this.options.objects.map((obj) => obj.name).join(", ")}!`,lt,null,[this.options.objects.map((obj) => obj.name).join(", ")],this.id,(this.options.docs ?? null))
+                return false
+            }else if (localQuit){
+                return false
+            }else return super.check(checker,value,locationTrace)
+        }else return super.check(checker,value,locationTrace)
+    }
+}
+
+/**## ODCheckerEnabledObjectStructureOptions `interface`
+ * This interface has the options for `ODCheckerEnabledObjectStructure`!
+ */
+export interface ODCheckerEnabledObjectStructureOptions extends ODCheckerStructureOptions {
+    /**The name of the property to match the `enabledValue`. */
+    property:string,
+    /**The value of the property to be enabled. (e.g. `true`) */
+    enabledValue:boolean|string|number,
+    /**The object checker to use once the property has been matched. */
+    checker:ODCheckerObjectStructure
+}
+
+/**## ODCheckerEnabledObjectStructure `class`
+ * This is an Open Discord config checker structure.
+ * 
+ * This class will enable an object checker based on a variable match in the object, customise it in the settings!
+ */
+export class ODCheckerEnabledObjectStructure extends ODCheckerStructure {
+    declare options: ODCheckerEnabledObjectStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerEnabledObjectStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:object, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+        
+        if (typeof value != "object"){
+            //value isn't an object
+            checker.createMessage("opendiscord:invalid-type","error","This property needs to be the type: object!",lt,null,["object"],this.id,(this.options.docs ?? null))
+            return false
+
+        }else if (this.options.property && typeof value[this.options.property] == "undefined"){
+            //property doesn't exist
+            checker.createMessage("opendiscord:property-missing","error",`The property "${this.options.property}" is mising from this object!`,lt,null,[`"${this.options.property}"`],this.id,(this.options.docs ?? null))
+            return false
+
+        }else if (this.options.property && value[this.options.property] === (typeof this.options.enabledValue == "undefined" ? true : this.options.enabledValue)){
+            //this object is enabled
+            if (this.options.checker) return this.options.checker.check(checker,value,lt)
+            else return super.check(checker,value,locationTrace)
+
+        }else{
+            //this object is disabled
+            if (this.options.property) checker.createMessage("opendiscord:object-disabled","info",`This object is disabled, enable it using "${this.options.property}"!`,lt,null,[`"${this.options.property}"`],this.id,(this.options.docs ?? null))
+            return super.check(checker,value,locationTrace)
+        }
+    }
+}
+
+/**## ODCheckerCustomStructure_DiscordId `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for discord ids (channel, user, role, ...)**
+ */
+export class ODCheckerCustomStructure_DiscordId extends ODCheckerStringStructure {
+    /**The type of id (used in rendering) */
+    readonly type: ODDiscordIdType
+    /**Is this id allowed to be empty */
+    readonly emptyAllowed: boolean
+    /**Extra matches (value will also be valid when one of these options match) */
+    readonly extraOptions: string[]
+
+    constructor(id:ODValidId, type:ODDiscordIdType, emptyAllowed:boolean, extraOptions:string[], options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+
+            if (typeof value != "string") return false
+            else if ((!emptyAllowed && value.length < 15) || value.length > 50 || !/^[0-9]*$/.test(value)){
+                if (!(extraOptions.length > 0 && extraOptions.some((opt) => opt == value))){
+                    //value is not an id & not one of the extra options
+                    if (extraOptions.length > 0) checker.createMessage("opendiscord:discord-invalid-id-options","error",`This is an invalid discord ${type} id! You can also use one of these: ${extraOptions.join(", ")}!`,lt,null,[type,extraOptions.join(", ")],this.id,(this.options.docs ?? null))
+                    else checker.createMessage("opendiscord:discord-invalid-id","error",`This is an invalid discord ${type} id!`,lt,null,[type],this.id,(this.options.docs ?? null))
+                return false
+                }else return true
+            }
+            return true
+        }
+        super(id,newOptions)
+        this.type = type
+        this.emptyAllowed = emptyAllowed
+        this.extraOptions = extraOptions
+    }
+}
+
+/**## ODCheckerCustomStructure_DiscordIdArray `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for discord id arrays (channel, user, role, ...)**
+ */
+export class ODCheckerCustomStructure_DiscordIdArray extends ODCheckerArrayStructure {
+    /**The type of id (used in rendering) */
+    readonly type: ODDiscordIdType
+    /**Extra matches (value will also be valid when one of these options match) */
+    readonly extraOptions: string[]
+    
+    constructor(id:ODValidId, type:ODDiscordIdType, extraOptions:string[], options?:ODCheckerArrayStructureOptions, idOptions?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.propertyChecker = new ODCheckerCustomStructure_DiscordId(id,type,false,extraOptions,idOptions)
+        super(id,newOptions)
+        this.type = type
+        this.extraOptions = extraOptions
+    }
+}
+
+/**## ODCheckerCustomStructure_DiscordToken `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for a discord (auth) token**
+ */
+export class ODCheckerCustomStructure_DiscordToken extends ODCheckerStringStructure {
+    constructor(id:ODValidId, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+
+            if (typeof value != "string" || !/^[A-Za-z0-9-_\.]+$/.test(value)){
+                checker.createMessage("opendiscord:discord-invalid-token","error","This is an invalid discord token (syntactically)!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }
+            return true
+        }
+        super(id,newOptions)
+    }
+}
+
+/**## ODCheckerCustomStructure_DiscordToken `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for a hex color**
+ */
+export class ODCheckerCustomStructure_HexColor extends ODCheckerStringStructure {
+    /**When enabled, you are also allowed to use `#fff` instead of `#ffffff` */
+    readonly allowShortForm: boolean
+    /**Allow this hex color to be empty. */
+    readonly emptyAllowed: boolean
+
+    constructor(id:ODValidId, allowShortForm:boolean, emptyAllowed:boolean, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+
+            if (typeof value != "string") return false
+            else if (emptyAllowed && value.length == 0){
+                return true
+            }else if ((!allowShortForm && !/^#[a-fA-F0-9]{6}$/.test(value)) || (allowShortForm && !/^#[a-fA-F0-9]{6}$/.test(value) && !/^#[a-fA-F0-9]{3}$/.test(value))){
+                checker.createMessage("opendiscord:color-invalid","error","This is an invalid hex color!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else return true
+        }
+        super(id,newOptions)
+        this.allowShortForm = allowShortForm
+        this.emptyAllowed = emptyAllowed
+    }
+}
+
+/**## ODCheckerCustomStructure_EmojiString `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for an emoji (string)**
+ */
+export class ODCheckerCustomStructure_EmojiString extends ODCheckerStringStructure {
+    /**The minimum amount of emojis required (0 to allow empty) */
+    readonly minLength: number
+    /**The maximum amount of emojis allowed */
+    readonly maxLength: number
+    /**Allow custom discord emoji ids (`<:12345678910:emoji_name>`) */
+    readonly allowCustomDiscordEmoji: boolean
+
+    constructor(id:ODValidId, minLength:number, maxLength:number, allowCustomDiscordEmoji:boolean, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+            if (typeof value != "string") return false
+
+            const discordEmojiSplitter = /(?:<a?:[^:]*:[0-9]+>)/g
+            const splitted = value.split(discordEmojiSplitter)
+            const discordEmojiAmount = splitted.length-1
+            const unicodeEmojiAmount = [...new Intl.Segmenter().segment(splitted.join(""))].length
+            const emojiAmount = discordEmojiAmount+unicodeEmojiAmount
+
+            if (emojiAmount < minLength){
+                checker.createMessage("opendiscord:emoji-too-short","error",`This string needs to have at least ${minLength} emoji's!`,lt,null,[maxLength.toString()],this.id,(this.options.docs ?? null))
+                return false
+            }else if (emojiAmount > maxLength){
+                checker.createMessage("opendiscord:emoji-too-long","error",`This string needs to have at most ${maxLength} emoji's!`,lt,null,[maxLength.toString()],this.id,(this.options.docs ?? null))
+                return false
+            }else if (!allowCustomDiscordEmoji && /<a?:[^:]*:[0-9]+>/.test(value)){
+                checker.createMessage("opendiscord:emoji-custom","error",`This emoji can't be a custom discord emoji!`,lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (!/^(?:\p{Emoji}|\p{Emoji_Component}|(?:<a?:[^:]*:[0-9]+>))*$/u.test(value)){
+                checker.createMessage("opendiscord:emoji-invalid","error","This is an invalid emoji!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }
+            return true
+        }
+        super(id,newOptions)
+        this.minLength = minLength
+        this.maxLength = maxLength
+        this.allowCustomDiscordEmoji = allowCustomDiscordEmoji
+    }
+}
+
+/**## ODCheckerCustomStructureOptions_UrlString `interface`
+ * This interface has the options for `ODCheckerCustomStructure_UrlString`!
+ */
+export interface ODCheckerCustomStructureOptions_UrlString {
+    /**Allow urls with `http://` instead of `https://` */
+    allowHttp?:boolean
+    /**Allowed hostnames (string or regex) => will match domain + subdomain */
+    allowedHostnames?: (string|RegExp)[]
+    /**Allowed extentions (string) => will match the end of the url (`.png`,`.svg`,...) */
+    allowedExtensions?: string[]
+    /**Allowed paths (string or regex) => will match path + extension (not domain + subdomain) */
+    allowedPaths?: (string|RegExp)[],
+    /**A regex that will be executed on the entire url (including search params, protcol, domain, ...) */
+    regex?:RegExp
+}
+
+/**## ODCheckerCustomStructure_UrlString `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for a URL (string)**
+ */
+export class ODCheckerCustomStructure_UrlString extends ODCheckerStringStructure {
+    /**The settings for this url */
+    readonly urlSettings: ODCheckerCustomStructureOptions_UrlString
+    /**Is this url allowed to be empty? */
+    readonly emptyAllowed: boolean
+
+    constructor(id:ODValidId, emptyAllowed:boolean, urlSettings:ODCheckerCustomStructureOptions_UrlString, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+            
+            if (typeof value != "string") return false
+            else if (emptyAllowed && value.length == 0){
+                return true
+            }else if (!this.#urlIsValid(value)){
+                checker.createMessage("opendiscord:url-invalid","error","This url is invalid!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (typeof this.urlSettings.allowHttp != "undefined" && !this.urlSettings.allowHttp && !/^(https:\/\/)/.test(value)){
+                checker.createMessage("opendiscord:url-invalid-http","error","This url can only use the https:// protocol!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (!/^(http(s)?:\/\/)/.test(value)){
+                checker.createMessage("opendiscord:url-invalid-protocol","error","This url can only use the http:// & https:// protocols!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (typeof this.urlSettings.allowedHostnames != "undefined" && !this.#urlHasValidHostname(value,this.urlSettings.allowedHostnames)){
+                checker.createMessage("opendiscord:url-invalid-hostname","error","This url has a disallowed hostname!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (typeof this.urlSettings.allowedExtensions != "undefined" && !this.#urlHasValidExtension(value,this.urlSettings.allowedExtensions)){
+                checker.createMessage("opendiscord:url-invalid-extension","error",`This url has an invalid extension! Choose between: ${this.urlSettings.allowedExtensions.join(", ")}!"`,lt,null,[this.urlSettings.allowedExtensions.join(", ")],this.id,(this.options.docs ?? null))
+                return false
+            }else if (typeof this.urlSettings.allowedPaths != "undefined" && !this.#urlHasValidPath(value,this.urlSettings.allowedPaths)){
+                checker.createMessage("opendiscord:url-invalid-path","error","This url has an invalid path!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else if (typeof this.urlSettings.regex != "undefined" && !this.urlSettings.regex.test(value)){
+                checker.createMessage("opendiscord:url-invalid","error","This url is invalid!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else return true
+        }
+        super(id,newOptions)
+        this.urlSettings = urlSettings
+        this.emptyAllowed = emptyAllowed
+    }
+
+    /**Check for the hostname */
+    #urlHasValidHostname(url:string,hostnames:(string|RegExp)[]): boolean {
+        try {
+            const hostname = new URL(url).hostname
+            return hostnames.some((rule) => {
+                if (typeof rule == "string"){
+                    return rule == hostname
+                }else{
+                    return rule.test(hostname)
+                }
+            })
+            
+        }catch{
+            return false
+        }
+    }
+    /**Check for the extension */
+    #urlHasValidExtension(url:string,extensions:string[]): boolean {
+        try {
+            const path = new URL(url).pathname
+            return extensions.some((rule) => {
+                return path.endsWith(rule)
+            })
+        }catch{
+            return false
+        }
+    }
+    /**Check for the path */
+    #urlHasValidPath(url:string,paths:(string|RegExp)[]): boolean {
+        try {
+            const path = new URL(url).pathname
+            return paths.some((rule) => {
+                if (typeof rule == "string"){
+                    return rule == path
+                }else{
+                    return rule.test(path)
+                }
+            })
+        }catch{
+            return false
+        }
+    }
+    /**Do general syntax check on url */
+    #urlIsValid(url:string){
+        try {
+            new URL(url)
+            return true
+        }catch{
+            return false
+        }
+    }
+}
+
+/**## ODCheckerCustomStructure_UniqueId `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for a unique id (per source & scope)**
+ */
+export class ODCheckerCustomStructure_UniqueId extends ODCheckerStringStructure {
+    /**The source of this unique id (generally the plugin name or `opendiscord`) */
+    readonly source: string
+    /**The scope of this unique id (id needs to be unique in this scope) */
+    readonly scope: string
+
+    constructor(id:ODValidId, source:string, scope:string, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+
+            if (typeof value != "string") return false
+            const uniqueArray: string[] = (checker.storage.get(source,scope) === null) ? [] : checker.storage.get(source,scope)
+            if (uniqueArray.includes(value)){
+                //unique id already exists => throw error
+                checker.createMessage("opendiscord:id-not-unique","error","This id isn't unique, use another id instead!",lt,null,[],this.id,(this.options.docs ?? null))
+                return false
+            }else{
+                //unique id doesn't exists => add to list
+                uniqueArray.push(value)
+                checker.storage.set(source,scope,uniqueArray)
+                return true
+            }
+        }
+        super(id,newOptions)
+        this.source = source
+        this.scope = scope
+    }
+}
+
+/**## ODCheckerCustomStructure_UniqueIdArray `class`
+ * This is an Open Discord custom checker structure.
+ * 
+ * This class extends a primitive config checker & adds another layer of checking in the `custom` function.
+ * You can compare it to a blueprint for a specific checker.
+ * 
+ * **This custom checker is made for a unique id array (per source & scope)**
+ */
+export class ODCheckerCustomStructure_UniqueIdArray extends ODCheckerArrayStructure {
+    /**The source to read unique ids (generally the plugin name or `opendiscord`) */
+    readonly source: string
+    /**The scope to read unique ids (id needs to be unique in this scope) */
+    readonly scope: string
+    /**The scope to push unique ids when used in this array! */
+    readonly usedScope: string|null
+
+    constructor(id:ODValidId, source:string, scope:string, usedScope?:string, options?:ODCheckerArrayStructureOptions, idOptions?:Omit<ODCheckerStringStructureOptions,"minLength"|"custom">){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.propertyChecker = new ODCheckerStringStructure("opendiscord:unique-id",{...(idOptions ?? {}),minLength:1,custom:(checker,value,locationTrace,locationId,locationDocs) => {
+            if (typeof value != "string") return false
+            const localLt = checker.locationTraceDeref(locationTrace)
+            localLt.pop()
+
+            const uniqueArray: string[] = checker.storage.get(source,scope) ?? []
+            if (uniqueArray.includes(value)){
+                //exists
+                if (usedScope){
+                    const current: string[] = checker.storage.get(source,usedScope) ?? []
+                    current.push(value)
+                    checker.storage.set(source,usedScope,current)
+                }
+                return true
+            }else{
+                //doesn't exist
+                checker.createMessage("opendiscord:id-non-existent","error",`The id "${value}" doesn't exist!`,localLt,null,[`"${value}"`],locationId,locationDocs)
+                return false
+            }
+        }})
+        super(id,newOptions)
+        this.source = source
+        this.scope = scope
+        this.usedScope = usedScope ?? null
+    }
+}
+
+/*TEMPLATE!!!!
+export interface ODCheckerTemplateStructureOptions extends ODCheckerStructureOptions {
+    
+}
+export class ODCheckerTemplateStructure extends ODCheckerStructure {
+    declare options: ODCheckerTemplateStructureOptions
+
+    constructor(id:ODValidId, options:ODCheckerTemplateStructureOptions){
+        super(id,options)
+    }
+
+    check(checker:ODChecker, value:any, locationTrace:ODCheckerLocationTrace): boolean {
+        const lt = checker.locationTraceDeref(locationTrace)
+        
+        return super.check(checker,value,locationTrace)
+    }
+}
+*/
+/*CUSTOM TEMPLATE!!!!
+export class ODCheckerCustomStructure_Template extends ODCheckerTemplateStructure {
+    idk: string
+
+    constructor(id:ODValidId, idk:string, options?:ODCheckerStringStructureOptions){
+        //add premade custom structure checker
+        const newOptions = options ?? {}
+        newOptions.custom = (checker,value,locationTrace,locationId,locationDocs) => {
+            const lt = checker.locationTraceDeref(locationTrace)
+
+            //do custom check & push error message. Return true if correct
+            return boolean
+        }
+        super(id,newOptions)
+        this.idk = idk
+    }
+}
+*/