♻️ Refactor entire module flow and remove registries

bun.lock

···
   "workspaces": {
     "": {
       "name": "voidydiscord",
+    },
+    "packages/bot": {
+      "name": "voidy-bot",
+      "version": "0.1.0",
       "dependencies": {
-        "ascii-table3": "^1.0.1",
+        "discord.js": "^14.21.0",
+        "voidy-framework": "workspace:*",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+    "packages/framework": {
+      "name": "voidy-framework",
+      "version": "0.1.0",
+      "dependencies": {
         "discord.js": "^14.21.0",
       },
       "devDependencies": {
···
 
     "@sapphire/snowflake": ["@sapphire/snowflake@3.5.3", "", {}, "sha512-jjmJywLAFoWeBi1W7994zZyiNWPIiqRRNAmSERxyg93xRGzNYvGjlZ0gR6x0F4gPRi2+0O6S71kOZYyr3cxaIQ=="],
 
-    "@types/bun": ["@types/bun@1.2.19", "", { "dependencies": { "bun-types": "1.2.19" } }, "sha512-d9ZCmrH3CJ2uYKXQIUuZ/pUnTqIvLDS0SK7pFmbx8ma+ziH/FRMoAq5bYpRG7y+w1gl+HgyNZbtqgMq4W4e2Lg=="],
+    "@types/bun": ["@types/bun@1.2.22", "", { "dependencies": { "bun-types": "1.2.22" } }, "sha512-5A/KrKos2ZcN0c6ljRSOa1fYIyCKhZfIVYeuyb4snnvomnpFqC0tTsEkdqNxbAgExV384OETQ//WAjl3XbYqQA=="],
 
     "@types/node": ["@types/node@24.1.0", "", { "dependencies": { "undici-types": "~7.8.0" } }, "sha512-ut5FthK5moxFKH2T1CUOC6ctR67rQRvvHdFLCD2Ql6KXmMuCrjsSsRI9UsLCm9M18BMwClv4pn327UvB7eeO1w=="],
 
···
 
     "@vladfrangu/async_event_emitter": ["@vladfrangu/async_event_emitter@2.4.6", "", {}, "sha512-RaI5qZo6D2CVS6sTHFKg1v5Ohq/+Bo2LZ5gzUEwZ/WkHhwtGTCB/sVLw8ijOkAUxasZ+WshN/Rzj4ywsABJ5ZA=="],
 
-    "ascii-table3": ["ascii-table3@1.0.1", "", { "dependencies": { "printable-characters": "^1.0.42" } }, "sha512-xOCMZC8S375W4JajrAxFWPyI1VddfbscW9G5zMfhCySSt2Rvi/rs21jAjopzldTPOaFrOocjyGKibQiGExmLrg=="],
-
-    "bun-types": ["bun-types@1.2.19", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-uAOTaZSPuYsWIXRpj7o56Let0g/wjihKCkeRqUBhlLVM/Bt+Fj9xTo+LhC1OV1XDaGkz4hNC80et5xgy+9KTHQ=="],
+    "bun-types": ["bun-types@1.2.22", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-hwaAu8tct/Zn6Zft4U9BsZcXkYomzpHJX28ofvx7k0Zz2HNz54n1n+tDgxoWFGB4PcFvJXJQloPhaV2eP3Q6EA=="],
 
     "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
 
···
 
     "magic-bytes.js": ["magic-bytes.js@1.12.1", "", {}, "sha512-ThQLOhN86ZkJ7qemtVRGYM+gRgR8GEXNli9H/PMvpnZsE44Xfh3wx9kGJaldg314v85m+bFW6WBMaVHJc/c3zA=="],
 
-    "printable-characters": ["printable-characters@1.0.42", "", {}, "sha512-dKp+C4iXWK4vVYZmYSd0KBH5F/h1HoZRsbJ82AVKRO3PEo8L4lBS/vLwhVtpwwuYcoIsVY+1JYKR268yn480uQ=="],
-
     "ts-mixer": ["ts-mixer@6.0.4", "", {}, "sha512-ufKpbmrugz5Aou4wcr5Wc1UUFWOLhq+Fm6qa6P0w0K5Qw2yhaUoiWszhCVuNQyNwrlGiscHOmqYoAox1PtvgjA=="],
 
     "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
···
     "undici": ["undici@6.21.3", "", {}, "sha512-gBLkYIlEnSp8pFbT64yFgGE6UIB9tAkhukC23PmMDCe5Nd+cRqKxSjw5y54MK2AZMgZfJWMaNE4nYUHgi1XEOw=="],
 
     "undici-types": ["undici-types@7.8.0", "", {}, "sha512-9UJ2xGDvQ43tYyVMpuHlsgApydB8ZKfVYTsLDhXkFL/6gfkp+U8xTGdh8pMJv1SpZna0zxG1DwsKZsreLbXBxw=="],
+
+    "voidy-bot": ["voidy-bot@workspace:packages/bot"],
+
+    "voidy-framework": ["voidy-framework@workspace:packages/framework"],
 
     "ws": ["ws@8.18.3", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg=="],
 

package.json

···
 {
-	"name": "voidydiscord",
-	"version": "3.0.0-alpha1",
-	"module": "src/index.ts",
-	"type": "module",
-	"private": true,
-	"scripts": {
-		"dev": "bun --watch ."
-	},
-	"devDependencies": {
-		"@types/bun": "latest"
-	},
-	"peerDependencies": {
-		"typescript": "^5"
-	},
-	"dependencies": {
-		"ascii-table3": "^1.0.1",
-		"discord.js": "^14.21.0"
-	}
+	"name": "voidy",
+	"workspaces": [
+		"packages/*"
+	]
 }

packages/bot/package.json

···
+{
+	"name": "voidy-bot",
+	"version": "0.1.0",
+	"module": "src/index.ts",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"dev": "bun --watch ."
+	},
+	"devDependencies": {
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"voidy-framework": "workspace:*",
+		"discord.js": "^14.21.0"
+	}
+}

packages/bot/src/modules/core/module.ts

···
+import {
+	ButtonLoader,
+	CommandLoader,
+	EventLoader,
+	type Module
+} from "voidy-framework";
+
+export default {
+	id: "core",
+	name: "Core",
+	description: "The core feature set of the bot, required for command handling to work.",
+	author: "jokiller230",
+
+	exports: [
+		{
+			source: `${import.meta.dir}/events`,
+			loader: EventLoader,
+		},
+		{
+			source: `${import.meta.dir}/commands`,
+			loader: CommandLoader,
+		},
+		{
+			source: `${import.meta.dir}/buttons`,
+			loader: ButtonLoader,
+		}
+	]
+} as Module;

packages/bot/tsconfig.json

···
+{
+	"extends": "../../tsconfig.json",
+	"include": [
+		"src"
+	],
+	"compilerOptions": {
+		"baseUrl": ".",
+		"paths": {
+			"voidy-framework": [
+				"../framework/src"
+			]
+		}
+	}
+}

packages/framework/package.json

···
+{
+	"name": "voidy-framework",
+	"version": "0.1.0",
+	"module": "src/index.ts",
+	"type": "module",
+	"private": true,
+	"devDependencies": {
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"discord.js": "^14.21.0"
+	}
+}

packages/framework/src/core/ModuleManager.ts

···
+//===============================================
+//  Imports
+//===============================================
+import { ModuleLoader } from "../loaders/ModuleLoader";
+import type { Command } from "./types/Command";
+import type { Button } from "./types/Button";
+import type { Module } from "./types/Module";
+import type { Event } from "./types/Event";
+
+export type CacheMap<T = unknown> = Map<string, T>;
+
+//===============================================
+//  ModuleManager Implementation
+//===============================================
+export class ModuleManager {
+	private cache = new Map<string, Map<string, unknown>>();
+
+	//  Module Loading
+	//==============================
+	async loadModules(path: string) {
+		const moduleLoader = new ModuleLoader(path);
+		const modules = (await moduleLoader.collect()).getJSON();
+
+		for (const module of modules) {
+			await this.prepareModule(module);
+		}
+	}
+
+	async prepareModule(module: Module) {
+		for (const exp of module.exports) {
+			const loader = new exp.loader(exp.source);
+			const data = (await loader.collect()).getJSON();
+
+			for (const item of data) {
+				this.set(loader.id, (item as any).id, item);
+			}
+		}
+	}
+
+	//  Core API
+	//==============================
+	set<T>(type: string, id: string, value: T) {
+		if (!this.cache.has(type)) this.cache.set(type, new Map());
+		(this.cache.get(type) as CacheMap<T>).set(id, value);
+	}
+
+	get<T>(type: string, id: string): T | undefined {
+		return (this.cache.get(type) as CacheMap<T>)?.get(id);
+	}
+
+	getAll<T>(type: string): CacheMap<T> {
+		return (this.cache.get(type) as CacheMap<T>) ?? new Map();
+	}
+
+	//  Typed Accessors
+	//==============================
+	get modules(): CacheMap<Module> {
+		return this.getAll<Module>("module");
+	}
+
+	get commands(): CacheMap<Command> {
+		return this.getAll<Command>("command");
+	}
+
+	get buttons(): CacheMap<Button> {
+		return this.getAll<Button>("button");
+	}
+
+	get events(): CacheMap<Event> {
+		return this.getAll<Event>("event");
+	}
+}

packages/framework/src/core/VoidyClient.ts

···
+//===============================================
+//  Imports
+//===============================================
+import {
+	type ClientOptions,
+	SlashCommandSubcommandGroupBuilder,
+	SlashCommandSubcommandBuilder,
+	SlashCommandBuilder,
+	Client,
+} from "discord.js";
+import { ModuleManager, type CacheMap } from "./ModuleManager";
+import type { Command } from "./types/Command";
+import type { Button } from "./types/Button";
+import type { Event } from "./types/Event";
+
+//===============================================
+//  VoidyClient Implementation
+//===============================================
+export class VoidyClient extends Client {
+	public moduleManager = new ModuleManager();
+
+	public constructor(options: ClientOptions) {
+		super(options);
+	}
+
+	/**
+		* Launches the bot
+		* @param token - The Discord application bot token.
+		* @param modulesPath - Where the bot should search for modules.
+	*/
+	public async start(token: string, modulesPath: string) {
+		// Load modules and register events
+		await this.moduleManager.loadModules(modulesPath);
+		await this.registerEvents();
+
+		// Register commands on ready event
+		this.on("ready", this.registerCommands);
+
+		// Login using the bot token
+		await this.login(token);
+	}
+
+	/**
+		* Registers all cached events
+		* @param events
+	*/
+	private async registerEvents() {
+		const events = this.moduleManager.events;
+
+		for (const [_id, event] of events) {
+			const execute = (...args: unknown[]) => event.execute(this, ...args);
+
+			if (event.once) this.once(event.name, execute);
+			else this.on(event.name, execute);
+		}
+	}
+
+	/**
+		* Registers all provided commands globally
+		* @param commands
+	*/
+	private async registerCommands(): Promise<void> {
+		const topLevelCommands = new Map<string, SlashCommandBuilder>();
+
+		for (const cmd of this.moduleManager.commands.values()) {
+			const parts = cmd.id.split("."); // ["music", "set", "channel"]
+			const command = parts[0];
+			const subcommand = parts[1];
+			const subgroupcommand = parts[2];
+
+			if (!command) continue;
+
+			// Ensure top-level builder exists
+			if (!topLevelCommands.has(command)) {
+				const topCommand = (
+					this.moduleManager.commands.get(command)?.data as SlashCommandBuilder
+				) ?? new SlashCommandBuilder().setName(command).setDescription("...");
+
+				topLevelCommands.set(command, topCommand);
+			}
+
+			const parent = topLevelCommands.get(command)!;
+
+			if (subcommand && !subgroupcommand) {
+				// It's a subcommand
+				parent.addSubcommand(cmd.data as SlashCommandSubcommandBuilder);
+			} else if (subcommand && subgroupcommand) {
+				// It's a subgroup command
+				let group = parent.options.find(
+					(o): o is SlashCommandSubcommandGroupBuilder => o instanceof SlashCommandSubcommandGroupBuilder && o.name === subcommand
+				);
+
+				if (!group) {
+					group = new SlashCommandSubcommandGroupBuilder().setName(subcommand).setDescription("...");
+					parent.addSubcommandGroup(group);
+				}
+
+				group.addSubcommand(cmd.data as SlashCommandSubcommandBuilder);
+			}
+		}
+
+		// Finally convert assembled top-level commands to JSON and register them
+		await this.application?.commands.set([...topLevelCommands.values()].map(c => c.toJSON()));
+	}
+
+	/**
+	 * Returns all cached commands
+	 */
+	get commands(): CacheMap<Command> {
+		return this.moduleManager.commands;
+	}
+
+	/**
+	 * Returns all cached events
+	 */
+	get events(): CacheMap<Event> {
+		return this.moduleManager.events;
+	}
+
+	/**
+	 * Returns all cached buttons
+	 */
+	get buttons(): CacheMap<Button> {
+		return this.moduleManager.buttons;
+	}
+}

packages/framework/src/core/types/Button.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { ButtonInteraction } from "discord.js";
+import type { VoidyClient } from "../VoidyClient";
+import type { Resource } from "./Resource";
+
+//===============================================
+//  Button Definition
+//===============================================
+export interface Button extends Resource {
+	execute: (
+		interaction: ButtonInteraction, client: VoidyClient
+	) => Promise<void>
+}

packages/framework/src/core/types/Command.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type {
+	SlashCommandSubcommandGroupBuilder,
+	SlashCommandSubcommandBuilder,
+	ChatInputCommandInteraction,
+	SlashCommandBuilder,
+} from "discord.js";
+import type { VoidyClient } from "../VoidyClient";
+import type { Resource } from "./Resource";
+
+//===============================================
+//  Command Definition
+//===============================================
+export interface Command extends Resource {
+	data: SlashCommandBuilder | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder,
+	execute: (
+		interaction: ChatInputCommandInteraction, client: VoidyClient
+	) => Promise<void>
+}

packages/framework/src/core/types/Event.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { VoidyClient } from "../VoidyClient";
+import type { ClientEvents } from "discord.js";
+import type { Resource } from "./Resource";
+
+//===============================================
+//  Event Definition
+//===============================================
+export interface Event extends Resource {
+	name: keyof ClientEvents,
+	once?: boolean,
+	execute: (client: VoidyClient, ...args: unknown[]) => void,
+}

packages/framework/src/core/types/Module.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { Resource } from "./Resource";
+import type { Loader } from "../Loader";
+
+//===============================================
+//  ModuleExportsItem Definition
+//===============================================
+export interface ModuleExportsItem<T extends object> {
+	source: string
+	loader: new (...args: ConstructorParameters<typeof Loader<T>>) => Loader<T>
+}
+
+//===============================================
+//  Module Definition
+//===============================================
+export interface Module extends Resource {
+	name: string
+	description: string
+	author: string
+	exports: ModuleExportsItem<object>[]
+}

packages/framework/src/core/types/Resource.ts

···
+//===============================================
+//  Resource Definition
+//===============================================
+export interface Resource {
+	id: string
+}

packages/framework/src/index.ts

···
+// Core
+export * from "./core/Loader";
+export * from "./core/ModuleManager";
+export * from "./core/VoidyClient";
+
+// Types
+export * from "./core/types/Button";
+export * from "./core/types/Command";
+export * from "./core/types/Event";
+export * from "./core/types/Module";
+export * from "./core/types/Resource";
+
+// Handlers
+export * from "./handlers/ButtonHandler";
+export * from "./handlers/CommandHandler";
+
+// Loaders
+export * from "./loaders/ButtonLoader";
+export * from "./loaders/CommandLoader";
+export * from "./loaders/EventLoader";
+export * from "./loaders/ModuleLoader";

packages/framework/src/loaders/ButtonLoader.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { Button } from "../core/types/Button";
+import { Loader } from "../core/Loader";
+
+//===============================================
+//  ButtonLoader Implementation
+//===============================================
+export class ButtonLoader extends Loader<Button> {
+	public id = "button";
+	public async validate(data: Partial<Button>) {
+		if (!data.id || !data.execute) return null;
+		return data as Button;
+	}
+}

packages/framework/src/loaders/CommandLoader.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { Command } from "../core/types/Command";
+import { Loader } from "../core/Loader";
+
+//===============================================
+//  CommandLoader Implementation
+//===============================================
+export class CommandLoader extends Loader<Command> {
+	public id = "command";
+	public async validate(data: Partial<Command>) {
+		if (!data.id || !data.data || !data.execute) return null;
+		return data as Command;
+	}
+}

packages/framework/src/loaders/EventLoader.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { Event } from "../core/types/Event";
+import { Loader } from "../core/Loader";
+
+//===============================================
+//  EventLoader Implemenation
+//===============================================
+export class EventLoader extends Loader<Event> {
+	public id = "event";
+	public async validate(data: Partial<Event>) {
+		if (!data.id || !data.name || !data.execute) return null;
+		return data as Event;
+	}
+}

packages/framework/src/loaders/ModuleLoader.ts

···
+//===============================================
+//  Imports
+//===============================================
+import type { Module } from "../core/types/Module";
+import { Loader } from "../core/Loader"
+
+//===============================================
+//  ModuleLoader Implementation
+//===============================================
+export class ModuleLoader extends Loader<Module> {
+	public id = "module";
+	public async validate(data: Partial<Module>) {
+		if (
+			!data.id ||
+			!data.name ||
+			!data.description ||
+			!data.author ||
+			!data.exports
+		) return null;
+
+		return data as Module;
+	}
+}

packages/framework/tsconfig.json

···
+{
+	"extends": "../../tsconfig.json",
+	"compilerOptions": {
+		"declaration": true,
+		"declarationDir": "dist/types",
+		"outDir": "dist",
+		"strict": true,
+		"esModuleInterop": true,
+		"composite": true
+	},
+	"include": [
+		"src"
+	]
+}

src/core/Lifecycle.ts

···
-export enum LifecycleEvents {
-	// Registries
-	RegistryPreCollect = "registry::preCollect",
-	RegistryPostCollect = "registry::postCollect",
-
-	// Client
-	ClientLoop = "client::loop",
-}
-
-type LifecycleEventCallback = () => void;
-
-export class Lifecycle {
-	public static subscribers = new Map<string, Array<LifecycleEventCallback>>();
-
-	public static subscribe(event: LifecycleEvents, callback: LifecycleEventCallback): void {
-		const subscribers = this.subscribers.get(event);
-		if (!subscribers) {
-			this.subscribers.set(event, [callback]);
-			return;
-		}
-
-		this.subscribers.set(event, subscribers.concat([callback]));
-	}
-
-	public static notify(event: LifecycleEvents) {
-		const subscribers = this.subscribers.get(event);
-		if (!subscribers) return;
-
-		for (const subscriber of subscribers) {
-			subscriber();
-		}
-	}
-}

src/core/Loader.ts packages/framework/src/core/Loader.ts

···
+//===============================================
+//  Imports
+//===============================================
 import { Glob } from "bun";
 
-interface ILoader<T> {
+//===============================================
+//  Loader Definition
+//===============================================
+interface ILoader<T extends object> {
 	id: string
 	cache: T[]
 	source: string
···
 	getJSON: () => T[]
 }
 
-export class Loader<T extends object> implements ILoader<T> {
-	public id = "loader";
+//===============================================
+//  Loader Implementation
+//===============================================
+export abstract class Loader<T extends object> implements ILoader<T> {
+	public abstract id: string;
 	public cache: T[] = [];
-	public source;
+	public source: string;
 
 	public constructor(source: string) {
 		if (!source) throw new Error("Class of type Loader was initialized without the *required* source parameter.");
···
 	/**
 		* Validates a singular element during data collection, and returns whatever should be written to the cache.
 	*/
-	public async validate(data: Partial<T>): Promise<T | null> {
-		return null;
-	}
+	public abstract validate(data: Partial<T>): Promise<T | null>;
 
 	/**
 		* Returns the JSON-ified contents of the loader cache

src/core/Registry.ts

···
-import { ButtonLoader, type Button } from "../loaders/ButtonLoader"
-import { CommandLoader, type Command } from "../loaders/CommandLoader"
-import { EventLoader, type Event } from "../loaders/EventLoader"
-import { ModuleLoader, type Module } from "../loaders/ModuleLoader"
-
-export enum RegistryCacheKey {
-	Events = "events",
-	Modules = "modules",
-	Buttons = "buttons",
-	Commands = "commands",
-}
-
-export type RegistryCache = {
-	events: Event[],
-	modules: Module[],
-	buttons: Button[],
-	commands: Command[],
-	[x: string]: object[],
-};
-
-export interface IRegistry {
-	id: string
-	active: boolean
-	dataSource: string
-
-	cache: RegistryCache;
-
-	collectModules: () => Promise<void>
-	processModules: () => Promise<void>
-
-	activate: () => Promise<void>
-	deactivate: () => Promise<void>
-}
-
-export class Registry implements IRegistry {
-	public id: string;
-	public active = false;
-	public dataSource: string;
-
-	// Initialize cache stores
-	public cache: RegistryCache = {
-		events: [],
-		modules: [],
-		buttons: [],
-		commands: [],
-	}
-
-	public constructor(id: string, dataSource: string) {
-		this.id = id;
-		this.dataSource = dataSource;
-	}
-
-	/** Collect modules from specified dataSource directory */
-	public async collectModules() {
-		// Collect modules and bundle their JSON contents into an array.
-		const moduleLoader = new ModuleLoader(this.dataSource);
-		const modules = (await moduleLoader.collect()).getJSON();
-
-		// Merge all modules into the store.
-		this.cache.modules = modules;
-	}
-
-	/** Process exports of all collected modules */
-	public async processModules() {
-		for (const module of this.cache.modules) {
-			for (const item of module.exports) {
-				const loader = new item.loader(item.source);
-				await loader.collect();
-
-				// Mape loader output to correct cache key
-				this.cache[`${loader.id}s`] = [...loader.getJSON()];
-			}
-		}
-	}
-
-	public async activate() {
-		this.active = true;
-	}
-
-	public async deactivate() {
-		this.active = false;
-	}
-}

src/core/RegistryManager.ts

···
-import { Registry, type RegistryCache } from "./Registry"
-
-interface IRegistryManager {
-	addRegistry: (newRegistry: Registry) => boolean
-	getRegistry: (registryID: string) => Registry | null
-
-	prepareRegistries: () => void
-	getCache: () => RegistryCache
-}
-
-export class RegistryManager implements IRegistryManager {
-	private registries = new Map<string, Registry>();
-
-	public addRegistry(newRegistry: Registry) {
-		// Append registry to registries array if ID is unique,
-		// else return false.
-		if (this.registries.get(newRegistry.id)) return false;
-		this.registries.set(newRegistry.id, newRegistry);
-
-		// The registry was added successfully, therefore return true.
-		return true;
-	}
-
-	public getRegistry(registryID: string) {
-		const registry = this.registries.get(registryID);
-
-		if (!registry) return null;
-		return registry;
-	}
-
-	public async prepareRegistries() {
-		for (const registry of this.registries.values()) {
-			// 1. Collecting required registry data
-			console.info(`[Voidy] Collecting registry data: ${registry.dataSource}`);
-			await registry.collectModules();
-
-			// 2. Processing collected registry modules and their exports
-			console.info(`[Voidy] Processing registry data: ${registry.dataSource}`);
-			await registry.processModules();
-
-			// 3. Activating registry
-			console.info(`[Voidy] Activating registry: ${registry.dataSource}`);
-			await registry.activate();
-		}
-	}
-
-	public getCache() {
-		let cache: RegistryCache = {
-			events: [],
-			modules: [],
-			commands: [],
-			buttons: [],
-		};
-
-		// Combine all registry caches
-		for (const registry of this.registries.values()) {
-			if (registry.active) cache = { ...cache, ...registry.cache };
-		}
-
-		return cache;
-	}
-}

src/core/VoidyClient.ts

···
-import {
-	type RESTPostAPIChatInputApplicationCommandsJSONBody,
-	type APIApplicationCommandSubcommandGroupOption,
-	type APIApplicationCommandSubcommandOption,
-	type ApplicationCommandDataResolvable,
-	type ClientOptions,
-	Client,
-} from "discord.js";
-import { Registry } from "./Registry";
-import { RegistryManager } from "./RegistryManager";
-import type { Event } from "../loaders/EventLoader";
-import { Lifecycle, LifecycleEvents } from "./Lifecycle";
-
-export class VoidyClient extends Client {
-	public registryManager = new RegistryManager();
-	private intervalID?: NodeJS.Timeout | NodeJS.Timer;
-
-	public constructor(options: ClientOptions) {
-		super(options);
-
-		// Add the core registry to our registry manager
-		this.registryManager.addRegistry(
-			new Registry('core', `${process.cwd()}/src/modules`)
-		);
-	}
-
-	/**
-		* Register all provided events
-		* @param events
-	*/
-	private async registerEventHandlers(events: Event[]) {
-		console.log(`[Voidy] Registering ${events.length} event listeners: ${events.map(event => event.name).join(", ")}`);
-
-		for (const event of events) {
-			const execute = (...args: unknown[]) => event.execute(this, ...args);
-
-			if (event.once) this.once(event.name, execute);
-			else this.on(event.name, execute);
-		}
-	}
-
-	/**
-		* Register all provided commands to the global discord context
-		* @param commands
-		* @todo Fix this type mess, if possible
-	*/
-	private async registerCommands(commands: (RESTPostAPIChatInputApplicationCommandsJSONBody | APIApplicationCommandSubcommandOption | APIApplicationCommandSubcommandGroupOption)[]): Promise<void> {
-		console.info(`[Voidy] Registering ${commands.length} commands: ${commands.map(command => command.name).join(", ")}`);
-
-		await this.application?.commands.set(commands as ApplicationCommandDataResolvable[]);
-	}
-
-	/**
-		* Refresh the registry manager and re-register relevant data
-		* @param token
-	*/
-	private async refresh() {
-		// 1. Prepare and fetch registry manager cache
-		await this.registryManager.prepareRegistries();
-		const cache = this.registryManager.getCache();
-
-		let cacheSize = 0;
-		for (const cacheValue of Object.values(cache)) {
-			cacheSize += cacheValue.length;
-		}
-
-		// 2. Showcase number of loaded cache entities
-		console.log(`[Voidy] Refreshed RegistryManager cache, with a total of ${cacheSize} items.`);
-
-		// 3. Clear and re-register events
-		const events = cache.events;
-		this.removeAllListeners();
-		this.registerEventHandlers(events);
-
-		// 4. Register all active commands
-		const commands = cache.commands.flatMap(command => command.data.toJSON());
-		this.registerCommands(commands);
-	}
-
-	/**
-		* Runs reccurring tasks, doesn't loop by itself, though
-	*/
-	private async loop() {
-		// Notifies the "client_loop" lifecycle event
-		Lifecycle.notify(LifecycleEvents.ClientLoop);
-	}
-
-	/**
-		* Starts the client loop, with a customizable interval
-		* @param interval
-	*/
-	public startLoop(interval: number = 60 * 1000) {
-		this.intervalID = setInterval(this.loop.bind(this), interval);
-	}
-
-	/**
-		* Stops the client loop
-	*/
-	public stopLoop() {
-		if (!this.intervalID) return;
-		clearInterval(this.intervalID);
-	}
-
-	/**
-		* Launch the bot, additionally starts the client loop
-		* @param token
-	*/
-	public async start(token: string) {
-		await this.refresh();
-		await this.login(token);
-
-		this.startLoop();
-	}
-}

src/index.ts packages/bot/src/index.ts

···
 import { GatewayIntentBits } from "discord.js"
-import { VoidyClient } from "./core/VoidyClient"
+import { VoidyClient } from "voidy-framework";
 
 // Client initialization with intents and stuff...
 const client = new VoidyClient({
···
 
 // Token validation and client start
 if (!Bun.env.BOT_TOKEN) throw new Error("[Voidy] Missing bot token");
-await client.start(Bun.env.BOT_TOKEN);
+await client.start(Bun.env.BOT_TOKEN, `${import.meta.dirname}/modules`);

src/loaders/ButtonLoader.ts

···
-import type { ButtonInteraction } from "discord.js";
-import { Loader } from "../core/Loader";
-import type { VoidyClient } from "../core/VoidyClient";
-
-export interface Button {
-	id: string,
-	execute: (
-		interaction: ButtonInteraction, client: VoidyClient
-	) => Promise<void>
-}
-
-export class ButtonLoader extends Loader<Button> {
-	public override id = "button";
-	public override async validate(data: Partial<Button>) {
-		if (!data.id || !data.execute) return null;
-		return data as Button;
-	}
-}

src/loaders/CommandLoader.ts

···
-import type {
-	ChatInputCommandInteraction,
-	SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder
-} from "discord.js";
-import { Loader } from "../core/Loader";
-import type { VoidyClient } from "../core/VoidyClient";
-
-export interface Command {
-	data: SlashCommandBuilder | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder,
-	execute: (
-		interaction: ChatInputCommandInteraction, client: VoidyClient
-	) => Promise<void>
-}
-
-export class CommandLoader extends Loader<Command> {
-	public override id = "command";
-	public override async validate(data: Partial<Command>) {
-		if (!data.data || !data.execute) return null;
-		return data as Command;
-	}
-}

src/loaders/EventLoader.ts

···
-import { type ClientEvents } from "discord.js";
-import { Loader } from "../core/Loader";
-import type { VoidyClient } from "../core/VoidyClient";
-
-export interface Event {
-	name: keyof ClientEvents,
-	once?: boolean,
-	execute: (client: VoidyClient, ...args: unknown[]) => void,
-}
-
-export class EventLoader extends Loader<Event> {
-	public override id = "event";
-	public override async validate(data: Partial<Event>) {
-		if (!data.name || !data.execute) return null;
-		return data as Event;
-	}
-}

src/loaders/ModuleLoader.ts

···
-import { Loader } from "../core/Loader"
-
-export interface ModuleExportsItem<T extends object> {
-	source: string
-	loader: typeof Loader<T>
-}
-
-export interface Module {
-	name: string
-	description: string
-	author: string
-	exports: ModuleExportsItem<object>[]
-}
-
-export class ModuleLoader extends Loader<Module> {
-	public override id = "module";
-	public override async validate(data: Partial<Module>) {
-		if (
-			!data.name ||
-			!data.description ||
-			!data.author ||
-			!data.exports
-		) return null;
-
-		return data as Module;
-	}
-}

src/modules/core/commands/ping.ts packages/bot/src/modules/core/commands/ping.ts

···
 import { MessageFlags, SlashCommandBuilder } from "discord.js";
-import type { Command } from "../../../loaders/CommandLoader";
+import type { Command } from "voidy-framework";
 
 export default {
+	id: "ping",
 	data: new SlashCommandBuilder()
 		.setName("ping")
 		.setDescription("View the websocket ping between Discord and the Bot."),

src/modules/core/events/interactionCreate.ts packages/bot/src/modules/core/events/interactionCreate.ts

···
-import type { Event } from "../../../loaders/EventLoader";
-import type { VoidyClient } from "../../../core/VoidyClient";
-import { ButtonHandler } from "../../../handlers/ButtonHandler";
 import { Events, MessageFlags, type Interaction } from "discord.js";
-import { ChatInputCommandHandler } from "../../../handlers/CommandHandler";
+import {
+	ChatInputCommandHandler,
+	ButtonHandler,
+	type VoidyClient,
+	type Event
+} from "voidy-framework";
 
 export default {
+	id: "interactionCreate",
 	name: Events.InteractionCreate,
 	execute: async (client: VoidyClient, interaction: Interaction) => {
 		if (interaction.isChatInputCommand() && interaction.isCommand()) {
-			// Filter the client command cache to locate the invoked command
-			const payload = client.registryManager.getCache().commands.filter(commands => commands.data.name === interaction.commandName)[0];
+			// Set the top-level command name
+			let commandId = interaction.commandName;
+
+			// Try to get a subgroup first
+			const subgroup = interaction.options.getSubcommandGroup(false);
+			if (subgroup) commandId += `.${subgroup}`;
+
+			// Then subcommand (or subcommand in a group)
+			const subcommand = interaction.options.getSubcommand(false);
+			if (subcommand) commandId += `.${subcommand}`;
+
+			const command = client.commands.get(commandId);
 
-			if (!payload) return interaction.reply({
+			if (!command) return interaction.reply({
 				content: `Sorry, but the command ${interaction.commandName} could not be located in my command cache >:3`,
 				flags: [MessageFlags.Ephemeral]
 			});
 
-			ChatInputCommandHandler.invoke(interaction, payload, client);
+			ChatInputCommandHandler.invoke(interaction, command, client);
 		} else if (interaction.isButton()) {
 			// Filter the client button cache to locate the invoked button
-			const payload = client.registryManager.getCache().buttons.filter(buttons => buttons.id === interaction.customId)[0];
+			const button = client.buttons.get(interaction.customId);
 
-			if (!payload) return interaction.reply({
+			if (!button) return interaction.reply({
 				content: `Sorry, but the button ${interaction.customId} could not be located in my button cache >:3`,
 				flags: [MessageFlags.Ephemeral]
 			});
 
-			ButtonHandler.invoke(interaction, payload, client);
+			ButtonHandler.invoke(interaction, button, client);
 		} else {
 			let dmChannel = interaction.user.dmChannel;
 

src/modules/core/events/ready.ts packages/bot/src/modules/core/events/ready.ts

···
+import type { Event, VoidyClient } from "voidy-framework";
 import { ActivityType, Events } from "discord.js";
-import type { Event } from "../../../loaders/EventLoader";
-import type { VoidyClient } from "../../../core/VoidyClient";
 
 export default {
+	id: "ready",
 	name: Events.ClientReady,
 	once: true,
 	execute: async (client: VoidyClient) => {

src/modules/core/module.ts

···
-import { Lifecycle, LifecycleEvents } from "../../core/Lifecycle";
-import { ButtonLoader } from "../../loaders/ButtonLoader";
-import { CommandLoader } from "../../loaders/CommandLoader";
-import { EventLoader } from "../../loaders/EventLoader";
-import type { Module } from "../../loaders/ModuleLoader";
-
-Lifecycle.subscribe(LifecycleEvents.ClientLoop, () => {
-	console.log("Wait what, wait what...");
-})
-
-export default {
-	name: "core",
-	description: "The core feature set of the bot, required for command handling to work.",
-	author: "jokiller230",
-
-	exports: [
-		{
-			source: `${import.meta.dir}/events`,
-			loader: EventLoader,
-		},
-		{
-			source: `${import.meta.dir}/commands`,
-			loader: CommandLoader,
-		},
-		{
-			source: `${import.meta.dir}/buttons`,
-			loader: ButtonLoader,
-		}
-	]
-} as Module;

tsconfig.json

···
 {
 	"compilerOptions": {
-		// Environment setup & latest features
 		"lib": [
 			"ESNext"
 		],
 		"target": "ESNext",
 		"module": "Preserve",
 		"moduleDetection": "force",
-		"jsx": "react-jsx",
 		"allowJs": true,
-		// Bundler mode
 		"moduleResolution": "bundler",
 		"allowImportingTsExtensions": true,
 		"verbatimModuleSyntax": true,
 		"noEmit": true,
-		// Best practices
 		"strict": true,
 		"skipLibCheck": true,
 		"noFallthroughCasesInSwitch": true,
 		"noUncheckedIndexedAccess": true,
 		"noImplicitOverride": true,
-		// Some stricter flags (disabled by default)
 		"noUnusedLocals": false,
 		"noUnusedParameters": false,
 		"noPropertyAccessFromIndexSignature": false